[libical-glib] Add new APIs in icalcomponent.h

[Miao Yu <williamyu src gnome org>]

commit 6a28137fdaf450dc5747721c9b49b1b254883060
Author: William Yu <williamyu gnome org>
Date:   Sun Mar 13 17:28:50 2016 -0700

    Add new APIs in icalcomponent.h

 TODO                        |   47 +++++++++++++++++++++++++++++++++++++++++++
 configure.ac                |    2 +-
 src/api/i-cal-component.xml |   25 ++++++++++++++++++++++
 3 files changed, 73 insertions(+), 1 deletions(-)
---
diff --git a/TODO b/TODO
index f1a3cb9..b49f753 100644
--- a/TODO
+++ b/TODO
@@ -77,3 +77,50 @@ Notes:
 -ignore because of not a part of public API
        const char *icaltzutil_get_zone_directory (void);
        icalcomponent *icaltzutil_fetch_timezone (const char *location);
+       
+========2.0.0 upgrade========
+
+TODOs: 
+i-cal-array.xml 
+i-cal-attach.xml 
+i-cal-comp-iter.xml 
+i-cal-datetimeperiod-type.xml 
+i-cal-derived-parameter.xml 
+i-cal-derived-property.xml 
+i-cal-derived-value.xml 
+i-cal-duration-type.xml 
+i-cal-enums.xml 
+i-cal-error.xml 
+i-cal-geo-type.xml 
+i-cal-langbind.xml 
+i-cal-memory.xml 
+i-cal-mime.xml 
+i-cal-parameter.xml 
+i-cal-parser.xml 
+i-cal-period-type.xml 
+i-cal-property.xml 
+i-cal-recur-iterator.xml 
+i-cal-recur.xml 
+i-cal-recurrence-type.xml 
+i-cal-reqstat-type.xml 
+i-cal-restriction.xml 
+i-cal-time-span.xml 
+i-cal-time.xml 
+i-cal-timetype.xml 
+i-cal-timezone-phase.xml 
+i-cal-timezone.xml 
+i-cal-timezonetype.xml 
+i-cal-trigger-type.xml 
+i-cal-unknowntokenhandling.xml 
+i-cal-value.xml
+
+Done:
+i-cal-component.xml
+
+Upgrade results:
+icalcomponent.h
+       icalcomponent_vanew
+       icalcomponent_get_parent (internal)
+       icalcomponent_set_parent (internal)
+       icalcomponent_foreach_recurrence (TODO)
+       
diff --git a/configure.ac b/configure.ac
index 970e53e..888b741 100644
--- a/configure.ac
+++ b/configure.ac
@@ -16,7 +16,7 @@ AC_CONFIG_HEADERS(config.h)
 dnl *******************
 dnl Required Packages
 dnl *******************
-m4_define([libical_minimum_version], [1.0])
+m4_define([libical_minimum_version], [2.0.0])
 m4_define([libxml_minimum_version], [2.7.3])
 
 dnl Keep these two definitions in agreement.
diff --git a/src/api/i-cal-component.xml b/src/api/i-cal-component.xml
index 2aee1c7..7f66052 100644
--- a/src/api/i-cal-component.xml
+++ b/src/api/i-cal-component.xml
@@ -74,6 +74,11 @@
         <returns type="gint" comment="The number of #ICalProperty."/>
         <comment xml:space="preserve">Count the #ICalProperty in #ICalComponent.</comment>
     </method>
+    <method name="i_cal_property_get_parent" corresponds="icalproperty_get_parent" since="2.0">
+       <parameter type="ICalProperty *" name="property" comment="The #ICalProperty."/>
+       <returns type="ICalComponent *" annotation="transfer full" translator_argus="(GObject *)property" 
comment="The parent #ICalComponent of #ICalProperty."/>
+       <comment xml:space="preserve">Get the parent component of the property. Use with caution. When 
icalproperty is deallocated, it won't deallocate its parent. However the #ICalComponent object created using 
this method will be deallocated (if no reference in other places). So You need to make sure there is another 
reference except the one in #ICalProperty.</comment>
+    </method>
     <method name="i_cal_component_get_current_property" corresponds="icalcomponent_get_current_property" 
since="1.0">
         <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/>
         <returns type="ICalProperty *" annotation="transfer full" translator_argus="(GObject *)component" 
comment="The current #ICalProperty."/>
@@ -450,4 +455,24 @@
         <returns type="ICalComponent *" annotation="transfer full" comment="The newly created 
#ICalComponent."/>
         <comment xml:space="preserve">Create a #ICalComponent with the type to be vquery</comment>
     </method>
+    <method name="i_cal_component_new_vavailability" corresponds="icalcomponent_new_vavailability" 
kind="constructor" since="1.0">
+        <returns type="ICalComponent *" annotation="transfer full" comment="The newly created 
#ICalComponent."/>
+        <comment xml:space="preserve">Create a #ICalComponent with the type to be vavailability</comment>
+    </method>
+    <method name="i_cal_component_new_xavailable" corresponds="icalcomponent_new_xavailable" 
kind="constructor" since="1.0">
+        <returns type="ICalComponent *" annotation="transfer full" comment="The newly created 
#ICalComponent."/>
+        <comment xml:space="preserve">Create a #ICalComponent with the type to be xavailable</comment>
+    </method>
+    <method name="i_cal_component_new_vpoll" corresponds="icalcomponent_new_vpoll" kind="constructor" 
since="1.0">
+        <returns type="ICalComponent *" annotation="transfer full" comment="The newly created 
#ICalComponent."/>
+        <comment xml:space="preserve">Create a #ICalComponent with the type to be vpoll</comment>
+    </method>
+    <method name="i_cal_component_new_vvoter" corresponds="icalcomponent_new_vvoter" kind="constructor" 
since="1.0">
+        <returns type="ICalComponent *" annotation="transfer full" comment="The newly created 
#ICalComponent."/>
+        <comment xml:space="preserve">Create a #ICalComponent with the type to be vvoter</comment>
+    </method>
+    <method name="i_cal_component_new_xvote" corresponds="icalcomponent_new_xvote" kind="constructor" 
since="1.0">
+        <returns type="ICalComponent *" annotation="transfer full" comment="The newly created 
#ICalComponent."/>
+        <comment xml:space="preserve">Create a #ICalComponent with the type to be xvote</comment>
+    </method>
 </structure>