diff options
author | Michael McClurg <michael.mcclurg@outlook.com> | 2020-06-30 10:54:07 -0600 |
---|---|---|
committer | Michael McClurg <michael.mcclurg@outlook.com> | 2020-06-30 10:54:07 -0600 |
commit | b6f9bf76330fb0b80d0f9c9d66c2b824006a8ad8 (patch) | |
tree | 7849b3d744ed969b6a3625158d7614533c568780 | |
parent | 70fbeb05e220dd8d93f6cc38fcf4d0273f73c293 (diff) | |
download | libical-git-b6f9bf76330fb0b80d0f9c9d66c2b824006a8ad8.tar.gz |
Standardize verb forms
66 files changed, 900 insertions, 901 deletions
diff --git a/examples/access_properties_and_parameters.c b/examples/access_properties_and_parameters.c index d17d91c0..9988dba0 100644 --- a/examples/access_properties_and_parameters.c +++ b/examples/access_properties_and_parameters.c @@ -3,7 +3,7 @@ #include <libical/ical.h> #include <stdlib.h> -/* Get a particular parameter out of a component. This routine will +/* Gets a particular parameter out of a component. This routine will return a list of strings of all attendees who are required. Note that this routine assumes that the component that we pass in is a VEVENT. */ @@ -143,7 +143,7 @@ void test_properties() printf("Value: %s", str); free(str); - /* Free the original and the clone */ + /* Frees the original and the clone */ icalproperty_free(clone); icalproperty_free(prop); diff --git a/src/Net-ICal-Libical/netical.i b/src/Net-ICal-Libical/netical.i index ef0c80fb..e0dad14b 100644 --- a/src/Net-ICal-Libical/netical.i +++ b/src/Net-ICal-Libical/netical.i @@ -161,7 +161,7 @@ icalcomponent* icallangbind_get_next_component(icalcomponent *c, const char* comp); -/* Return a string that can be evaluated in perl or python to +/* Returns a string that can be evaluated in perl or python to generated a hash that holds the property's name, value and parameters. Sep is the hash seperation string, "=>" for perl and ":" for python */ @@ -192,12 +192,12 @@ struct icaltimetype /* Convert seconds past UNIX epoch to a timetype*/ struct icaltimetype icaltime_from_timet_with_zone(int v, int is_date, const char* tzid); -/* Return the time as seconds past the UNIX epoch */ +/* Returns the time as seconds past the UNIX epoch */ /* Normally, this returns a time_t, but SWIG tries to turn that type into a pointer */ int icaltime_as_timet(struct icaltimetype); -/* Return a string represention of the time, in RFC2445 format. The +/* Returns a string represention of the time, in RFC2445 format. The string is owned by libical */ char* icaltime_as_ical_string(struct icaltimetype tt); @@ -205,7 +205,7 @@ char* icaltime_as_ical_string(struct icaltimetype tt); struct icaltimetype icaltime_from_string(const char* str); /* Routines for handling timezones */ -/* Return the offset of the named zone as seconds. tt is a time +/* Returns the offset of the named zone as seconds. tt is a time indicating the date for which you want the offset */ int icaltime_utc_offset(struct icaltimetype tt, const char* tzid); @@ -218,10 +218,10 @@ struct icaltimetype icaltime_as_utc(struct icaltimetype tt, struct icaltimetype icaltime_as_zone(struct icaltimetype tt, const char* tzid); -/* Return a null time, which indicates no time has been set. This time represent the beginning of the epoch */ +/* Returns a null time, which indicates no time has been set. This time represent the beginning of the epoch */ struct icaltimetype icaltime_null_time(void); -/* Return true if the time is null. */ +/* Returns true if the time is null. */ int icaltime_is_null_time(struct icaltimetype t); /* Returns false if the time is clearly invalid, but is not null. This @@ -236,32 +236,32 @@ int icaltime_is_valid_time(struct icaltimetype t); underflow. */ struct icaltimetype icaltime_normalize(struct icaltimetype t); -/* Return the day of the year of the given time */ +/* Returns the day of the year of the given time */ short icaltime_day_of_year(struct icaltimetype t); /* Create a new time, given a day of year and a year. */ struct icaltimetype icaltime_from_day_of_year(short doy, short year); -/* Return the day of the week of the given time. Sunday is 0 */ +/* Returns the day of the week of the given time. Sunday is 0 */ short icaltime_day_of_week(struct icaltimetype t); -/* Return the day of the year for the first day of the week that the +/* Returns the day of the year for the first day of the week that the given time is within. */ short icaltime_start_doy_week(struct icaltimetype t, int fdow); -/* Return a string with the time represented in the same format as ctime(). THe string is owned by libical */ +/* Returns a string with the time represented in the same format as ctime(). THe string is owned by libical */ char* icaltime_as_ctime(struct icaltimetype); -/* Return the week number for the week the given time is within */ +/* Returns the week number for the week the given time is within */ short icaltime_week_number(struct icaltimetype t); -/* Return -1, 0, or 1 to indicate that a<b, a==b or a>b */ +/* Returns -1, 0, or 1 to indicate that a<b, a==b or a>b */ int icaltime_compare(struct icaltimetype a,struct icaltimetype b); /* like icaltime_compare, but only use the date parts. */ int icaltime_compare_date_only(struct icaltimetype a, struct icaltimetype b); -/* Return the number of days in the given month */ +/* Returns the number of days in the given month */ short icaltime_days_in_month(short month,short year); diff --git a/src/java/ICalParameter.java b/src/java/ICalParameter.java index 74bf3db8..af764e27 100644 --- a/src/java/ICalParameter.java +++ b/src/java/ICalParameter.java @@ -90,7 +90,7 @@ public class ICalParameter } /** - * Create instance from a string of form "PARAMNAME=VALUE" + * Creates instance from a string of form "PARAMNAME=VALUE" */ public ICalParameter(String str) { @@ -98,7 +98,7 @@ public class ICalParameter } /** - * Create from just the value, the part after the "=" + * Creates from just the value, the part after the "=" */ public ICalParameter(/* ICalParameterKind */ int kind, String str) { @@ -106,7 +106,7 @@ public class ICalParameter } /** - * Create empty value for specified kind + * Creates empty value for specified kind */ public ICalParameter(/* ICalParameterKind */ int kind) { @@ -114,22 +114,22 @@ public class ICalParameter } /** - * Return ical String representation + * Returns ical String representation */ public native String as_ical_string(); /** - * Return true if this instance is valid + * Returns true if this instance is valid */ //public native boolean is_valid(); /** - * Return what kind of parameter this instance represents + * Returns what kind of parameter this instance represents */ public native /* ICalParameterKind */ int isa(); /** - * Return true if this is a parameter + * Returns true if this is a parameter */ public native boolean isa_parameter(Object parameter); diff --git a/src/java/ICalProperty.java b/src/java/ICalProperty.java index 6aa8dae1..87e99f6e 100644 --- a/src/java/ICalProperty.java +++ b/src/java/ICalProperty.java @@ -189,7 +189,7 @@ public class ICalProperty public native ICalValue get_value(); public native String get_value_as_string(); - /* Return the name of the property -- the type name converted to a + /* Returns the name of the property -- the type name converted to a String, or the value of get_x_name if the type is X property */ public native String get_name(); diff --git a/src/java/VComponent.java b/src/java/VComponent.java index 70c5915c..d77c5bb9 100644 --- a/src/java/VComponent.java +++ b/src/java/VComponent.java @@ -80,7 +80,7 @@ public class VComponent /* Working with components */ - /* Return the first VEVENT, VTODO or VJOURNAL sub-component if it is one of those types */ + /* Returns the first VEVENT, VTODO or VJOURNAL sub-component if it is one of those types */ public native VComponent get_inner(); public native void add_component(VComponent child); diff --git a/src/libical-glib/api/i-cal-array.xml b/src/libical-glib/api/i-cal-array.xml index c8bf111e..889384fe 100644 --- a/src/libical-glib/api/i-cal-array.xml +++ b/src/libical-glib/api/i-cal-array.xml @@ -17,7 +17,7 @@ <method name="i_cal_array_size" corresponds="CUSTOM" kind="other" since="1.0"> <parameter type="ICalArray *" name="array" comment="The #ICalArray"/> <returns type="gint" comment="The size of current array."/> - <comment>Get the size of the array.</comment> + <comment>Gets the size of the array.</comment> <custom> icalarray *native; gint ret; g_return_val_if_fail (array != NULL && I_CAL_IS_ARRAY (array), -1); @@ -30,12 +30,12 @@ <parameter type="gint" name="element_size" comment="The size of the element of the array"/> <parameter type="gint" name="increment_size" comment="The incremental size when the array is full"/> <returns type="ICalArray *" annotation="transfer full" translator_argus="NULL, FALSE" comment="The newly create #ICalArray with the properties set by @element_size and @increment_size"/> - <comment xml:space="preserve">Create a #ICalArray with the element size to be @element_size and increment size to be @increment_size</comment> + <comment xml:space="preserve">Creates a #ICalArray with the element size to be @element_size and increment size to be @increment_size</comment> </method> --> <method name="i_cal_array_copy" corresponds="icalarray_copy" kind="clone" since="1.0"> <parameter type="ICalArray *" name="array" annotation="in" comment="The #ICalArray to be cloned."/> <returns type="ICalArray *" annotation="transfer full" translator_argus="NULL, FALSE" comment="The newly cloned #ICalArray with the same value as the @array"/> - <comment xml:space="preserve">Create a deep copy of #ICalArray with the same properties as the @array</comment> + <comment xml:space="preserve">Creates a deep copy of #ICalArray with the same properties as the @array</comment> </method> <method name="i_cal_array_free" corresponds="icalarray_free" annotation="skip" kind="destructor" since="1.0"> <parameter type="ICalArray *" name="array" comment="The #ICalArray to be freed."/> @@ -55,7 +55,7 @@ <parameter type="ICalArray *" name="array" comment="The #ICalArray to be queried."/> <parameter type="gint" name="position" comment="The position the target element is located"/> <returns type="GObject *" annotation="transfer none, allow-none" comment="The element located at the @position in the @array"/> - <comment xml:space="preserve">Get the element located in the @position in the @array. NULL if position if out of bound</comment> + <comment xml:space="preserve">Gets the element located in the @position in the @array. NULL if position if out of bound</comment> </method> <method name="i_cal_array_sort" corresponds="CUSTOM" annotation="skip" kind="others" since="1.0"> <parameter type="ICalArray *" name="array" comment="The #ICalArray to be sorted."/> diff --git a/src/libical-glib/api/i-cal-attach.xml b/src/libical-glib/api/i-cal-attach.xml index 69108e48..5abad5a1 100644 --- a/src/libical-glib/api/i-cal-attach.xml +++ b/src/libical-glib/api/i-cal-attach.xml @@ -17,14 +17,14 @@ <method name="i_cal_attach_new_from_url" corresponds="icalattach_new_from_url" kind="constructor" since="1.0"> <parameter type="const gchar *" name="url" comment="The url from which the object is created"/> <returns type="ICalAttach *" annotation="transfer full" comment="The newly created #ICalAttach from the @url" /> - <comment xml:space="preserve">Create a new #ICalAttach from the url</comment> + <comment xml:space="preserve">Creates a new #ICalAttach from the url</comment> </method> <method name="i_cal_attach_new_from_data" corresponds="CUSTOM" kind="constructor" since="1.0"> <parameter type="const gchar *" name="data" comment="The data used to create the #ICalAttach"/> <parameter type="GFunc" name="free_fn" translator="(icalattach_free_fn_t)" annotation="scope call, allow-none" comment="The function used to free the data when the create #ICalAttach is detroyed."/> <parameter type="void *" name="free_fn_data" annotation="allow-none" comment="The userdata used for the free function @free_fn"/> <returns type="ICalAttach *" annotation="transfer full" comment="The newly created #ICalAttach" /> - <comment xml:space="preserve">Create a new #ICalAttach from the data.</comment> + <comment xml:space="preserve">Creates a new #ICalAttach from the data.</comment> <custom> g_return_val_if_fail (data != NULL, NULL); return i_cal_attach_new_full (icalattach_new_from_data (data, (icalattach_free_fn_t) (free_fn), free_fn_data), NULL);</custom> @@ -42,7 +42,7 @@ static void unref_g_bytes(char *data, void *user_data) <method name="i_cal_attach_new_from_bytes" corresponds="CUSTOM" kind="constructor" since="1.0"> <parameter type="GBytes *" annotation="transfer full" name="bytes" comment="The #GBytes holding the data used to create the #ICalAttach"/> <returns type="ICalAttach *" annotation="transfer full" comment="The newly created #ICalAttach" /> - <comment xml:space="preserve">Create a new #ICalAttach from the data in bytes. Takes a reference of @bytes, increase the reference before calling this function if you with to use it afterward. The stored bytes should be already encoded with used encoding (like base64).</comment> + <comment xml:space="preserve">Creates a new #ICalAttach from the data in bytes. Takes a reference of @bytes, increase the reference before calling this function if you with to use it afterward. The stored bytes should be already encoded with used encoding (like base64).</comment> <custom> g_return_val_if_fail (bytes != NULL, NULL); return i_cal_attach_new_full (icalattach_new_from_data (g_bytes_get_data (bytes, NULL), unref_g_bytes, bytes), NULL);</custom> @@ -63,12 +63,12 @@ static void unref_g_bytes(char *data, void *user_data) <method name="i_cal_attach_get_url" corresponds="icalattach_get_url" kind="others" since="1.0"> <parameter type="ICalAttach *" name="attach" comment="The #ICalAttach to be queried"/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The url component of the @attach. %NULL if it is built from data or there is an error." /> - <comment xml:space="preserve">Get the url, if the #ICalAttach is built from the url.</comment> + <comment xml:space="preserve">Gets the url, if the #ICalAttach is built from the url.</comment> </method> <method name="i_cal_attach_get_data" corresponds="CUSTOM" kind="others" since="1.0"> <parameter type="ICalAttach *" name="attach" comment="The #ICalAttach to be queried"/> <returns type="const gchar *" annotation="nullable, transfer none" comment="The data component of the @attach. %NULL if it is built from url or there is an error." /> - <comment xml:space="preserve">Get the data, if the #ICalAttach is built from the data.</comment> + <comment xml:space="preserve">Gets the data, if the #ICalAttach is built from the data.</comment> <custom> g_return_val_if_fail (I_CAL_IS_ATTACH (attach), NULL); return (const gchar *) (icalattach_get_data ((icalattach *)i_cal_object_get_native (I_CAL_OBJECT (attach))));</custom> diff --git a/src/libical-glib/api/i-cal-component.xml b/src/libical-glib/api/i-cal-component.xml index 4f099ebd..15098381 100644 --- a/src/libical-glib/api/i-cal-component.xml +++ b/src/libical-glib/api/i-cal-component.xml @@ -17,7 +17,7 @@ <method name="i_cal_component_new" corresponds="icalcomponent_new" kind="constructor" since="1.0"> <parameter type="ICalComponentKind" name="kind" comment="The #ICalComponentKind."/> <returns type="ICalComponent *" annotation="transfer full" comment="The newly created #ICalComponent."/> - <comment xml:space="preserve">Create a new #ICalComponent with specific type.</comment> + <comment xml:space="preserve">Creates a new #ICalComponent with specific type.</comment> </method> <method name="i_cal_component_clone" corresponds="icalcomponent_new_clone" kind="clone" since="1.0"> <parameter type="ICalComponent *" name="component" comment="The #ICalComponent to be created."/> @@ -27,12 +27,12 @@ <method name="i_cal_component_new_from_string" corresponds="icalcomponent_new_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="str" comment="The string used to create #ICalComponent."/> <returns type="ICalComponent *" annotation="transfer full" comment="The newly created #ICalComponent based on @str."/> - <comment xml:space="preserve">Create a new #ICalComponent based on a string.</comment> + <comment xml:space="preserve">Creates a new #ICalComponent based on a string.</comment> </method> <method name="i_cal_component_new_x" corresponds="icalcomponent_new_x" kind="constructor" since="1.0"> <parameter type="const gchar *" name="x_name" comment="The name of x property."/> <returns type="ICalComponent *" annotation="transfer full" comment="The newly created #ICalComponent."/> - <comment xml:space="preserve">Create a new #ICalComponent based on name of x property.</comment> + <comment xml:space="preserve">Creates a new #ICalComponent based on name of x property.</comment> </method> <method name="i_cal_component_free" corresponds="icalcomponent_free" annotation="skip" kind="destructor" since="1.0"> <parameter type="ICalComponent *" name="component" comment="The #ICalComponent to be freed."/> @@ -51,7 +51,7 @@ <method name="i_cal_component_isa" corresponds="icalcomponent_isa" since="1.0"> <parameter type="const ICalComponent *" name="component" comment="The #ICalComponent to be checked."/> <returns type="ICalComponentKind" error_return_value="I_CAL_NO_COMPONENT" comment="A #ICalComponentKind."/> - <comment xml:space="preserve">Get the type of #ICalComponent.</comment> + <comment xml:space="preserve">Gets the type of #ICalComponent.</comment> </method> <method name="i_cal_component_isa_component" corresponds="icalcomponent_isa_component" since="1.0"> <parameter type="ICalComponent *" name="component" comment="The #ICalComponent to be checked."/> @@ -87,12 +87,12 @@ <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, nullable" 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> + <comment xml:space="preserve">Gets 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_property_set_parent" corresponds="icalproperty_set_parent" since="3.0"> <parameter type="ICalProperty *" name="property" comment="An #ICalProperty."/> <parameter type="ICalComponent *" name="component" annotation="nullable" comment="An #ICalComponent."/> - <comment xml:space="preserve">Set the parent #ICalComponent of the specified #ICalProperty.</comment> + <comment xml:space="preserve">Sets the parent #ICalComponent of the specified #ICalProperty.</comment> </method> <method name="i_cal_property_get_datetime_with_component" corresponds="icalproperty_get_datetime_with_component" kind="get" since="3.0.5"> <parameter type="ICalProperty *" name="prop" comment="An #ICalProperty."/> @@ -105,24 +105,24 @@ <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."/> - <comment xml:space="preserve">Get the current #ICalProperty in #ICalComponent.</comment> + <comment xml:space="preserve">Gets the current #ICalProperty in #ICalComponent.</comment> </method> <method name="i_cal_component_get_first_property" corresponds="icalcomponent_get_first_property" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <parameter type="ICalPropertyKind" name="kind" comment="A #ICalPropertyKind."/> <returns type="ICalProperty *" annotation="transfer full, nullable" translator_argus="(GObject *)component" comment="The first #ICalProperty."/> - <comment xml:space="preserve">Get the first #ICalProperty with specific kind in #ICalComponent.</comment> + <comment xml:space="preserve">Gets the first #ICalProperty with specific kind in #ICalComponent.</comment> </method> <method name="i_cal_component_get_next_property" corresponds="icalcomponent_get_next_property" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <parameter type="ICalPropertyKind" name="kind" comment="A #ICalPropertyKind."/> <returns type="ICalProperty *" annotation="transfer full, nullable" translator_argus="(GObject *)component" comment="The next #ICalProperty."/> - <comment xml:space="preserve">Get the next #ICalProperty with specific kind in #ICalComponent.</comment> + <comment xml:space="preserve">Gets the next #ICalProperty with specific kind in #ICalComponent.</comment> </method> <method name="i_cal_component_get_inner" corresponds="icalcomponent_get_inner" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalComponent *" annotation="transfer full, nullable" translator_argus="(GObject *)comp" comment="The first VEVENT, VTODO or VJOURNAL sub-component."/> - <comment xml:space="preserve">Return the first VEVENT, VTODO or VJOURNAL sub-component of cop, or comp if it is one of those types.</comment> + <comment xml:space="preserve">Returns the first VEVENT, VTODO or VJOURNAL sub-component of cop, or comp if it is one of those types.</comment> </method> <method name="i_cal_component_add_component" corresponds="icalcomponent_add_component" since="1.0"> <parameter type="ICalComponent *" name="parent" comment="A #ICalComponent."/> @@ -153,12 +153,12 @@ <method name="i_cal_component_get_parent" corresponds="icalcomponent_get_parent" since="3.0"> <parameter type="ICalComponent *" name="component" comment="The #ICalComponent."/> <returns type="ICalComponent *" annotation="transfer full, nullable" translator_argus="(GObject *)component" comment="The parent #ICalComponent of the @component."/> - <comment xml:space="preserve">Get the parent component of the @component.</comment> + <comment xml:space="preserve">Gets the parent component of the @component.</comment> </method> <method name="i_cal_component_set_parent" corresponds="icalcomponent_set_parent" since="3.0"> <parameter type="ICalComponent *" name="component" comment="An #ICalComponent, a child."/> <parameter type="ICalComponent *" name="parent" annotation="nullable" comment="An #ICalComponent, a new parent."/> - <comment xml:space="preserve">Set the @parent #ICalComponent of the specified @component.</comment> + <comment xml:space="preserve">Sets the @parent #ICalComponent of the specified @component.</comment> </method> <method name="i_cal_component_merge_component" corresponds="icalcomponent_merge_component" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="The #ICalComponent."/> @@ -168,46 +168,46 @@ <method name="i_cal_component_get_current_component" corresponds="icalcomponent_get_current_component" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <returns type="ICalComponent *" annotation="transfer full" translator_argus="(GObject *)component" comment="The current #ICalComponent."/> - <comment xml:space="preserve">Get the current #ICalComponent in #ICalComponent.</comment> + <comment xml:space="preserve">Gets the current #ICalComponent in #ICalComponent.</comment> </method> <method name="i_cal_component_get_first_component" corresponds="icalcomponent_get_first_component" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <parameter type="ICalComponentKind" name="kind" comment="A #ICalComponentKind."/> <returns type="ICalComponent *" annotation="transfer full, nullable" translator_argus="(GObject *)component" comment="The first #ICalComponent."/> - <comment xml:space="preserve">Get the first #ICalComponent with specific kind in #ICalComponent.</comment> + <comment xml:space="preserve">Gets the first #ICalComponent with specific kind in #ICalComponent.</comment> </method> <method name="i_cal_component_get_next_component" corresponds="icalcomponent_get_next_component" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <parameter type="ICalComponentKind" name="kind" comment="A #ICalComponentKind."/> <returns type="ICalComponent *" annotation="transfer full, nullable" translator_argus="(GObject *)component" comment="The next #ICalComponent."/> - <comment xml:space="preserve">Get the next #ICalComponent with specific kind in #ICalComponent.</comment> + <comment xml:space="preserve">Gets the next #ICalComponent with specific kind in #ICalComponent.</comment> </method> <method name="i_cal_component_begin_component" corresponds="icalcomponent_begin_component" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <parameter type="ICalComponentKind" name="kind" comment="A #ICalComponentKind."/> <returns type="ICalCompIter *" annotation="transfer full" comment="A #ICalCompIter"/> - <comment xml:space="preserve">Get the #ICalCompIter pointing to the first child #ICalComponent. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> + <comment xml:space="preserve">Gets the #ICalCompIter pointing to the first child #ICalComponent. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> </method> <method name="i_cal_component_end_component" corresponds="icalcomponent_end_component" since="1.0"> <parameter type="ICalComponent *" name="component" comment="A #ICalComponent."/> <parameter type="ICalComponentKind" name="kind" comment="A #ICalComponentKind."/> <returns type="ICalCompIter *" annotation="transfer full" comment="A #ICalCompIter"/> - <comment xml:space="preserve">Get the #ICalCompIter pointing to the end child #ICalComponent. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> + <comment xml:space="preserve">Gets the #ICalCompIter pointing to the end child #ICalComponent. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> </method> <method name="i_cal_comp_iter_next" corresponds="icalcompiter_next" since="1.0"> <parameter type="ICalCompIter *" name="i" native_op="POINTER" comment="A #ICalCompIter."/> <returns type="ICalComponent *" annotation="transfer full" comment="A #ICalCompIter"/> - <comment xml:space="preserve">Get the next #ICalComponent pointed by #ICalCompIter. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> + <comment xml:space="preserve">Gets the next #ICalComponent pointed by #ICalCompIter. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> </method> <method name="i_cal_comp_iter_prior" corresponds="icalcompiter_prior" since="1.0"> <parameter type="ICalCompIter *" name="i" native_op="POINTER" comment="A #ICalCompIter."/> <returns type="ICalComponent *" annotation="transfer full" comment="A #ICalCompIter"/> - <comment xml:space="preserve">Get the prior #ICalComponent pointed by #ICalCompIter. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> + <comment xml:space="preserve">Gets the prior #ICalComponent pointed by #ICalCompIter. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> </method> <method name="i_cal_comp_iter_deref" corresponds="icalcompiter_deref" since="1.0"> <parameter type="ICalCompIter *" name="i" native_op="POINTER" comment="A #ICalCompIter."/> <returns type="ICalComponent *" annotation="transfer full" comment="A #ICalComponent"/> - <comment xml:space="preserve">Get the current #ICalComponent pointed by #ICalCompIter. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> + <comment xml:space="preserve">Gets the current #ICalComponent pointed by #ICalCompIter. Use #ICalCompIter when you need remove the child component from the parent. For traversing, i_cal_object_set_owner needs to be called after this API. See component.py in tests for details.</comment> </method> <method name="i_cal_component_check_restrictions" corresponds="icalcomponent_check_restrictions" kind="other" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="The #ICalComponent to be checked"/> @@ -255,152 +255,152 @@ <method name="i_cal_component_set_dtstart" corresponds="icalcomponent_set_dtstart" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalTime *" name="v" comment="A #ICalTime."/> - <comment xml:space="preserve">Set the dtstart of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the dtstart of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_dtstart" corresponds="icalcomponent_get_dtstart" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalTime *" annotation="transfer full" comment="A #ICalTime."/> - <comment xml:space="preserve">Get the dtstart of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the dtstart of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_dtend" corresponds="icalcomponent_set_dtend" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalTime *" name="v" comment="A #ICalTime."/> - <comment xml:space="preserve">Set the dtend of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the dtend of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_dtend" corresponds="icalcomponent_get_dtend" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalTime *" annotation="transfer full" comment="A #ICalTime."/> - <comment xml:space="preserve">Get the dtend of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the dtend of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_due" corresponds="icalcomponent_set_due" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalTime *" name="v" comment="A #ICalTime."/> - <comment xml:space="preserve">Set the due of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the due of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_due" corresponds="icalcomponent_get_due" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalTime *" annotation="transfer full" comment="A #ICalTime."/> - <comment xml:space="preserve">Get the due of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the due of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_duration" corresponds="icalcomponent_set_duration" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalDuration *" name="v" comment="A #ICalDuration."/> - <comment xml:space="preserve">Set the duration of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the duration of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_duration" corresponds="icalcomponent_get_duration" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalDuration *" annotation="transfer full" comment="An #ICalDuration."/> - <comment xml:space="preserve">Get the duration of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the duration of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_method" corresponds="icalcomponent_set_method" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalPropertyMethod" name="method" comment="A #ICalPropertyMethod."/> - <comment xml:space="preserve">Set the method of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the method of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_method" corresponds="icalcomponent_get_method" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalPropertyMethod" comment="A #ICalPropertyMethod."/> - <comment xml:space="preserve">Get the method of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the method of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_dtstamp" corresponds="icalcomponent_set_dtstamp" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalTime *" name="v" comment="A #ICalTime."/> - <comment xml:space="preserve">Set the dtstamp of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the dtstamp of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_dtstamp" corresponds="icalcomponent_get_dtstamp" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalTime *" annotation="transfer full" comment="A #ICalTime."/> - <comment xml:space="preserve">Get the dtstamp of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the dtstamp of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_summary" corresponds="icalcomponent_set_summary" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="const gchar *" name="v" comment="A string representing summary."/> - <comment xml:space="preserve">Set the summary of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the summary of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_summary" corresponds="icalcomponent_get_summary" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="const gchar *" annotation="transfer none" comment="The summary of @comp."/> - <comment xml:space="preserve">Get the summary of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the summary of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_comment" corresponds="icalcomponent_set_comment" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="const gchar *" name="v" comment="A string representing comment."/> - <comment xml:space="preserve">Set the comment of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the comment of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_comment" corresponds="icalcomponent_get_comment" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="const gchar *" annotation="transfer none" comment="The comment of @comp."/> - <comment xml:space="preserve">Get the comment of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the comment of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_uid" corresponds="icalcomponent_set_uid" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="const gchar *" name="v" comment="A string representing uid."/> - <comment xml:space="preserve">Set the uid of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the uid of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_uid" corresponds="icalcomponent_get_uid" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="const gchar *" annotation="transfer none" comment="The uid of @comp."/> - <comment xml:space="preserve">Get the uid of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the uid of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_relcalid" corresponds="icalcomponent_set_relcalid" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="const gchar *" name="v" comment="A string representing relcalid."/> - <comment xml:space="preserve">Set the relcalid of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the relcalid of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_relcalid" corresponds="icalcomponent_get_relcalid" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="const gchar *" annotation="transfer none" comment="The relcalid of @comp."/> - <comment xml:space="preserve">Get the relcalid of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the relcalid of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_recurrenceid" corresponds="icalcomponent_set_recurrenceid" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalTime *" name="v" comment="A #ICalTime."/> - <comment xml:space="preserve">Set the recurrenceid of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the recurrenceid of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_recurrenceid" corresponds="icalcomponent_get_recurrenceid" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalTime *" annotation="transfer full" comment="A #ICalTime."/> - <comment xml:space="preserve">Get the recurrenceid of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the recurrenceid of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_description" corresponds="icalcomponent_set_description" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="const gchar *" name="v" comment="A string representing description."/> - <comment xml:space="preserve">Set the description of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the description of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_description" corresponds="icalcomponent_get_description" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="const gchar *" annotation="transfer none" comment="The description of @comp."/> - <comment xml:space="preserve">Get the description of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the description of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_location" corresponds="icalcomponent_set_location" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="const gchar *" name="v" comment="A string representing location."/> - <comment xml:space="preserve">Set the location of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the location of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_location" corresponds="icalcomponent_get_location" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="const gchar *" annotation="transfer none" comment="The location of @comp."/> - <comment xml:space="preserve">Get the location of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the location of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_sequence" corresponds="icalcomponent_set_sequence" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="gint" name="v" comment="The sequence number."/> - <comment xml:space="preserve">Set the sequence of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the sequence of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_sequence" corresponds="icalcomponent_get_sequence" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="gint" comment="The sequence of @comp."/> - <comment xml:space="preserve">Get the sequence of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the sequence of the #ICalComponent.</comment> </method> <method name="i_cal_component_set_status" corresponds="icalcomponent_set_status" kind="set" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <parameter type="ICalPropertyStatus" name="status" comment="A #ICalPropertyStatus."/> - <comment xml:space="preserve">Set the status of the #ICalComponent.</comment> + <comment xml:space="preserve">Sets the status of the #ICalComponent.</comment> </method> <method name="i_cal_component_get_status" corresponds="icalcomponent_get_status" kind="get" since="1.0"> <parameter type="ICalComponent *" name="comp" comment="A #ICalComponent."/> <returns type="ICalPropertyStatus" comment="A #ICalPropertyStatus."/> - <comment xml:space="preserve">Get the status of the #ICalComponent.</comment> + <comment xml:space="preserve">Gets the status of the #ICalComponent.</comment> </method> <declaration position="header" content="typedef void (*ICalComponentForeachTZIDFunc)(ICalParameter *param, gpointer user_data);"/> <declaration position="body"> @@ -505,66 +505,66 @@ static void foreach_recurrence_cb(icalcomponent *in_comp, struct icaltime_span * </method> <method name="i_cal_component_new_vcalendar" corresponds="icalcomponent_new_vcalendar" 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 vcalendar</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vcalendar</comment> </method> <method name="i_cal_component_new_vevent" corresponds="icalcomponent_new_vevent" 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 vevent</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vevent</comment> </method> <method name="i_cal_component_new_vtodo" corresponds="icalcomponent_new_vtodo" 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 vtodo</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vtodo</comment> </method> <method name="i_cal_component_new_vjournal" corresponds="icalcomponent_new_vjournal" 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 vjournal</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vjournal</comment> </method> <method name="i_cal_component_new_valarm" corresponds="icalcomponent_new_valarm" 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 valarm</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be valarm</comment> </method> <method name="i_cal_component_new_vfreebusy" corresponds="icalcomponent_new_vfreebusy" 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 vfreebusy</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vfreebusy</comment> </method> <method name="i_cal_component_new_vtimezone" corresponds="icalcomponent_new_vtimezone" 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 vtimezone</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vtimezone</comment> </method> <method name="i_cal_component_new_xstandard" corresponds="icalcomponent_new_xstandard" 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 xstandard</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be xstandard</comment> </method> <method name="i_cal_component_new_xdaylight" corresponds="icalcomponent_new_xdaylight" 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 xdaylight</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be xdaylight</comment> </method> <method name="i_cal_component_new_vagenda" corresponds="icalcomponent_new_vagenda" 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 vagenda</comment> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be vagenda</comment> </method> <method name="i_cal_component_new_vquery" corresponds="icalcomponent_new_vquery" 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 vquery</comment> + <comment xml:space="preserve">Creates 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> + <comment xml:space="preserve">Creates 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> + <comment xml:space="preserve">Creates 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> + <comment xml:space="preserve">Creates 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> + <comment xml:space="preserve">Creates 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> + <comment xml:space="preserve">Creates a #ICalComponent with the type to be xvote</comment> </method> </structure> diff --git a/src/libical-glib/api/i-cal-datetimeperiod.xml b/src/libical-glib/api/i-cal-datetimeperiod.xml index 226a4095..a5907ab0 100644 --- a/src/libical-glib/api/i-cal-datetimeperiod.xml +++ b/src/libical-glib/api/i-cal-datetimeperiod.xml @@ -16,7 +16,7 @@ <structure namespace="ICal" name="Datetimeperiod" native="struct icaldatetimeperiodtype" is_bare="true" default_native="i_cal_datetimeperiod_new_default ()" includes="libical-glib/i-cal-time.h, libical-glib/i-cal-period.h"> <method name="i_cal_datetimeperiod_new_default" corresponds="CUSTOM" annotation="skip" kind="private" since="1.0"> <returns type="struct icaldatetimeperiodtype" annotation="transfer full" comment="The newly created #ICalDatetimeperiod" /> - <comment xml:space="preserve">Create a new default #ICalDatetimeperiod</comment> + <comment xml:space="preserve">Creates a new default #ICalDatetimeperiod</comment> <custom> struct icaldatetimeperiodtype datetimeperiodtype; datetimeperiodtype.time = icaltime_null_time (); datetimeperiodtype.period = icalperiodtype_null_period (); @@ -24,20 +24,20 @@ </method> <method name="i_cal_datetimeperiod_new" corresponds="CUSTOM" kind="constructor" since="1.0"> <returns type="ICalDatetimeperiod *" annotation="transfer full" comment="The newly created #ICalDatetimeperiod." /> - <comment xml:space="preserve">Create a new #ICalDatetimeperiod.</comment> + <comment xml:space="preserve">Creates a new #ICalDatetimeperiod.</comment> <custom> return i_cal_datetimeperiod_new_full(i_cal_datetimeperiod_new_default());</custom> </method> <method name="i_cal_datetimeperiod_get_time" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDatetimeperiod *" name="dtp" comment="The #ICalDatetimeperiod to be queried"/> <returns type="ICalTime *" annotation="transfer full" comment="The time attribute of @dtp."/> - <comment>Get the time attribute of #ICalDatetimeperiod.</comment> + <comment>Gets the time attribute of #ICalDatetimeperiod.</comment> <custom> g_return_val_if_fail (dtp != NULL && I_CAL_IS_DATETIMEPERIOD (dtp), NULL); return i_cal_time_new_full (((struct icaldatetimeperiodtype *)i_cal_object_get_native ((ICalObject *)dtp))->time);</custom> </method> <method name="i_cal_datetimeperiod_set_time" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDatetimeperiod *" name="dtp" comment="The #ICalDatetimeperiod to be set"/> <parameter type="ICalTime *" name="time" comment="The time attribute of @dtp."/> - <comment>Set the time attribute of #ICalDatetimeperiod.</comment> + <comment>Sets the time attribute of #ICalDatetimeperiod.</comment> <custom> g_return_if_fail (dtp != NULL && I_CAL_IS_DATETIMEPERIOD (dtp)); g_return_if_fail (time != NULL && I_CAL_IS_TIME(time)); ((struct icaldatetimeperiodtype *)i_cal_object_get_native ((ICalObject *)dtp))->time = *(struct icaltimetype *)i_cal_object_get_native ((ICalObject *)time);</custom> @@ -45,14 +45,14 @@ <method name="i_cal_datetimeperiod_get_period" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDatetimeperiod *" name="dtp" comment="The #ICalDatetimeperiod to be queried"/> <returns type="ICalPeriod *" annotation="transfer full" comment="The period attribute of @dtp."/> - <comment>Get the period attribute of #ICalDatetimeperiod.</comment> + <comment>Gets the period attribute of #ICalDatetimeperiod.</comment> <custom> g_return_val_if_fail (dtp != NULL && I_CAL_IS_DATETIMEPERIOD (dtp), NULL); return i_cal_period_new_full (((struct icaldatetimeperiodtype *)i_cal_object_get_native ((ICalObject *)dtp))->period);</custom> </method> <method name="i_cal_datetimeperiod_set_period" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDatetimeperiod *" name="dtp" comment="The #ICalDatetimeperiod to be set"/> <parameter type="ICalPeriod *" name="period" comment="The period attribute of @dtp."/> - <comment>Set the period attribute of #ICalDatetimeperiod.</comment> + <comment>Sets the period attribute of #ICalDatetimeperiod.</comment> <custom> g_return_if_fail (dtp != NULL && I_CAL_IS_DATETIMEPERIOD (dtp)); g_return_if_fail (period != NULL && I_CAL_IS_PERIOD(period)); ((struct icaldatetimeperiodtype *)i_cal_object_get_native ((ICalObject *)dtp))->period = *(struct icalperiodtype *)i_cal_object_get_native ((ICalObject *)period);</custom> diff --git a/src/libical-glib/api/i-cal-derived-parameter.xml b/src/libical-glib/api/i-cal-derived-parameter.xml index 6a84a7e3..79a92b03 100644 --- a/src/libical-glib/api/i-cal-derived-parameter.xml +++ b/src/libical-glib/api/i-cal-derived-parameter.xml @@ -228,7 +228,7 @@ <method name="i_cal_parameter_new_actionparam" corresponds="icalparameter_new_actionparam" kind="constructor" since="1.0"> <parameter type="ICalParameterAction" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the action type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the action type</comment> </method> <method name="i_cal_parameter_get_actionparam" corresponds="icalparameter_get_actionparam" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -348,7 +348,7 @@ <method name="i_cal_parameter_new_enable" corresponds="icalparameter_new_enable" kind="constructor" since="1.0"> <parameter type="ICalParameterEnable" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the enable type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the enable type</comment> </method> <method name="i_cal_parameter_get_enable" corresponds="icalparameter_get_enable" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -363,7 +363,7 @@ <method name="i_cal_parameter_new_encoding" corresponds="icalparameter_new_encoding" kind="constructor" since="1.0"> <parameter type="ICalParameterEncoding" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the encoding type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the encoding type</comment> </method> <method name="i_cal_parameter_get_encoding" corresponds="icalparameter_get_encoding" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -378,7 +378,7 @@ <method name="i_cal_parameter_new_fbtype" corresponds="icalparameter_new_fbtype" kind="constructor" since="1.0"> <parameter type="ICalParameterFbtype" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the fbtype type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the fbtype type</comment> </method> <method name="i_cal_parameter_get_fbtype" corresponds="icalparameter_get_fbtype" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -483,7 +483,7 @@ <method name="i_cal_parameter_new_local" corresponds="icalparameter_new_local" kind="constructor" since="1.0"> <parameter type="ICalParameterLocal" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the local type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the local type</comment> </method> <method name="i_cal_parameter_get_local" corresponds="icalparameter_get_local" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -573,7 +573,7 @@ <method name="i_cal_parameter_new_partstat" corresponds="icalparameter_new_partstat" kind="constructor" since="1.0"> <parameter type="ICalParameterPartstat" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the partstat type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the partstat type</comment> </method> <method name="i_cal_parameter_get_partstat" corresponds="icalparameter_get_partstat" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -603,7 +603,7 @@ <method name="i_cal_parameter_new_range" corresponds="icalparameter_new_range" kind="constructor" since="1.0"> <parameter type="ICalParameterRange" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the range type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the range type</comment> </method> <method name="i_cal_parameter_get_range" corresponds="icalparameter_get_range" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -633,7 +633,7 @@ <method name="i_cal_parameter_new_related" corresponds="icalparameter_new_related" kind="constructor" since="1.0"> <parameter type="ICalParameterRelated" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the related type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the related type</comment> </method> <method name="i_cal_parameter_get_related" corresponds="icalparameter_get_related" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -648,7 +648,7 @@ <method name="i_cal_parameter_new_reltype" corresponds="icalparameter_new_reltype" kind="constructor" since="1.0"> <parameter type="ICalParameterReltype" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the reltype type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the reltype type</comment> </method> <method name="i_cal_parameter_get_reltype" corresponds="icalparameter_get_reltype" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -663,7 +663,7 @@ <method name="i_cal_parameter_new_required" corresponds="icalparameter_new_required" kind="constructor" since="2.0"> <parameter type="ICalParameterRequired" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the required type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the required type</comment> </method> <method name="i_cal_parameter_get_required" corresponds="icalparameter_get_required" kind="get" since="2.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -678,7 +678,7 @@ <method name="i_cal_parameter_new_response" corresponds="icalparameter_new_response" kind="constructor" since="2.0"> <parameter type="gint" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the response type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the response type</comment> </method> <method name="i_cal_parameter_get_response" corresponds="icalparameter_get_response" kind="get" since="2.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -693,7 +693,7 @@ <method name="i_cal_parameter_new_role" corresponds="icalparameter_new_role" kind="constructor" since="1.0"> <parameter type="ICalParameterRole" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the role type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the role type</comment> </method> <method name="i_cal_parameter_get_role" corresponds="icalparameter_get_role" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -708,7 +708,7 @@ <method name="i_cal_parameter_new_rsvp" corresponds="icalparameter_new_rsvp" kind="constructor" since="1.0"> <parameter type="ICalParameterRsvp" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the rsvp type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the rsvp type</comment> </method> <method name="i_cal_parameter_get_rsvp" corresponds="icalparameter_get_rsvp" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -723,7 +723,7 @@ <method name="i_cal_parameter_new_scheduleagent" corresponds="icalparameter_new_scheduleagent" kind="constructor" since="1.0"> <parameter type="ICalParameterScheduleagent" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the scheduleagent type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the scheduleagent type</comment> </method> <method name="i_cal_parameter_get_scheduleagent" corresponds="icalparameter_get_scheduleagent" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -738,7 +738,7 @@ <method name="i_cal_parameter_new_scheduleforcesend" corresponds="icalparameter_new_scheduleforcesend" kind="constructor" since="1.0"> <parameter type="ICalParameterScheduleforcesend" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the scheduleforcesend type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the scheduleforcesend type</comment> </method> <method name="i_cal_parameter_get_scheduleforcesend" corresponds="icalparameter_get_scheduleforcesend" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -798,7 +798,7 @@ <method name="i_cal_parameter_new_stayinformed" corresponds="icalparameter_new_stayinformed" kind="constructor" since="2.0"> <parameter type="ICalParameterStayinformed" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the stayinformed type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the stayinformed type</comment> </method> <method name="i_cal_parameter_get_stayinformed" corresponds="icalparameter_get_stayinformed" kind="get" since="2.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -813,7 +813,7 @@ <method name="i_cal_parameter_new_substate" corresponds="icalparameter_new_substate" kind="constructor" since="1.0"> <parameter type="ICalParameterSubstate" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the substate type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the substate type</comment> </method> <method name="i_cal_parameter_get_substate" corresponds="icalparameter_get_substate" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -843,7 +843,7 @@ <method name="i_cal_parameter_new_value" corresponds="icalparameter_new_value" kind="constructor" since="1.0"> <parameter type="ICalParameterValue" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the value type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the value type</comment> </method> <method name="i_cal_parameter_get_value" corresponds="icalparameter_get_value" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -873,7 +873,7 @@ <method name="i_cal_parameter_new_xliccomparetype" corresponds="icalparameter_new_xliccomparetype" kind="constructor" since="1.0"> <parameter type="ICalParameterXliccomparetype" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the xliccomparetype type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the xliccomparetype type</comment> </method> <method name="i_cal_parameter_get_xliccomparetype" corresponds="icalparameter_get_xliccomparetype" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> @@ -888,7 +888,7 @@ <method name="i_cal_parameter_new_xlicerrortype" corresponds="icalparameter_new_xlicerrortype" kind="constructor" since="1.0"> <parameter type="ICalParameterXlicerrortype" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the xlicerrortype type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the xlicerrortype type</comment> </method> <method name="i_cal_parameter_get_xlicerrortype" corresponds="icalparameter_get_xlicerrortype" kind="get" since="1.0"> <parameter type="const ICalParameter *" name="value" comment="The #ICalParameter to be queried"/> diff --git a/src/libical-glib/api/i-cal-derived-property.xml b/src/libical-glib/api/i-cal-derived-property.xml index be73088e..cb85f3e0 100644 --- a/src/libical-glib/api/i-cal-derived-property.xml +++ b/src/libical-glib/api/i-cal-derived-property.xml @@ -135,67 +135,67 @@ <method name="i_cal_property_new_acceptresponse" corresponds="icalproperty_new_acceptresponse" kind="constructor" since="2.0"> <parameter type="const gchar *" name="v" comment="The acceptresponse."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_acceptresponse" corresponds="icalproperty_set_acceptresponse" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The acceptresponse."/> - <comment>Set the acceptresponse for the #ICalProperty.</comment> + <comment>Sets the acceptresponse for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_acceptresponse" corresponds="icalproperty_get_acceptresponse" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the acceptresponse of #ICalProperty."/> - <comment>Get the acceptresponse of #ICalProperty.</comment> + <comment>Gets the acceptresponse of #ICalProperty.</comment> </method> <method name="i_cal_property_new_acknowledged" corresponds="icalproperty_new_acknowledged" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of acknowledgement."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_acknowledged" corresponds="icalproperty_set_acknowledged" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The acknowledgement time."/> - <comment>Set the acknowledged time for the #ICalProperty.</comment> + <comment>Sets the acknowledged time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_acknowledged" corresponds="icalproperty_get_acknowledged" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the acknowledged time of #ICalProperty."/> - <comment>Get the acknowledged time of #ICalProperty.</comment> + <comment>Gets the acknowledged time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_action" corresponds="icalproperty_new_action" kind="constructor" since="1.0"> <parameter type="ICalPropertyAction" name="v" comment="The action."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_action" corresponds="icalproperty_set_action" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyAction" name="v" comment="The action."/> - <comment>Set the action for the #ICalProperty.</comment> + <comment>Sets the action for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_action" corresponds="icalproperty_get_action" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyAction" comment="Get the action of #ICalProperty."/> - <comment>Get the action of #ICalProperty.</comment> + <comment>Gets the action of #ICalProperty.</comment> </method> <method name="i_cal_property_new_allowconflict" corresponds="icalproperty_new_allowconflict" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The allowconflict."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_allowconflict" corresponds="icalproperty_set_allowconflict" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The allowconflict."/> - <comment>Set the allowconflict for the #ICalProperty.</comment> + <comment>Sets the allowconflict for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_allowconflict" corresponds="icalproperty_get_allowconflict" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the allowconflict of #ICalProperty."/> - <comment>Get the allowconflict of #ICalProperty.</comment> + <comment>Gets the allowconflict of #ICalProperty.</comment> </method> <method name="i_cal_property_new_attach" corresponds="CUSTOM" kind="constructor" since="1.0"> <parameter type="ICalAttach *" name="v" comment="The #ICalAttach."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly created #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> <custom> ICalProperty *property; g_return_val_if_fail (I_CAL_IS_ATTACH (v), NULL); property = i_cal_property_new_full (icalproperty_new_attach (i_cal_object_get_native ((ICalObject *)v)), NULL); @@ -204,1646 +204,1646 @@ <method name="i_cal_property_set_attach" corresponds="icalproperty_set_attach" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalAttach *" name="v" annotation="transfer none" comment="The attach."/> - <comment>Set the attach for the #ICalProperty.</comment> + <comment>Sets the attach for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_attach" corresponds="icalproperty_get_attach" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalAttach *" annotation="transfer full" translator_argus="(GObject *)prop" comment="Get the attach of #ICalProperty."/> - <comment>Get the attach of #ICalProperty.</comment> + <comment>Gets the attach of #ICalProperty.</comment> </method> <method name="i_cal_property_new_attendee" corresponds="icalproperty_new_attendee" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The attendee."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_attendee" corresponds="icalproperty_set_attendee" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The attendee."/> - <comment>Set the attendee for the #ICalProperty.</comment> + <comment>Sets the attendee for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_attendee" corresponds="icalproperty_get_attendee" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the attendee of #ICalProperty."/> - <comment>Get the attendee of #ICalProperty.</comment> + <comment>Gets the attendee of #ICalProperty.</comment> </method> <method name="i_cal_property_new_busytype" corresponds="icalproperty_new_busytype" kind="constructor" since="2.0"> <parameter type="ICalPropertyBusytype" name="v" comment="The busytype."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_busytype" corresponds="icalproperty_set_busytype" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyBusytype" name="v" comment="The busytype."/> - <comment>Set the busytype for the #ICalProperty.</comment> + <comment>Sets the busytype for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_busytype" corresponds="icalproperty_get_busytype" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyBusytype" comment="Get the busytype of #ICalProperty."/> - <comment>Get the busytype of #ICalProperty.</comment> + <comment>Gets the busytype of #ICalProperty.</comment> </method> <method name="i_cal_property_new_calid" corresponds="icalproperty_new_calid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The calid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_calid" corresponds="icalproperty_set_calid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The calid."/> - <comment>Set the calid for the #ICalProperty.</comment> + <comment>Sets the calid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_calid" corresponds="icalproperty_get_calid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the calid of #ICalProperty."/> - <comment>Get the calid of #ICalProperty.</comment> + <comment>Gets the calid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_calmaster" corresponds="icalproperty_new_calmaster" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The calmaster."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_calmaster" corresponds="icalproperty_set_calmaster" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The calmaster."/> - <comment>Set the calmaster for the #ICalProperty.</comment> + <comment>Sets the calmaster for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_calmaster" corresponds="icalproperty_get_calmaster" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the calmaster of #ICalProperty."/> - <comment>Get the calmaster of #ICalProperty.</comment> + <comment>Gets the calmaster of #ICalProperty.</comment> </method> <method name="i_cal_property_new_calscale" corresponds="icalproperty_new_calscale" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The calscale."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_calscale" corresponds="icalproperty_set_calscale" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The calscale."/> - <comment>Set the calscale for the #ICalProperty.</comment> + <comment>Sets the calscale for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_calscale" corresponds="icalproperty_get_calscale" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the calscale of #ICalProperty."/> - <comment>Get the calscale of #ICalProperty.</comment> + <comment>Gets the calscale of #ICalProperty.</comment> </method> <method name="i_cal_property_new_capversion" corresponds="icalproperty_new_capversion" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The capversion."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_capversion" corresponds="icalproperty_set_capversion" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The capversion."/> - <comment>Set the capversion for the #ICalProperty.</comment> + <comment>Sets the capversion for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_capversion" corresponds="icalproperty_get_capversion" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the capversion of #ICalProperty."/> - <comment>Get the capversion of #ICalProperty.</comment> + <comment>Gets the capversion of #ICalProperty.</comment> </method> <method name="i_cal_property_new_carlevel" corresponds="icalproperty_new_carlevel" kind="constructor" since="1.0"> <parameter type="ICalPropertyCarlevel" name="v" comment="The carlevel."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_carlevel" corresponds="icalproperty_set_carlevel" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyCarlevel" name="v" comment="The carlevel."/> - <comment>Set the carlevel for the #ICalProperty.</comment> + <comment>Sets the carlevel for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_carlevel" corresponds="icalproperty_get_carlevel" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyCarlevel" comment="Get the carlevel of #ICalProperty."/> - <comment>Get the carlevel of #ICalProperty.</comment> + <comment>Gets the carlevel of #ICalProperty.</comment> </method> <method name="i_cal_property_new_carid" corresponds="icalproperty_new_carid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The carid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_carid" corresponds="icalproperty_set_carid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The carid."/> - <comment>Set the carid for the #ICalProperty.</comment> + <comment>Sets the carid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_carid" corresponds="icalproperty_get_carid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the carid of #ICalProperty."/> - <comment>Get the carid of #ICalProperty.</comment> + <comment>Gets the carid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_categories" corresponds="icalproperty_new_categories" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The categories."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_categories" corresponds="icalproperty_set_categories" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The categories."/> - <comment>Set the categories for the #ICalProperty.</comment> + <comment>Sets the categories for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_categories" corresponds="icalproperty_get_categories" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the categories of #ICalProperty."/> - <comment>Get the categories of #ICalProperty.</comment> + <comment>Gets the categories of #ICalProperty.</comment> </method> <method name="i_cal_property_new_class" corresponds="icalproperty_new_class" kind="constructor" since="1.0"> <parameter type="ICalProperty_Class" name="v" comment="The class."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_class" corresponds="icalproperty_set_class" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalProperty_Class" name="v" comment="The class."/> - <comment>Set the class for the #ICalProperty.</comment> + <comment>Sets the class for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_class" corresponds="icalproperty_get_class" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalProperty_Class" comment="Get the class of #ICalProperty."/> - <comment>Get the class of #ICalProperty.</comment> + <comment>Gets the class of #ICalProperty.</comment> </method> <method name="i_cal_property_new_cmd" corresponds="icalproperty_new_cmd" kind="constructor" since="1.0"> <parameter type="ICalPropertyCmd" name="v" comment="The cmd."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_cmd" corresponds="icalproperty_set_cmd" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyCmd" name="v" comment="The cmd."/> - <comment>Set the cmd for the #ICalProperty.</comment> + <comment>Sets the cmd for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_cmd" corresponds="icalproperty_get_cmd" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyCmd" comment="Get the cmd of #ICalProperty."/> - <comment>Get the cmd of #ICalProperty.</comment> + <comment>Gets the cmd of #ICalProperty.</comment> </method> <method name="i_cal_property_new_comment" corresponds="icalproperty_new_comment" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The comment."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_comment" corresponds="icalproperty_set_comment" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The comment."/> - <comment>Set the comment for the #ICalProperty.</comment> + <comment>Sets the comment for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_color" corresponds="icalproperty_get_color" kind="get" since="3.0.5"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the color property."/> - <comment>Get the color property of the @prop.</comment> + <comment>Gets the color property of the @prop.</comment> </method> <method name="i_cal_property_new_color" corresponds="icalproperty_new_color" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The color."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new color #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new color #ICalProperty.</comment> </method> <method name="i_cal_property_set_color" corresponds="icalproperty_set_color" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The color."/> - <comment>Set the color for the @prop.</comment> + <comment>Sets the color for the @prop.</comment> </method> <method name="i_cal_property_get_comment" corresponds="icalproperty_get_comment" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the comment of #ICalProperty."/> - <comment>Get the comment of #ICalProperty.</comment> + <comment>Gets the comment of #ICalProperty.</comment> </method> <method name="i_cal_property_new_completed" corresponds="icalproperty_new_completed" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of completed."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_completed" corresponds="icalproperty_set_completed" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The completed time."/> - <comment>Set the completed time for the #ICalProperty.</comment> + <comment>Sets the completed time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_completed" corresponds="icalproperty_get_completed" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the completed time of #ICalProperty."/> - <comment>Get the completed time of #ICalProperty.</comment> + <comment>Gets the completed time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_components" corresponds="icalproperty_new_components" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The components."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_components" corresponds="icalproperty_set_components" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The components."/> - <comment>Set the components for the #ICalProperty.</comment> + <comment>Sets the components for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_components" corresponds="icalproperty_get_components" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the components of #ICalProperty."/> - <comment>Get the components of #ICalProperty.</comment> + <comment>Gets the components of #ICalProperty.</comment> </method> <method name="i_cal_property_new_contact" corresponds="icalproperty_new_contact" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The contact."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_contact" corresponds="icalproperty_set_contact" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The contact."/> - <comment>Set the contact for the #ICalProperty.</comment> + <comment>Sets the contact for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_contact" corresponds="icalproperty_get_contact" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the contact of #ICalProperty."/> - <comment>Get the contact of #ICalProperty.</comment> + <comment>Gets the contact of #ICalProperty.</comment> </method> <method name="i_cal_property_new_created" corresponds="icalproperty_new_created" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of created."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_created" corresponds="icalproperty_set_created" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The created time."/> - <comment>Set the created time for the #ICalProperty.</comment> + <comment>Sets the created time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_created" corresponds="icalproperty_get_created" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the created time of #ICalProperty."/> - <comment>Get the created time of #ICalProperty.</comment> + <comment>Gets the created time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_csid" corresponds="icalproperty_new_csid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The csid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_csid" corresponds="icalproperty_set_csid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The csid."/> - <comment>Set the csid for the #ICalProperty.</comment> + <comment>Sets the csid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_csid" corresponds="icalproperty_get_csid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the csid of #ICalProperty."/> - <comment>Get the csid of #ICalProperty.</comment> + <comment>Gets the csid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_datemax" corresponds="icalproperty_new_datemax" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of datemax."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_datemax" corresponds="icalproperty_set_datemax" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The datemax time."/> - <comment>Set the datemax time for the #ICalProperty.</comment> + <comment>Sets the datemax time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_datemax" corresponds="icalproperty_get_datemax" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the datemax time of #ICalProperty."/> - <comment>Get the datemax time of #ICalProperty.</comment> + <comment>Gets the datemax time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_datemin" corresponds="icalproperty_new_datemin" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of datemin."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_datemin" corresponds="icalproperty_set_datemin" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The datemin time."/> - <comment>Set the datemin time for the #ICalProperty.</comment> + <comment>Sets the datemin time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_datemin" corresponds="icalproperty_get_datemin" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the datemin time of #ICalProperty."/> - <comment>Get the datemin time of #ICalProperty.</comment> + <comment>Gets the datemin time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_decreed" corresponds="icalproperty_new_decreed" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The decreed."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_decreed" corresponds="icalproperty_set_decreed" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The decreed."/> - <comment>Set the decreed for the #ICalProperty.</comment> + <comment>Sets the decreed for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_decreed" corresponds="icalproperty_get_decreed" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the decreed of #ICalProperty."/> - <comment>Get the decreed of #ICalProperty.</comment> + <comment>Gets the decreed of #ICalProperty.</comment> </method> <method name="i_cal_property_new_defaultcharset" corresponds="icalproperty_new_defaultcharset" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The defaultcharset."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_defaultcharset" corresponds="icalproperty_set_defaultcharset" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The defaultcharset."/> - <comment>Set the defaultcharset for the #ICalProperty.</comment> + <comment>Sets the defaultcharset for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_defaultcharset" corresponds="icalproperty_get_defaultcharset" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the defaultcharset of #ICalProperty."/> - <comment>Get the defaultcharset of #ICalProperty.</comment> + <comment>Gets the defaultcharset of #ICalProperty.</comment> </method> <method name="i_cal_property_new_defaultlocale" corresponds="icalproperty_new_defaultlocale" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The defaultlocale."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_defaultlocale" corresponds="icalproperty_set_defaultlocale" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The defaultlocale."/> - <comment>Set the defaultlocale for the #ICalProperty.</comment> + <comment>Sets the defaultlocale for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_defaultlocale" corresponds="icalproperty_get_defaultlocale" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the defaultlocale of #ICalProperty."/> - <comment>Get the defaultlocale of #ICalProperty.</comment> + <comment>Gets the defaultlocale of #ICalProperty.</comment> </method> <method name="i_cal_property_new_defaulttzid" corresponds="icalproperty_new_defaulttzid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The defaulttzid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_defaulttzid" corresponds="icalproperty_set_defaulttzid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The defaulttzid."/> - <comment>Set the defaulttzid for the #ICalProperty.</comment> + <comment>Sets the defaulttzid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_defaulttzid" corresponds="icalproperty_get_defaulttzid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the defaulttzid of #ICalProperty."/> - <comment>Get the defaulttzid of #ICalProperty.</comment> + <comment>Gets the defaulttzid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_defaultvcars" corresponds="icalproperty_new_defaultvcars" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The defaultvcars."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_defaultvcars" corresponds="icalproperty_set_defaultvcars" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The defaultvcars."/> - <comment>Set the defaultvcars for the #ICalProperty.</comment> + <comment>Sets the defaultvcars for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_defaultvcars" corresponds="icalproperty_get_defaultvcars" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the defaultvcars of #ICalProperty."/> - <comment>Get the defaultvcars of #ICalProperty.</comment> + <comment>Gets the defaultvcars of #ICalProperty.</comment> </method> <method name="i_cal_property_new_deny" corresponds="icalproperty_new_deny" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The deny."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_deny" corresponds="icalproperty_set_deny" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The deny."/> - <comment>Set the deny for the #ICalProperty.</comment> + <comment>Sets the deny for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_deny" corresponds="icalproperty_get_deny" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the deny of #ICalProperty."/> - <comment>Get the deny of #ICalProperty.</comment> + <comment>Gets the deny of #ICalProperty.</comment> </method> <method name="i_cal_property_new_description" corresponds="icalproperty_new_description" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The description."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_description" corresponds="icalproperty_set_description" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The description."/> - <comment>Set the description for the #ICalProperty.</comment> + <comment>Sets the description for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_description" corresponds="icalproperty_get_description" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the description of #ICalProperty."/> - <comment>Get the description of #ICalProperty.</comment> + <comment>Gets the description of #ICalProperty.</comment> </method> <method name="i_cal_property_new_dtend" corresponds="icalproperty_new_dtend" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of dtend."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_dtend" corresponds="icalproperty_set_dtend" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The dtend time."/> - <comment>Set the dtend time for the #ICalProperty.</comment> + <comment>Sets the dtend time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_dtend" corresponds="icalproperty_get_dtend" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the dtend time of #ICalProperty."/> - <comment>Get the dtend time of #ICalProperty.</comment> + <comment>Gets the dtend time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_dtstamp" corresponds="icalproperty_new_dtstamp" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of dtstamp."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_dtstamp" corresponds="icalproperty_set_dtstamp" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The dtstamp time."/> - <comment>Set the dtstamp time for the #ICalProperty.</comment> + <comment>Sets the dtstamp time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_dtstamp" corresponds="icalproperty_get_dtstamp" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the dtstamp time of #ICalProperty."/> - <comment>Get the dtstamp time of #ICalProperty.</comment> + <comment>Gets the dtstamp time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_dtstart" corresponds="icalproperty_new_dtstart" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of dtstart."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_dtstart" corresponds="icalproperty_set_dtstart" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The dtstart time."/> - <comment>Set the dtstart time for the #ICalProperty.</comment> + <comment>Sets the dtstart time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_dtstart" corresponds="icalproperty_get_dtstart" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the dtstart time of #ICalProperty."/> - <comment>Get the dtstart time of #ICalProperty.</comment> + <comment>Gets the dtstart time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_due" corresponds="icalproperty_new_due" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of due."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_due" corresponds="icalproperty_set_due" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The due time."/> - <comment>Set the due time for the #ICalProperty.</comment> + <comment>Sets the due time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_due" corresponds="icalproperty_get_due" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the due time of #ICalProperty."/> - <comment>Get the due time of #ICalProperty.</comment> + <comment>Gets the due time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_duration" corresponds="icalproperty_new_duration" kind="constructor" since="1.0"> <parameter type="ICalDuration *" name="v" comment="The duration."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_duration" corresponds="icalproperty_set_duration" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalDuration *" name="v" comment="The duration."/> - <comment>Set the duration for the #ICalProperty.</comment> + <comment>Sets the duration for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_duration" corresponds="icalproperty_get_duration" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalDuration *" annotation="transfer full" comment="Get the duration of #ICalProperty."/> - <comment>Get the duration of #ICalProperty.</comment> + <comment>Gets the duration of #ICalProperty.</comment> </method> <method name="i_cal_property_new_estimatedduration" corresponds="icalproperty_new_estimatedduration" kind="constructor" since="1.0"> <parameter type="ICalDuration *" name="v" comment="The estimatedduration."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_estimatedduration" corresponds="icalproperty_set_estimatedduration" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalDuration *" name="v" comment="The estimatedduration."/> - <comment>Set the estimatedduration for the #ICalProperty.</comment> + <comment>Sets the estimatedduration for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_estimatedduration" corresponds="icalproperty_get_estimatedduration" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalDuration *" annotation="transfer full" comment="Get the estimatedduration of #ICalProperty."/> - <comment>Get the estimatedduration of #ICalProperty.</comment> + <comment>Gets the estimatedduration of #ICalProperty.</comment> </method> <method name="i_cal_property_new_exdate" corresponds="icalproperty_new_exdate" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of exdate."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_exdate" corresponds="icalproperty_set_exdate" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The exdate time."/> - <comment>Set the exdate time for the #ICalProperty.</comment> + <comment>Sets the exdate time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_exdate" corresponds="icalproperty_get_exdate" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the exdate time of #ICalProperty."/> - <comment>Get the exdate time of #ICalProperty.</comment> + <comment>Gets the exdate time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_expand" corresponds="icalproperty_new_expand" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The expand."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_expand" corresponds="icalproperty_set_expand" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The expand."/> - <comment>Set the expand for the #ICalProperty.</comment> + <comment>Sets the expand for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_expand" corresponds="icalproperty_get_expand" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the expand of #ICalProperty."/> - <comment>Get the expand of #ICalProperty.</comment> + <comment>Gets the expand of #ICalProperty.</comment> </method> <method name="i_cal_property_new_exrule" corresponds="icalproperty_new_exrule" kind="constructor" since="1.0"> <parameter type="ICalRecurrence *" name="v" comment="The exrule recurrence type."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_exrule" corresponds="icalproperty_set_exrule" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalRecurrence *" name="v" comment="The exrule recurrence type."/> - <comment>Set the exrule time for the #ICalProperty.</comment> + <comment>Sets the exrule time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_exrule" corresponds="icalproperty_get_exrule" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalRecurrence *" annotation="transfer full" comment="Get the exrule recurrence type of #ICalProperty."/> - <comment>Get the exrule recurrence type of #ICalProperty.</comment> + <comment>Gets the exrule recurrence type of #ICalProperty.</comment> </method> <method name="i_cal_property_new_freebusy" corresponds="icalproperty_new_freebusy" kind="constructor" since="1.0"> <parameter type="ICalPeriod *" name="v" comment="The freebusy period type."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_freebusy" corresponds="icalproperty_set_freebusy" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPeriod *" name="v" comment="The freebusy period type."/> - <comment>Set the freebusy time for the #ICalProperty.</comment> + <comment>Sets the freebusy time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_freebusy" corresponds="icalproperty_get_freebusy" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPeriod *" annotation="transfer full" comment="Get the freebusy period type of #ICalProperty."/> - <comment>Get the freebusy period type of #ICalProperty.</comment> + <comment>Gets the freebusy period type of #ICalProperty.</comment> </method> <method name="i_cal_property_new_geo" corresponds="icalproperty_new_geo" kind="constructor" since="1.0"> <parameter type="ICalGeo *" name="v" comment="The geo type."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_geo" corresponds="icalproperty_set_geo" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalGeo *" name="v" comment="The geo type."/> - <comment>Set the geo for the #ICalProperty.</comment> + <comment>Sets the geo for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_geo" corresponds="icalproperty_get_geo" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalGeo *" annotation="transfer full" comment="Get the geo type of #ICalProperty."/> - <comment>Get the geo type of #ICalProperty.</comment> + <comment>Gets the geo type of #ICalProperty.</comment> </method> <method name="i_cal_property_new_grant" corresponds="icalproperty_new_grant" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The grant."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_grant" corresponds="icalproperty_set_grant" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The grant."/> - <comment>Set the grant for the #ICalProperty.</comment> + <comment>Sets the grant for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_grant" corresponds="icalproperty_get_grant" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the grant of #ICalProperty."/> - <comment>Get the grant of #ICalProperty.</comment> + <comment>Gets the grant of #ICalProperty.</comment> </method> <method name="i_cal_property_new_itipversion" corresponds="icalproperty_new_itipversion" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The itipversion."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_itipversion" corresponds="icalproperty_set_itipversion" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The itipversion."/> - <comment>Set the itipversion for the #ICalProperty.</comment> + <comment>Sets the itipversion for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_itipversion" corresponds="icalproperty_get_itipversion" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the itipversion of #ICalProperty."/> - <comment>Get the itipversion of #ICalProperty.</comment> + <comment>Gets the itipversion of #ICalProperty.</comment> </method> <method name="i_cal_property_new_lastmodified" corresponds="icalproperty_new_lastmodified" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of lastmodified."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_lastmodified" corresponds="icalproperty_set_lastmodified" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The lastmodified time."/> - <comment>Set the lastmodified time for the #ICalProperty.</comment> + <comment>Sets the lastmodified time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_lastmodified" corresponds="icalproperty_get_lastmodified" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the lastmodified time of #ICalProperty."/> - <comment>Get the lastmodified time of #ICalProperty.</comment> + <comment>Gets the lastmodified time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_location" corresponds="icalproperty_new_location" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The location."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_location" corresponds="icalproperty_set_location" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The location."/> - <comment>Set the location for the #ICalProperty.</comment> + <comment>Sets the location for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_location" corresponds="icalproperty_get_location" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the location of #ICalProperty."/> - <comment>Get the location of #ICalProperty.</comment> + <comment>Gets the location of #ICalProperty.</comment> </method> <method name="i_cal_property_new_maxcomponentsize" corresponds="icalproperty_new_maxcomponentsize" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The maxcomponentsize."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_maxcomponentsize" corresponds="icalproperty_set_maxcomponentsize" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The maxcomponentsize."/> - <comment>Set the maxcomponentsize for the #ICalProperty.</comment> + <comment>Sets the maxcomponentsize for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_maxcomponentsize" corresponds="icalproperty_get_maxcomponentsize" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the maxcomponentsize of #ICalProperty."/> - <comment>Get the maxcomponentsize of #ICalProperty.</comment> + <comment>Gets the maxcomponentsize of #ICalProperty.</comment> </method> <method name="i_cal_property_new_maxdate" corresponds="icalproperty_new_maxdate" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of maxdate."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_maxdate" corresponds="icalproperty_set_maxdate" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The maxdate time."/> - <comment>Set the maxdate time for the #ICalProperty.</comment> + <comment>Sets the maxdate time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_maxdate" corresponds="icalproperty_get_maxdate" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the maxdate time of #ICalProperty."/> - <comment>Get the maxdate time of #ICalProperty.</comment> + <comment>Gets the maxdate time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_maxresults" corresponds="icalproperty_new_maxresults" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The maxresults."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_maxresults" corresponds="icalproperty_set_maxresults" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The maxresults."/> - <comment>Set the maxresults for the #ICalProperty.</comment> + <comment>Sets the maxresults for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_maxresults" corresponds="icalproperty_get_maxresults" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the maxresults of #ICalProperty."/> - <comment>Get the maxresults of #ICalProperty.</comment> + <comment>Gets the maxresults of #ICalProperty.</comment> </method> <method name="i_cal_property_new_maxresultssize" corresponds="icalproperty_new_maxresultssize" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The maxresultssize."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_maxresultssize" corresponds="icalproperty_set_maxresultssize" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The maxresultssize."/> - <comment>Set the maxresultssize for the #ICalProperty.</comment> + <comment>Sets the maxresultssize for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_maxresultssize" corresponds="icalproperty_get_maxresultssize" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the maxresultssize of #ICalProperty."/> - <comment>Get the maxresultssize of #ICalProperty.</comment> + <comment>Gets the maxresultssize of #ICalProperty.</comment> </method> <method name="i_cal_property_new_method" corresponds="icalproperty_new_method" kind="constructor" since="1.0"> <parameter type="ICalPropertyMethod" name="v" comment="The method."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_method" corresponds="icalproperty_set_method" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyMethod" name="v" comment="The method."/> - <comment>Set the method for the #ICalProperty.</comment> + <comment>Sets the method for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_method" corresponds="icalproperty_get_method" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyMethod" comment="Get the method of #ICalProperty."/> - <comment>Get the method of #ICalProperty.</comment> + <comment>Gets the method of #ICalProperty.</comment> </method> <method name="i_cal_property_new_mindate" corresponds="icalproperty_new_mindate" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of mindate."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_mindate" corresponds="icalproperty_set_mindate" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The mindate time."/> - <comment>Set the mindate time for the #ICalProperty.</comment> + <comment>Sets the mindate time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_mindate" corresponds="icalproperty_get_mindate" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the mindate time of #ICalProperty."/> - <comment>Get the mindate time of #ICalProperty.</comment> + <comment>Gets the mindate time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_multipart" corresponds="icalproperty_new_multipart" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The multipart."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_multipart" corresponds="icalproperty_set_multipart" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The multipart."/> - <comment>Set the multipart for the #ICalProperty.</comment> + <comment>Sets the multipart for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_multipart" corresponds="icalproperty_get_multipart" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the multipart of #ICalProperty."/> - <comment>Get the multipart of #ICalProperty.</comment> + <comment>Gets the multipart of #ICalProperty.</comment> </method> <method name="i_cal_property_new_name" corresponds="icalproperty_new_name" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The name."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_name" corresponds="icalproperty_set_name" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The name."/> - <comment>Set the name for the #ICalProperty.</comment> + <comment>Sets the name for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_name" corresponds="icalproperty_get_name" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the name of #ICalProperty."/> - <comment>Get the name of #ICalProperty.</comment> + <comment>Gets the name of #ICalProperty.</comment> </method> <method name="i_cal_property_new_organizer" corresponds="icalproperty_new_organizer" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The organizer."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_organizer" corresponds="icalproperty_set_organizer" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The organizer."/> - <comment>Set the organizer for the #ICalProperty.</comment> + <comment>Sets the organizer for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_organizer" corresponds="icalproperty_get_organizer" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the organizer of #ICalProperty."/> - <comment>Get the organizer of #ICalProperty.</comment> + <comment>Gets the organizer of #ICalProperty.</comment> </method> <method name="i_cal_property_new_owner" corresponds="icalproperty_new_owner" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The owner."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_owner" corresponds="icalproperty_set_owner" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The owner."/> - <comment>Set the owner for the #ICalProperty.</comment> + <comment>Sets the owner for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_owner" corresponds="icalproperty_get_owner" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the owner of #ICalProperty."/> - <comment>Get the owner of #ICalProperty.</comment> + <comment>Gets the owner of #ICalProperty.</comment> </method> <method name="i_cal_property_new_percentcomplete" corresponds="icalproperty_new_percentcomplete" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The percentcomplete."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_percentcomplete" corresponds="icalproperty_set_percentcomplete" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The percentcomplete."/> - <comment>Set the percentcomplete for the #ICalProperty.</comment> + <comment>Sets the percentcomplete for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_percentcomplete" corresponds="icalproperty_get_percentcomplete" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the percentcomplete of #ICalProperty."/> - <comment>Get the percentcomplete of #ICalProperty.</comment> + <comment>Gets the percentcomplete of #ICalProperty.</comment> </method> <method name="i_cal_property_new_permission" corresponds="icalproperty_new_permission" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The permission."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_permission" corresponds="icalproperty_set_permission" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The permission."/> - <comment>Set the permission for the #ICalProperty.</comment> + <comment>Sets the permission for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_permission" corresponds="icalproperty_get_permission" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the permission of #ICalProperty."/> - <comment>Get the permission of #ICalProperty.</comment> + <comment>Gets the permission of #ICalProperty.</comment> </method> <method name="i_cal_property_new_pollcompletion" corresponds="icalproperty_new_pollcompletion" kind="constructor" since="1.0"> <parameter type="ICalPropertyPollcompletion" name="v" comment="The pollcompletion."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_pollcompletion" corresponds="icalproperty_set_pollcompletion" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyPollcompletion" name="v" comment="The pollcompletion."/> - <comment>Set the pollcompletion for the #ICalProperty.</comment> + <comment>Sets the pollcompletion for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_pollcompletion" corresponds="icalproperty_get_pollcompletion" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyPollcompletion" comment="Get the pollcompletion of #ICalProperty."/> - <comment>Get the pollcompletion of #ICalProperty.</comment> + <comment>Gets the pollcompletion of #ICalProperty.</comment> </method> <method name="i_cal_property_new_pollitemid" corresponds="icalproperty_new_pollitemid" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The pollitemid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_pollitemid" corresponds="icalproperty_set_pollitemid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The pollitemid."/> - <comment>Set the pollitemid for the #ICalProperty.</comment> + <comment>Sets the pollitemid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_pollitemid" corresponds="icalproperty_get_pollitemid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the pollitemid of #ICalProperty."/> - <comment>Get the pollitemid of #ICalProperty.</comment> + <comment>Gets the pollitemid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_pollmode" corresponds="icalproperty_new_pollmode" kind="constructor" since="1.0"> <parameter type="ICalPropertyPollmode" name="v" comment="The pollmode."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_pollmode" corresponds="icalproperty_set_pollmode" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyPollmode" name="v" comment="The pollmode."/> - <comment>Set the pollmode for the #ICalProperty.</comment> + <comment>Sets the pollmode for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_pollmode" corresponds="icalproperty_get_pollmode" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyPollmode" comment="Get the pollmode of #ICalProperty."/> - <comment>Get the pollmode of #ICalProperty.</comment> + <comment>Gets the pollmode of #ICalProperty.</comment> </method> <method name="i_cal_property_new_pollproperties" corresponds="icalproperty_new_pollproperties" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The pollproperties."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_pollproperties" corresponds="icalproperty_set_pollproperties" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The pollproperties."/> - <comment>Set the pollproperties for the #ICalProperty.</comment> + <comment>Sets the pollproperties for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_pollproperties" corresponds="icalproperty_get_pollproperties" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" comment="Get the pollproperties of #ICalProperty."/> - <comment>Get the pollproperties of #ICalProperty.</comment> + <comment>Gets the pollproperties of #ICalProperty.</comment> </method> <method name="i_cal_property_new_pollwinner" corresponds="icalproperty_new_pollwinner" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The pollwinner."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_pollwinner" corresponds="icalproperty_set_pollwinner" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The pollwinner."/> - <comment>Set the pollwinner for the #ICalProperty.</comment> + <comment>Sets the pollwinner for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_pollwinner" corresponds="icalproperty_get_pollwinner" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the pollwinner of #ICalProperty."/> - <comment>Get the pollwinner of #ICalProperty.</comment> + <comment>Gets the pollwinner of #ICalProperty.</comment> </method> <method name="i_cal_property_new_priority" corresponds="icalproperty_new_priority" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The priority."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_priority" corresponds="icalproperty_set_priority" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The priority."/> - <comment>Set the priority for the #ICalProperty.</comment> + <comment>Sets the priority for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_priority" corresponds="icalproperty_get_priority" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the priority of #ICalProperty."/> - <comment>Get the priority of #ICalProperty.</comment> + <comment>Gets the priority of #ICalProperty.</comment> </method> <method name="i_cal_property_new_prodid" corresponds="icalproperty_new_prodid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The prodid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_prodid" corresponds="icalproperty_set_prodid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The prodid."/> - <comment>Set the prodid for the #ICalProperty.</comment> + <comment>Sets the prodid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_prodid" corresponds="icalproperty_get_prodid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the prodid of #ICalProperty."/> - <comment>Get the prodid of #ICalProperty.</comment> + <comment>Gets the prodid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_query" corresponds="icalproperty_new_query" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The query."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_query" corresponds="icalproperty_set_query" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The query."/> - <comment>Set the query for the #ICalProperty.</comment> + <comment>Sets the query for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_query" corresponds="icalproperty_get_query" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the query of #ICalProperty."/> - <comment>Get the query of #ICalProperty.</comment> + <comment>Gets the query of #ICalProperty.</comment> </method> <method name="i_cal_property_new_querylevel" corresponds="icalproperty_new_querylevel" kind="constructor" since="1.0"> <parameter type="ICalPropertyQuerylevel" name="v" comment="The querylevel."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_querylevel" corresponds="icalproperty_set_querylevel" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyQuerylevel" name="v" comment="The querylevel."/> - <comment>Set the querylevel for the #ICalProperty.</comment> + <comment>Sets the querylevel for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_querylevel" corresponds="icalproperty_get_querylevel" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyQuerylevel" comment="Get the querylevel of #ICalProperty."/> - <comment>Get the querylevel of #ICalProperty.</comment> + <comment>Gets the querylevel of #ICalProperty.</comment> </method> <method name="i_cal_property_new_queryid" corresponds="icalproperty_new_queryid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The queryid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_queryid" corresponds="icalproperty_set_queryid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The queryid."/> - <comment>Set the queryid for the #ICalProperty.</comment> + <comment>Sets the queryid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_queryid" corresponds="icalproperty_get_queryid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the queryid of #ICalProperty."/> - <comment>Get the queryid of #ICalProperty.</comment> + <comment>Gets the queryid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_queryname" corresponds="icalproperty_new_queryname" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The queryname."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_queryname" corresponds="icalproperty_set_queryname" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The queryname."/> - <comment>Set the queryname for the #ICalProperty.</comment> + <comment>Sets the queryname for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_queryname" corresponds="icalproperty_get_queryname" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the queryname of #ICalProperty."/> - <comment>Get the queryname of #ICalProperty.</comment> + <comment>Gets the queryname of #ICalProperty.</comment> </method> <method name="i_cal_property_new_rdate" corresponds="icalproperty_new_rdate" kind="constructor" since="1.0"> <parameter type="ICalDatetimeperiod *" name="v" comment="The rdate."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_rdate" corresponds="icalproperty_set_rdate" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalDatetimeperiod *" name="v" comment="The rdate."/> - <comment>Set the rdate for the #ICalProperty.</comment> + <comment>Sets the rdate for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_rdate" corresponds="icalproperty_get_rdate" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalDatetimeperiod *" annotation="transfer full" comment="Get the rdate of #ICalProperty."/> - <comment>Get the rdate of #ICalProperty.</comment> + <comment>Gets the rdate of #ICalProperty.</comment> </method> <method name="i_cal_property_new_recuraccepted" corresponds="icalproperty_new_recuraccepted" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The recuraccepted."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_recuraccepted" corresponds="icalproperty_set_recuraccepted" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The recuraccepted."/> - <comment>Set the recuraccepted for the #ICalProperty.</comment> + <comment>Sets the recuraccepted for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_recuraccepted" corresponds="icalproperty_get_recuraccepted" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the recuraccepted of #ICalProperty."/> - <comment>Get the recuraccepted of #ICalProperty.</comment> + <comment>Gets the recuraccepted of #ICalProperty.</comment> </method> <method name="i_cal_property_new_recurexpand" corresponds="icalproperty_new_recurexpand" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The recurexpand."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_recurexpand" corresponds="icalproperty_set_recurexpand" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The recurexpand."/> - <comment>Set the recurexpand for the #ICalProperty.</comment> + <comment>Sets the recurexpand for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_recurexpand" corresponds="icalproperty_get_recurexpand" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the recurexpand of #ICalProperty."/> - <comment>Get the recurexpand of #ICalProperty.</comment> + <comment>Gets the recurexpand of #ICalProperty.</comment> </method> <method name="i_cal_property_new_recurlimit" corresponds="icalproperty_new_recurlimit" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The recurlimit."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_recurlimit" corresponds="icalproperty_set_recurlimit" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The recurlimit."/> - <comment>Set the recurlimit for the #ICalProperty.</comment> + <comment>Sets the recurlimit for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_recurlimit" corresponds="icalproperty_get_recurlimit" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the recurlimit of #ICalProperty."/> - <comment>Get the recurlimit of #ICalProperty.</comment> + <comment>Gets the recurlimit of #ICalProperty.</comment> </method> <method name="i_cal_property_new_recurrenceid" corresponds="icalproperty_new_recurrenceid" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The time of recurrenceid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_recurrenceid" corresponds="icalproperty_set_recurrenceid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The recurrenceid time."/> - <comment>Set the recurrenceid time for the #ICalProperty.</comment> + <comment>Sets the recurrenceid time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_recurrenceid" corresponds="icalproperty_get_recurrenceid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the recurrenceid time of #ICalProperty."/> - <comment>Get the recurrenceid time of #ICalProperty.</comment> + <comment>Gets the recurrenceid time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_relatedto" corresponds="icalproperty_new_relatedto" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The relatedto."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_relatedto" corresponds="icalproperty_set_relatedto" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The relatedto."/> - <comment>Set the relatedto for the #ICalProperty.</comment> + <comment>Sets the relatedto for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_relatedto" corresponds="icalproperty_get_relatedto" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the relatedto of #ICalProperty."/> - <comment>Get the relatedto of #ICalProperty.</comment> + <comment>Gets the relatedto of #ICalProperty.</comment> </method> <method name="i_cal_property_new_relcalid" corresponds="icalproperty_new_relcalid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The relcalid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_relcalid" corresponds="icalproperty_set_relcalid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The relcalid."/> - <comment>Set the relcalid for the #ICalProperty.</comment> + <comment>Sets the relcalid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_relcalid" corresponds="icalproperty_get_relcalid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the relcalid of #ICalProperty."/> - <comment>Get the relcalid of #ICalProperty.</comment> + <comment>Gets the relcalid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_repeat" corresponds="icalproperty_new_repeat" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The repeat."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_repeat" corresponds="icalproperty_set_repeat" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The repeat."/> - <comment>Set the repeat for the #ICalProperty.</comment> + <comment>Sets the repeat for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_repeat" corresponds="icalproperty_get_repeat" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the repeat of #ICalProperty."/> - <comment>Get the repeat of #ICalProperty.</comment> + <comment>Gets the repeat of #ICalProperty.</comment> </method> <method name="i_cal_property_new_replyurl" corresponds="icalproperty_new_replyurl" kind="constructor" since="2.0"> <parameter type="const gchar *" name="v" comment="The replyurl."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_replyurl" corresponds="icalproperty_set_replyurl" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The replyurl."/> - <comment>Set the replyurl for the #ICalProperty.</comment> + <comment>Sets the replyurl for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_replyurl" corresponds="icalproperty_get_replyurl" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the replyurl of #ICalProperty."/> - <comment>Get the replyurl of #ICalProperty.</comment> + <comment>Gets the replyurl of #ICalProperty.</comment> </method> <method name="i_cal_property_new_requeststatus" corresponds="icalproperty_new_requeststatus" kind="constructor" since="1.0"> <parameter type="ICalReqstat *" name="v" comment="The requeststatus."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_requeststatus" corresponds="icalproperty_set_requeststatus" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalReqstat *" name="v" comment="The requeststatus."/> - <comment>Set the requeststatus for the #ICalProperty.</comment> + <comment>Sets the requeststatus for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_requeststatus" corresponds="icalproperty_get_requeststatus" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalReqstat *" annotation="transfer full" comment="Get the requeststatus of #ICalProperty."/> - <comment>Get the requeststatus of #ICalProperty.</comment> + <comment>Gets the requeststatus of #ICalProperty.</comment> </method> <method name="i_cal_property_new_resources" corresponds="icalproperty_new_resources" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The resources."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_resources" corresponds="icalproperty_set_resources" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The resources."/> - <comment>Set the resources for the #ICalProperty.</comment> + <comment>Sets the resources for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_resources" corresponds="icalproperty_get_resources" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the resources of #ICalProperty."/> - <comment>Get the resources of #ICalProperty.</comment> + <comment>Gets the resources of #ICalProperty.</comment> </method> <method name="i_cal_property_new_response" corresponds="icalproperty_new_response" kind="constructor" since="2.0"> <parameter type="gint" name="v" comment="The response."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_response" corresponds="icalproperty_set_response" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The response."/> - <comment>Set the response for the #ICalProperty.</comment> + <comment>Sets the response for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_response" corresponds="icalproperty_get_response" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the response of #ICalProperty."/> - <comment>Get the response of #ICalProperty.</comment> + <comment>Gets the response of #ICalProperty.</comment> </method> <method name="i_cal_property_new_restriction" corresponds="icalproperty_new_restriction" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The restriction."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_restriction" corresponds="icalproperty_set_restriction" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The restriction."/> - <comment>Set the restriction for the #ICalProperty.</comment> + <comment>Sets the restriction for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_restriction" corresponds="icalproperty_get_restriction" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the restriction of #ICalProperty."/> - <comment>Get the restriction of #ICalProperty.</comment> + <comment>Gets the restriction of #ICalProperty.</comment> </method> <method name="i_cal_property_new_rrule" corresponds="icalproperty_new_rrule" kind="constructor" since="1.0"> <parameter type="ICalRecurrence *" name="v" comment="The rrule recurrence type."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_rrule" corresponds="icalproperty_set_rrule" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalRecurrence *" name="v" comment="The rrule recurrence type."/> - <comment>Set the rrule for the #ICalProperty.</comment> + <comment>Sets the rrule for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_rrule" corresponds="icalproperty_get_rrule" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalRecurrence *" annotation="transfer full" comment="Get the rrule recurrence type of #ICalProperty."/> - <comment>Get the rrule recurrence type of #ICalProperty.</comment> + <comment>Gets the rrule recurrence type of #ICalProperty.</comment> </method> <method name="i_cal_property_new_scope" corresponds="icalproperty_new_scope" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The scope."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_scope" corresponds="icalproperty_set_scope" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The scope."/> - <comment>Set the scope for the #ICalProperty.</comment> + <comment>Sets the scope for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_scope" corresponds="icalproperty_get_scope" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the scope of #ICalProperty."/> - <comment>Get the scope of #ICalProperty.</comment> + <comment>Gets the scope of #ICalProperty.</comment> </method> <method name="i_cal_property_new_sequence" corresponds="icalproperty_new_sequence" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The sequence."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_sequence" corresponds="icalproperty_set_sequence" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The sequence."/> - <comment>Set the sequence for the #ICalProperty.</comment> + <comment>Sets the sequence for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_sequence" corresponds="icalproperty_get_sequence" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the sequence of #ICalProperty."/> - <comment>Get the sequence of #ICalProperty.</comment> + <comment>Gets the sequence of #ICalProperty.</comment> </method> <method name="i_cal_property_new_status" corresponds="icalproperty_new_status" kind="constructor" since="1.0"> <parameter type="ICalPropertyStatus" name="v" comment="The status."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_status" corresponds="icalproperty_set_status" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyStatus" name="v" comment="The status."/> - <comment>Set the status for the #ICalProperty.</comment> + <comment>Sets the status for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_status" corresponds="icalproperty_get_status" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyStatus" comment="Get the status of #ICalProperty."/> - <comment>Get the status of #ICalProperty.</comment> + <comment>Gets the status of #ICalProperty.</comment> </method> <method name="i_cal_property_new_storesexpanded" corresponds="icalproperty_new_storesexpanded" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The storesexpanded."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_storesexpanded" corresponds="icalproperty_set_storesexpanded" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The storesexpanded."/> - <comment>Set the storesexpanded for the #ICalProperty.</comment> + <comment>Sets the storesexpanded for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_storesexpanded" corresponds="icalproperty_get_storesexpanded" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the storesexpanded of #ICalProperty."/> - <comment>Get the storesexpanded of #ICalProperty.</comment> + <comment>Gets the storesexpanded of #ICalProperty.</comment> </method> <method name="i_cal_property_new_summary" corresponds="icalproperty_new_summary" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The summary."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_summary" corresponds="icalproperty_set_summary" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The summary."/> - <comment>Set the summary for the #ICalProperty.</comment> + <comment>Sets the summary for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_summary" corresponds="icalproperty_get_summary" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the summary of #ICalProperty."/> - <comment>Get the summary of #ICalProperty.</comment> + <comment>Gets the summary of #ICalProperty.</comment> </method> <method name="i_cal_property_new_target" corresponds="icalproperty_new_target" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The target."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_target" corresponds="icalproperty_set_target" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The target."/> - <comment>Set the target for the #ICalProperty.</comment> + <comment>Sets the target for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_target" corresponds="icalproperty_get_target" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the target of #ICalProperty."/> - <comment>Get the target of #ICalProperty.</comment> + <comment>Gets the target of #ICalProperty.</comment> </method> <method name="i_cal_property_new_taskmode" corresponds="icalproperty_new_taskmode" kind="constructor" since="2.0"> <parameter type="ICalPropertyTaskmode" name="v" comment="The taskmode."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_taskmode" corresponds="icalproperty_set_taskmode" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyTaskmode" name="v" comment="The taskmode."/> - <comment>Set the taskmode for the #ICalProperty.</comment> + <comment>Sets the taskmode for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_taskmode" corresponds="icalproperty_get_taskmode" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyTaskmode" comment="Get the taskmode of #ICalProperty."/> - <comment>Get the taskmode of #ICalProperty.</comment> + <comment>Gets the taskmode of #ICalProperty.</comment> </method> <method name="i_cal_property_new_transp" corresponds="icalproperty_new_transp" kind="constructor" since="1.0"> <parameter type="ICalPropertyTransp" name="v" comment="The transp."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_transp" corresponds="icalproperty_set_transp" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyTransp" name="v" comment="The transp."/> - <comment>Set the transp for the #ICalProperty.</comment> + <comment>Sets the transp for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_transp" corresponds="icalproperty_get_transp" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyTransp" comment="Get the transp of #ICalProperty."/> - <comment>Get the transp of #ICalProperty.</comment> + <comment>Gets the transp of #ICalProperty.</comment> </method> <method name="i_cal_property_new_trigger" corresponds="icalproperty_new_trigger" kind="constructor" since="1.0"> <parameter type="ICalTrigger *" name="v" comment="The trigger period type."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_trigger" corresponds="icalproperty_set_trigger" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTrigger *" name="v" comment="The trigger period type."/> - <comment>Set the trigger time for the #ICalProperty.</comment> + <comment>Sets the trigger time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_trigger" corresponds="icalproperty_get_trigger" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTrigger *" annotation="transfer full" comment="Get the trigger period type of #ICalProperty."/> - <comment>Get the trigger period type of #ICalProperty.</comment> + <comment>Gets the trigger period type of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzid" corresponds="icalproperty_new_tzid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The tzid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzid" corresponds="icalproperty_set_tzid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The tzid."/> - <comment>Set the tzid for the #ICalProperty.</comment> + <comment>Sets the tzid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzid" corresponds="icalproperty_get_tzid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the tzid of #ICalProperty."/> - <comment>Get the tzid of #ICalProperty.</comment> + <comment>Gets the tzid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzidaliasof" corresponds="icalproperty_new_tzidaliasof" kind="constructor" since="2.0"> <parameter type="const gchar *" name="v" comment="The tzidaliasof."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzidaliasof" corresponds="icalproperty_set_tzidaliasof" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The tzidaliasof."/> - <comment>Set the tzidaliasof for the #ICalProperty.</comment> + <comment>Sets the tzidaliasof for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzidaliasof" corresponds="icalproperty_get_tzidaliasof" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the tzidaliasof of #ICalProperty."/> - <comment>Get the tzidaliasof of #ICalProperty.</comment> + <comment>Gets the tzidaliasof of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzname" corresponds="icalproperty_new_tzname" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The tzname."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzname" corresponds="icalproperty_set_tzname" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The tzname."/> - <comment>Set the tzname for the #ICalProperty.</comment> + <comment>Sets the tzname for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzname" corresponds="icalproperty_get_tzname" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the tzname of #ICalProperty."/> - <comment>Get the tzname of #ICalProperty.</comment> + <comment>Gets the tzname of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzoffsetfrom" corresponds="icalproperty_new_tzoffsetfrom" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The tzoffsetfrom."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzoffsetfrom" corresponds="icalproperty_set_tzoffsetfrom" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The tzoffsetfrom."/> - <comment>Set the tzoffsetfrom for the #ICalProperty.</comment> + <comment>Sets the tzoffsetfrom for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzoffsetfrom" corresponds="icalproperty_get_tzoffsetfrom" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the tzoffsetfrom of #ICalProperty."/> - <comment>Get the tzoffsetfrom of #ICalProperty.</comment> + <comment>Gets the tzoffsetfrom of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzoffsetto" corresponds="icalproperty_new_tzoffsetto" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The tzoffsetto."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzoffsetto" corresponds="icalproperty_set_tzoffsetto" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="gint" name="v" comment="The tzoffsetto."/> - <comment>Set the tzoffsetto for the #ICalProperty.</comment> + <comment>Sets the tzoffsetto for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzoffsetto" corresponds="icalproperty_get_tzoffsetto" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gint" comment="Get the tzoffsetto of #ICalProperty."/> - <comment>Get the tzoffsetto of #ICalProperty.</comment> + <comment>Gets the tzoffsetto of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzuntil" corresponds="icalproperty_new_tzuntil" kind="constructor" since="2.0"> <parameter type="ICalTime *" name="v" comment="The time of acknowledgement."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzuntil" corresponds="icalproperty_set_tzuntil" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalTime *" name="v" comment="The acknowledgement time."/> - <comment>Set the tzuntil time for the #ICalProperty.</comment> + <comment>Sets the tzuntil time for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzuntil" corresponds="icalproperty_get_tzuntil" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="Get the tzuntil time of #ICalProperty."/> - <comment>Get the tzuntil time of #ICalProperty.</comment> + <comment>Gets the tzuntil time of #ICalProperty.</comment> </method> <method name="i_cal_property_new_tzurl" corresponds="icalproperty_new_tzurl" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The tzurl."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_tzurl" corresponds="icalproperty_set_tzurl" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The tzurl."/> - <comment>Set the tzurl for the #ICalProperty.</comment> + <comment>Sets the tzurl for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_tzurl" corresponds="icalproperty_get_tzurl" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the tzurl of #ICalProperty."/> - <comment>Get the tzurl of #ICalProperty.</comment> + <comment>Gets the tzurl of #ICalProperty.</comment> </method> <method name="i_cal_property_new_uid" corresponds="icalproperty_new_uid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The uid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_uid" corresponds="icalproperty_set_uid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The uid."/> - <comment>Set the uid for the #ICalProperty.</comment> + <comment>Sets the uid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_uid" corresponds="icalproperty_get_uid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the uid of #ICalProperty."/> - <comment>Get the uid of #ICalProperty.</comment> + <comment>Gets the uid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_url" corresponds="icalproperty_new_url" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The url."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_url" corresponds="icalproperty_set_url" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The url."/> - <comment>Set the url for the #ICalProperty.</comment> + <comment>Sets the url for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_url" corresponds="icalproperty_get_url" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the url of #ICalProperty."/> - <comment>Get the url of #ICalProperty.</comment> + <comment>Gets the url of #ICalProperty.</comment> </method> <method name="i_cal_property_new_version" corresponds="icalproperty_new_version" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The version."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_version" corresponds="icalproperty_set_version" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The version."/> - <comment>Set the version for the #ICalProperty.</comment> + <comment>Sets the version for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_version" corresponds="icalproperty_get_version" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the version of #ICalProperty."/> - <comment>Get the version of #ICalProperty.</comment> + <comment>Gets the version of #ICalProperty.</comment> </method> <method name="i_cal_property_new_voter" corresponds="icalproperty_new_voter" kind="constructor" since="2.0"> <parameter type="const gchar *" name="v" comment="The voter."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_voter" corresponds="icalproperty_set_voter" kind="set" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The voter."/> - <comment>Set the voter for the #ICalProperty.</comment> + <comment>Sets the voter for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_voter" corresponds="icalproperty_get_voter" kind="get" since="2.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the voter of #ICalProperty."/> - <comment>Get the voter of #ICalProperty.</comment> + <comment>Gets the voter of #ICalProperty.</comment> </method> <method name="i_cal_property_new_x" corresponds="icalproperty_new_x" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The x."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_x" corresponds="icalproperty_set_x" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The x."/> - <comment>Set the x for the #ICalProperty.</comment> + <comment>Sets the x for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_x" corresponds="icalproperty_get_x" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the x of #ICalProperty."/> - <comment>Get the x of #ICalProperty.</comment> + <comment>Gets the x of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicclass" corresponds="icalproperty_new_xlicclass" kind="constructor" since="1.0"> <parameter type="ICalPropertyXlicclass" name="v" comment="The xlicclass."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicclass" corresponds="icalproperty_set_xlicclass" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="ICalPropertyXlicclass" name="v" comment="The xlicclass."/> - <comment>Set the xlicclass for the #ICalProperty.</comment> + <comment>Sets the xlicclass for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicclass" corresponds="icalproperty_get_xlicclass" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalPropertyXlicclass" comment="Get the xlicclass of #ICalProperty."/> - <comment>Get the xlicclass of #ICalProperty.</comment> + <comment>Gets the xlicclass of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicclustercount" corresponds="icalproperty_new_xlicclustercount" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicclustercount."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicclustercount" corresponds="icalproperty_set_xlicclustercount" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicclustercount."/> - <comment>Set the xlicclustercount for the #ICalProperty.</comment> + <comment>Sets the xlicclustercount for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicclustercount" corresponds="icalproperty_get_xlicclustercount" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicclustercount of #ICalProperty."/> - <comment>Get the xlicclustercount of #ICalProperty.</comment> + <comment>Gets the xlicclustercount of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicerror" corresponds="icalproperty_new_xlicerror" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicerror."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicerror" corresponds="icalproperty_set_xlicerror" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicerror."/> - <comment>Set the xlicerror for the #ICalProperty.</comment> + <comment>Sets the xlicerror for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicerror" corresponds="icalproperty_get_xlicerror" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicerror of #ICalProperty."/> - <comment>Get the xlicerror of #ICalProperty.</comment> + <comment>Gets the xlicerror of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicmimecharset" corresponds="icalproperty_new_xlicmimecharset" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicmimecharset."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicmimecharset" corresponds="icalproperty_set_xlicmimecharset" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicmimecharset."/> - <comment>Set the xlicmimecharset for the #ICalProperty.</comment> + <comment>Sets the xlicmimecharset for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicmimecharset" corresponds="icalproperty_get_xlicmimecharset" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicmimecharset of #ICalProperty."/> - <comment>Get the xlicmimecharset of #ICalProperty.</comment> + <comment>Gets the xlicmimecharset of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicmimecid" corresponds="icalproperty_new_xlicmimecid" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicmimecid."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicmimecid" corresponds="icalproperty_set_xlicmimecid" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicmimecid."/> - <comment>Set the xlicmimecid for the #ICalProperty.</comment> + <comment>Sets the xlicmimecid for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicmimecid" corresponds="icalproperty_get_xlicmimecid" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicmimecid of #ICalProperty."/> - <comment>Get the xlicmimecid of #ICalProperty.</comment> + <comment>Gets the xlicmimecid of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicmimecontenttype" corresponds="icalproperty_new_xlicmimecontenttype" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicmimecontenttype."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicmimecontenttype" corresponds="icalproperty_set_xlicmimecontenttype" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicmimecontenttype."/> - <comment>Set the xlicmimecontenttype for the #ICalProperty.</comment> + <comment>Sets the xlicmimecontenttype for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicmimecontenttype" corresponds="icalproperty_get_xlicmimecontenttype" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicmimecontenttype of #ICalProperty."/> - <comment>Get the xlicmimecontenttype of #ICalProperty.</comment> + <comment>Gets the xlicmimecontenttype of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicmimeencoding" corresponds="icalproperty_new_xlicmimeencoding" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicmimeencoding."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicmimeencoding" corresponds="icalproperty_set_xlicmimeencoding" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicmimeencoding."/> - <comment>Set the xlicmimeencoding for the #ICalProperty.</comment> + <comment>Sets the xlicmimeencoding for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicmimeencoding" corresponds="icalproperty_get_xlicmimeencoding" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicmimeencoding of #ICalProperty."/> - <comment>Get the xlicmimeencoding of #ICalProperty.</comment> + <comment>Gets the xlicmimeencoding of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicmimefilename" corresponds="icalproperty_new_xlicmimefilename" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicmimefilename."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicmimefilename" corresponds="icalproperty_set_xlicmimefilename" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicmimefilename."/> - <comment>Set the xlicmimefilename for the #ICalProperty.</comment> + <comment>Sets the xlicmimefilename for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicmimefilename" corresponds="icalproperty_get_xlicmimefilename" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicmimefilename of #ICalProperty."/> - <comment>Get the xlicmimefilename of #ICalProperty.</comment> + <comment>Gets the xlicmimefilename of #ICalProperty.</comment> </method> <method name="i_cal_property_new_xlicmimeoptinfo" corresponds="icalproperty_new_xlicmimeoptinfo" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The xlicmimeoptinfo."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly create #ICalProperty"/> - <comment xml:space="preserve">Create a new #ICalProperty.</comment> + <comment xml:space="preserve">Creates a new #ICalProperty.</comment> </method> <method name="i_cal_property_set_xlicmimeoptinfo" corresponds="icalproperty_set_xlicmimeoptinfo" kind="set" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set"/> <parameter type="const gchar *" name="v" comment="The xlicmimeoptinfo."/> - <comment>Set the xlicmimeoptinfo for the #ICalProperty.</comment> + <comment>Sets the xlicmimeoptinfo for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_xlicmimeoptinfo" corresponds="icalproperty_get_xlicmimeoptinfo" kind="get" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="const gchar *" annotation="transfer none" comment="Get the xlicmimeoptinfo of #ICalProperty."/> - <comment>Get the xlicmimeoptinfo of #ICalProperty.</comment> + <comment>Gets the xlicmimeoptinfo of #ICalProperty.</comment> </method> </structure> diff --git a/src/libical-glib/api/i-cal-derived-value.xml b/src/libical-glib/api/i-cal-derived-value.xml index 71581140..e244123c 100644 --- a/src/libical-glib/api/i-cal-derived-value.xml +++ b/src/libical-glib/api/i-cal-derived-value.xml @@ -201,122 +201,122 @@ <method name="i_cal_value_set_x" corresponds="icalvalue_set_x" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The x value."/> - <comment>Set the x in the #ICalValue.</comment> + <comment>Sets the x in the #ICalValue.</comment> </method> <method name="i_cal_value_new_x" corresponds="icalvalue_new_x" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The x value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type x.</comment> + <comment>Creates a new #ICalValue with the type x.</comment> </method> <method name="i_cal_value_get_x" corresponds="icalvalue_get_x" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The x within #ICalValue"/> - <comment>Get the x of #ICalValue.</comment> + <comment>Gets the x of #ICalValue.</comment> </method> <method name="i_cal_value_set_recur" corresponds="icalvalue_set_recur" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalRecurrence *" name="v" comment="The recur value."/> - <comment>Set the recur in the #ICalValue.</comment> + <comment>Sets the recur in the #ICalValue.</comment> </method> <method name="i_cal_value_new_recur" corresponds="icalvalue_new_recur" kind="constructor" since="1.0"> <parameter type="ICalRecurrence *" name="v" comment="The recur value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type recur.</comment> + <comment>Creates a new #ICalValue with the type recur.</comment> </method> <method name="i_cal_value_get_recur" corresponds="icalvalue_get_recur" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalRecurrence *" annotation="allow-none, transfer full" comment="The recur within #ICalValue"/> - <comment>Get the recur of #ICalValue.</comment> + <comment>Gets the recur of #ICalValue.</comment> </method> <method name="i_cal_value_set_trigger" corresponds="icalvalue_set_trigger" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalTrigger *" name="v" comment="The trigger value."/> - <comment>Set the trigger in the #ICalValue.</comment> + <comment>Sets the trigger in the #ICalValue.</comment> </method> <method name="i_cal_value_new_trigger" corresponds="icalvalue_new_trigger" kind="constructor" since="1.0"> <parameter type="ICalTrigger *" name="v" comment="The trigger value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type trigger.</comment> + <comment>Creates a new #ICalValue with the type trigger.</comment> </method> <method name="i_cal_value_get_trigger" corresponds="icalvalue_get_trigger" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalTrigger *" annotation="allow-none, transfer full" comment="The trigger within #ICalValue"/> - <comment>Get the trigger of #ICalValue.</comment> + <comment>Gets the trigger of #ICalValue.</comment> </method> <method name="i_cal_value_set_datetime" corresponds="icalvalue_set_datetime" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalTime *" name="v" comment="The datetime value."/> - <comment>Set the datetime in the #ICalValue.</comment> + <comment>Sets the datetime in the #ICalValue.</comment> </method> <method name="i_cal_value_new_datetime" corresponds="icalvalue_new_datetime" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The datetime value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type datetime.</comment> + <comment>Creates a new #ICalValue with the type datetime.</comment> </method> <method name="i_cal_value_get_datetime" corresponds="icalvalue_get_datetime" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalTime *" annotation="allow-none, transfer full" comment="The datetime within #ICalValue"/> - <comment>Get the datetime of #ICalValue.</comment> + <comment>Gets the datetime of #ICalValue.</comment> </method> <method name="i_cal_value_set_datetimedate" corresponds="icalvalue_set_datetimedate" kind="set" since="3.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalTime *" name="v" comment="The datetimedate (DATE-TIME or DATE) value."/> - <comment>Set the datetimedate (DATE-TIME or DATE) in the #ICalValue.</comment> + <comment>Sets the datetimedate (DATE-TIME or DATE) in the #ICalValue.</comment> </method> <method name="i_cal_value_new_datetimedate" corresponds="icalvalue_new_datetimedate" kind="constructor" since="3.0"> <parameter type="ICalTime *" name="v" comment="The DATE-TIME or DATE value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type datetimedate (DATE-TIME or DATE).</comment> + <comment>Creates a new #ICalValue with the type datetimedate (DATE-TIME or DATE).</comment> </method> <method name="i_cal_value_get_datetimedate" corresponds="icalvalue_get_datetimedate" kind="get" since="3.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalTime *" annotation="allow-none, transfer full" comment="The datetimedate within #ICalValue"/> - <comment>Get the datetimedate (DATE-TIME or DATE) of #ICalValue.</comment> + <comment>Gets the datetimedate (DATE-TIME or DATE) of #ICalValue.</comment> </method> <method name="i_cal_value_set_datetimeperiod" corresponds="icalvalue_set_datetimeperiod" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalDatetimeperiod *" name="v" comment="The datetimeperiod value."/> - <comment>Set the datetimeperiod in the #ICalValue.</comment> + <comment>Sets the datetimeperiod in the #ICalValue.</comment> </method> <method name="i_cal_value_new_datetimeperiod" corresponds="icalvalue_new_datetimeperiod" kind="constructor" since="1.0"> <parameter type="ICalDatetimeperiod *" name="v" comment="The datetimeperiod value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type datetimeperiod.</comment> + <comment>Creates a new #ICalValue with the type datetimeperiod.</comment> </method> <method name="i_cal_value_get_datetimeperiod" corresponds="icalvalue_get_datetimeperiod" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalDatetimeperiod *" annotation="allow-none, transfer full" comment="The datetimeperiod within #ICalValue"/> - <comment>Get the datetimeperiod of #ICalValue.</comment> + <comment>Gets the datetimeperiod of #ICalValue.</comment> </method> <method name="i_cal_value_set_geo" corresponds="icalvalue_set_geo" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalGeo *" name="v" comment="The geo value."/> - <comment>Set the geo in the #ICalValue.</comment> + <comment>Sets the geo in the #ICalValue.</comment> </method> <method name="i_cal_value_new_geo" corresponds="icalvalue_new_geo" kind="constructor" since="1.0"> <parameter type="ICalGeo *" name="v" comment="The geo value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type geo.</comment> + <comment>Creates a new #ICalValue with the type geo.</comment> </method> <method name="i_cal_value_get_geo" corresponds="icalvalue_get_geo" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalGeo *" annotation="allow-none, transfer full" comment="The geo within #ICalValue"/> - <comment>Get the geo of #ICalValue.</comment> + <comment>Gets the geo of #ICalValue.</comment> </method> <method name="i_cal_value_set_attach" corresponds="icalvalue_set_attach" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalAttach *" name="v" translator_argus="value" comment="The attach value."/> - <comment>Set the attach in the #ICalValue.</comment> + <comment>Sets the attach in the #ICalValue.</comment> </method> <method name="i_cal_value_new_attach" corresponds="icalvalue_new_attach" kind="constructor" since="1.0"> <parameter type="ICalAttach *" name="v" comment="The attach value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type attach.</comment> + <comment>Creates a new #ICalValue with the type attach.</comment> </method> <method name="i_cal_value_get_attach" corresponds="icalvalue_get_attach" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalAttach *" annotation="allow-none, transfer none" translator_argus="(GObject *)value" comment="The attach within #ICalValue"/> - <comment>Get the attach of #ICalValue.</comment> + <comment>Gets the attach of #ICalValue.</comment> </method> <method name="i_cal_value_reset_kind" corresponds="icalvalue_reset_kind" kind="other" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue's kind to be reset."/> @@ -325,406 +325,406 @@ <method name="i_cal_value_set_xlicclass" corresponds="icalvalue_set_xlicclass" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyXlicclass" name="v" comment="The xlicclass value."/> - <comment>Set the xlicclass in the #ICalValue.</comment> + <comment>Sets the xlicclass in the #ICalValue.</comment> </method> <method name="i_cal_value_new_xlicclass" corresponds="icalvalue_new_xlicclass" kind="constructor" since="1.0"> <parameter type="ICalPropertyXlicclass" name="v" comment="The xlicclass value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type xlicclass.</comment> + <comment>Creates a new #ICalValue with the type xlicclass.</comment> </method> <method name="i_cal_value_get_xlicclass" corresponds="icalvalue_get_xlicclass" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyXlicclass" comment="The xlicclass within #ICalValue"/> - <comment>Get the xlicclass of #ICalValue.</comment> + <comment>Gets the xlicclass of #ICalValue.</comment> </method> <method name="i_cal_value_set_boolean" corresponds="icalvalue_set_boolean" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="gint" name="v" comment="The boolean value."/> - <comment>Set the boolean in the #ICalValue.</comment> + <comment>Sets the boolean in the #ICalValue.</comment> </method> <method name="i_cal_value_new_boolean" corresponds="icalvalue_new_boolean" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The boolean value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type boolean.</comment> + <comment>Creates a new #ICalValue with the type boolean.</comment> </method> <method name="i_cal_value_get_boolean" corresponds="icalvalue_get_boolean" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="gint" comment="The boolean within #ICalValue"/> - <comment>Get the boolean of #ICalValue.</comment> + <comment>Gets the boolean of #ICalValue.</comment> </method> <method name="i_cal_value_set_busytype" corresponds="icalvalue_set_busytype" kind="set" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyBusytype" name="v" comment="The busytype value."/> - <comment>Set the busytype in the #ICalValue.</comment> + <comment>Sets the busytype in the #ICalValue.</comment> </method> <method name="i_cal_value_new_busytype" corresponds="icalvalue_new_busytype" kind="constructor" since="2.0"> <parameter type="ICalPropertyBusytype" name="v" comment="The busytype value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type busytype.</comment> + <comment>Creates a new #ICalValue with the type busytype.</comment> </method> <method name="i_cal_value_get_busytype" corresponds="icalvalue_get_busytype" kind="get" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyBusytype" comment="The busytype within #ICalValue"/> - <comment>Get the busytype of #ICalValue.</comment> + <comment>Gets the busytype of #ICalValue.</comment> </method> <method name="i_cal_value_set_pollcompletion" corresponds="icalvalue_set_pollcompletion" kind="set" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyPollcompletion" name="v" comment="The pollcompletion value."/> - <comment>Set the pollcompletion in the #ICalValue.</comment> + <comment>Sets the pollcompletion in the #ICalValue.</comment> </method> <method name="i_cal_value_new_pollcompletion" corresponds="icalvalue_new_pollcompletion" kind="constructor" since="2.0"> <parameter type="ICalPropertyPollcompletion" name="v" comment="The pollcompletion value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type pollcompletion.</comment> + <comment>Creates a new #ICalValue with the type pollcompletion.</comment> </method> <method name="i_cal_value_get_pollcompletion" corresponds="icalvalue_get_pollcompletion" kind="get" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyPollcompletion" comment="The pollcompletion within #ICalValue"/> - <comment>Get the pollcompletion of #ICalValue.</comment> + <comment>Gets the pollcompletion of #ICalValue.</comment> </method> <method name="i_cal_value_set_taskmode" corresponds="icalvalue_set_taskmode" kind="set" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyTaskmode" name="v" comment="The taskmode value."/> - <comment>Set the taskmode in the #ICalValue.</comment> + <comment>Sets the taskmode in the #ICalValue.</comment> </method> <method name="i_cal_value_new_taskmode" corresponds="icalvalue_new_taskmode" kind="constructor" since="2.0"> <parameter type="ICalPropertyTaskmode" name="v" comment="The taskmode value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type taskmode.</comment> + <comment>Creates a new #ICalValue with the type taskmode.</comment> </method> <method name="i_cal_value_get_taskmode" corresponds="icalvalue_get_taskmode" kind="get" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyTaskmode" comment="The taskmode within #ICalValue"/> - <comment>Get the taskmode of #ICalValue.</comment> + <comment>Gets the taskmode of #ICalValue.</comment> </method> <method name="i_cal_value_set_pollmode" corresponds="icalvalue_set_pollmode" kind="set" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyPollmode" name="v" comment="The pollmode value."/> - <comment>Set the pollmode in the #ICalValue.</comment> + <comment>Sets the pollmode in the #ICalValue.</comment> </method> <method name="i_cal_value_new_pollmode" corresponds="icalvalue_new_pollmode" kind="constructor" since="2.0"> <parameter type="ICalPropertyPollmode" name="v" comment="The pollmode value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type pollmode.</comment> + <comment>Creates a new #ICalValue with the type pollmode.</comment> </method> <method name="i_cal_value_get_pollmode" corresponds="icalvalue_get_pollmode" kind="get" since="2.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyPollmode" comment="The pollmode within #ICalValue"/> - <comment>Get the pollmode of #ICalValue.</comment> + <comment>Gets the pollmode of #ICalValue.</comment> </method> <method name="i_cal_value_set_utcoffset" corresponds="icalvalue_set_utcoffset" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="gint" name="v" comment="The utcoffset value."/> - <comment>Set the utcoffset in the #ICalValue.</comment> + <comment>Sets the utcoffset in the #ICalValue.</comment> </method> <method name="i_cal_value_new_utcoffset" corresponds="icalvalue_new_utcoffset" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The utcoffset value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type utcoffset.</comment> + <comment>Creates a new #ICalValue with the type utcoffset.</comment> </method> <method name="i_cal_value_get_utcoffset" corresponds="icalvalue_get_utcoffset" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="gint" comment="The utcoffset within #ICalValue"/> - <comment>Get the utcoffset of #ICalValue.</comment> + <comment>Gets the utcoffset of #ICalValue.</comment> </method> <method name="i_cal_value_set_method" corresponds="icalvalue_set_method" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyMethod" name="v" comment="The method value."/> - <comment>Set the method in the #ICalValue.</comment> + <comment>Sets the method in the #ICalValue.</comment> </method> <method name="i_cal_value_new_method" corresponds="icalvalue_new_method" kind="constructor" since="1.0"> <parameter type="ICalPropertyMethod" name="v" comment="The method value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type method.</comment> + <comment>Creates a new #ICalValue with the type method.</comment> </method> <method name="i_cal_value_get_method" corresponds="icalvalue_get_method" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyMethod" comment="The method within #ICalValue"/> - <comment>Get the method of #ICalValue.</comment> + <comment>Gets the method of #ICalValue.</comment> </method> <method name="i_cal_value_set_caladdress" corresponds="icalvalue_set_caladdress" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The caladdress value."/> - <comment>Set the caladdress in the #ICalValue.</comment> + <comment>Sets the caladdress in the #ICalValue.</comment> </method> <method name="i_cal_value_new_caladdress" corresponds="icalvalue_new_caladdress" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The caladdress value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type caladdress.</comment> + <comment>Creates a new #ICalValue with the type caladdress.</comment> </method> <method name="i_cal_value_get_caladdress" corresponds="icalvalue_get_caladdress" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The caladdress within #ICalValue"/> - <comment>Get the caladdress of #ICalValue.</comment> + <comment>Gets the caladdress of #ICalValue.</comment> </method> <method name="i_cal_value_set_period" corresponds="icalvalue_set_period" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPeriod *" name="v" comment="The period value."/> - <comment>Set the period in the #ICalValue.</comment> + <comment>Sets the period in the #ICalValue.</comment> </method> <method name="i_cal_value_new_period" corresponds="icalvalue_new_period" kind="constructor" since="1.0"> <parameter type="ICalPeriod *" name="v" comment="The period value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type period.</comment> + <comment>Creates a new #ICalValue with the type period.</comment> </method> <method name="i_cal_value_get_period" corresponds="icalvalue_get_period" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPeriod *" annotation="allow-none, transfer full" comment="The period within #ICalValue"/> - <comment>Get the period of #ICalValue.</comment> + <comment>Gets the period of #ICalValue.</comment> </method> <method name="i_cal_value_set_status" corresponds="icalvalue_set_status" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyStatus" name="v" comment="The status value."/> - <comment>Set the status in the #ICalValue.</comment> + <comment>Sets the status in the #ICalValue.</comment> </method> <method name="i_cal_value_new_status" corresponds="icalvalue_new_status" kind="constructor" since="1.0"> <parameter type="ICalPropertyStatus" name="v" comment="The status value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type status.</comment> + <comment>Creates a new #ICalValue with the type status.</comment> </method> <method name="i_cal_value_get_status" corresponds="icalvalue_get_status" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyStatus" comment="The status within #ICalValue"/> - <comment>Get the status of #ICalValue.</comment> + <comment>Gets the status of #ICalValue.</comment> </method> <method name="i_cal_value_set_binary" corresponds="icalvalue_set_binary" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The binary value."/> - <comment>Set the binary in the #ICalValue.</comment> + <comment>Sets the binary in the #ICalValue.</comment> </method> <method name="i_cal_value_new_binary" corresponds="icalvalue_new_binary" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The binary value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type binary.</comment> + <comment>Creates a new #ICalValue with the type binary.</comment> </method> <method name="i_cal_value_get_binary" corresponds="icalvalue_get_binary" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The binary within #ICalValue"/> - <comment>Get the binary of #ICalValue.</comment> + <comment>Gets the binary of #ICalValue.</comment> </method> <method name="i_cal_value_set_text" corresponds="icalvalue_set_text" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The text value."/> - <comment>Set the text in the #ICalValue.</comment> + <comment>Sets the text in the #ICalValue.</comment> </method> <method name="i_cal_value_new_text" corresponds="icalvalue_new_text" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The text value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type text.</comment> + <comment>Creates a new #ICalValue with the type text.</comment> </method> <method name="i_cal_value_get_text" corresponds="icalvalue_get_text" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The text within #ICalValue"/> - <comment>Get the text of #ICalValue.</comment> + <comment>Gets the text of #ICalValue.</comment> </method> <method name="i_cal_value_set_duration" corresponds="icalvalue_set_duration" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalDuration *" name="v" comment="The duration value."/> - <comment>Set the duration in the #ICalValue.</comment> + <comment>Sets the duration in the #ICalValue.</comment> </method> <method name="i_cal_value_new_duration" corresponds="icalvalue_new_duration" kind="constructor" since="1.0"> <parameter type="ICalDuration *" name="v" comment="The duration value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type duration.</comment> + <comment>Creates a new #ICalValue with the type duration.</comment> </method> <method name="i_cal_value_get_duration" corresponds="icalvalue_get_duration" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalDuration *" annotation="allow-none, transfer full" comment="The duration within #ICalValue"/> - <comment>Get the duration of #ICalValue.</comment> + <comment>Gets the duration of #ICalValue.</comment> </method> <method name="i_cal_value_set_integer" corresponds="icalvalue_set_integer" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="gint" name="v" comment="The integer value."/> - <comment>Set the integer in the #ICalValue.</comment> + <comment>Sets the integer in the #ICalValue.</comment> </method> <method name="i_cal_value_new_integer" corresponds="icalvalue_new_integer" kind="constructor" since="1.0"> <parameter type="gint" name="v" comment="The integer value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type integer.</comment> + <comment>Creates a new #ICalValue with the type integer.</comment> </method> <method name="i_cal_value_get_integer" corresponds="icalvalue_get_integer" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="gint" comment="The integer within #ICalValue"/> - <comment>Get the integer of #ICalValue.</comment> + <comment>Gets the integer of #ICalValue.</comment> </method> <method name="i_cal_value_set_uri" corresponds="icalvalue_set_uri" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The uri value."/> - <comment>Set the uri in the #ICalValue.</comment> + <comment>Sets the uri in the #ICalValue.</comment> </method> <method name="i_cal_value_new_uri" corresponds="icalvalue_new_uri" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The uri value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type uri.</comment> + <comment>Creates a new #ICalValue with the type uri.</comment> </method> <method name="i_cal_value_get_uri" corresponds="icalvalue_get_uri" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The uri within #ICalValue"/> - <comment>Get the uri of #ICalValue.</comment> + <comment>Gets the uri of #ICalValue.</comment> </method> <method name="i_cal_value_set_class" corresponds="icalvalue_set_class" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalProperty_Class" name="v" comment="The class value."/> - <comment>Set the class in the #ICalValue.</comment> + <comment>Sets the class in the #ICalValue.</comment> </method> <method name="i_cal_value_new_class" corresponds="icalvalue_new_class" kind="constructor" since="1.0"> <parameter type="ICalProperty_Class" name="v" comment="The class value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type class.</comment> + <comment>Creates a new #ICalValue with the type class.</comment> </method> <method name="i_cal_value_get_class" corresponds="icalvalue_get_class" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalProperty_Class" comment="The class within #ICalValue"/> - <comment>Get the class of #ICalValue.</comment> + <comment>Gets the class of #ICalValue.</comment> </method> <method name="i_cal_value_set_float" corresponds="icalvalue_set_float" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="gdouble" name="v" comment="The float value."/> - <comment>Set the float in the #ICalValue.</comment> + <comment>Sets the float in the #ICalValue.</comment> </method> <method name="i_cal_value_new_float" corresponds="icalvalue_new_float" kind="constructor" since="1.0"> <parameter type="gdouble" name="v" comment="The float value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type float.</comment> + <comment>Creates a new #ICalValue with the type float.</comment> </method> <method name="i_cal_value_get_float" corresponds="icalvalue_get_float" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="gdouble" comment="The float within #ICalValue"/> - <comment>Get the float of #ICalValue.</comment> + <comment>Gets the float of #ICalValue.</comment> </method> <method name="i_cal_value_set_query" corresponds="icalvalue_set_query" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The query value."/> - <comment>Set the query in the #ICalValue.</comment> + <comment>Sets the query in the #ICalValue.</comment> </method> <method name="i_cal_value_new_query" corresponds="icalvalue_new_query" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The query value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type query.</comment> + <comment>Creates a new #ICalValue with the type query.</comment> </method> <method name="i_cal_value_get_query" corresponds="icalvalue_get_query" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The query within #ICalValue"/> - <comment>Get the query of #ICalValue.</comment> + <comment>Gets the query of #ICalValue.</comment> </method> <method name="i_cal_value_set_string" corresponds="icalvalue_set_string" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="const gchar *" name="v" comment="The string value."/> - <comment>Set the string in the #ICalValue.</comment> + <comment>Sets the string in the #ICalValue.</comment> </method> <method name="i_cal_value_new_string" corresponds="icalvalue_new_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="v" comment="The string value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type string.</comment> + <comment>Creates a new #ICalValue with the type string.</comment> </method> <method name="i_cal_value_get_string" corresponds="icalvalue_get_string" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The string within #ICalValue"/> - <comment>Get the string of #ICalValue.</comment> + <comment>Gets the string of #ICalValue.</comment> </method> <method name="i_cal_value_set_transp" corresponds="icalvalue_set_transp" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyTransp" name="v" comment="The transp value."/> - <comment>Set the transp in the #ICalValue.</comment> + <comment>Sets the transp in the #ICalValue.</comment> </method> <method name="i_cal_value_new_transp" corresponds="icalvalue_new_transp" kind="constructor" since="1.0"> <parameter type="ICalPropertyTransp" name="v" comment="The transp value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type transp.</comment> + <comment>Creates a new #ICalValue with the type transp.</comment> </method> <method name="i_cal_value_get_transp" corresponds="icalvalue_get_transp" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyTransp" comment="The transp within #ICalValue"/> - <comment>Get the transp of #ICalValue.</comment> + <comment>Gets the transp of #ICalValue.</comment> </method> <method name="i_cal_value_set_requeststatus" corresponds="icalvalue_set_requeststatus" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalReqstat *" name="v" comment="The requeststatus value."/> - <comment>Set the requeststatus in the #ICalValue.</comment> + <comment>Sets the requeststatus in the #ICalValue.</comment> </method> <method name="i_cal_value_new_requeststatus" corresponds="icalvalue_new_requeststatus" kind="constructor" since="1.0"> <parameter type="ICalReqstat *" name="v" comment="The requeststatus value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type requeststatus.</comment> + <comment>Creates a new #ICalValue with the type requeststatus.</comment> </method> <method name="i_cal_value_get_requeststatus" corresponds="icalvalue_get_requeststatus" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalReqstat *" annotation="allow-none, transfer full" comment="The requeststatus within #ICalValue"/> - <comment>Get the requeststatus of #ICalValue.</comment> + <comment>Gets the requeststatus of #ICalValue.</comment> </method> <method name="i_cal_value_set_date" corresponds="icalvalue_set_date" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalTime *" name="v" comment="The date value."/> - <comment>Set the date in the #ICalValue.</comment> + <comment>Sets the date in the #ICalValue.</comment> </method> <method name="i_cal_value_new_date" corresponds="icalvalue_new_date" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="v" comment="The date value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type date.</comment> + <comment>Creates a new #ICalValue with the type date.</comment> </method> <method name="i_cal_value_get_date" corresponds="icalvalue_get_date" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalTime *" annotation="allow-none, transfer full" comment="The date within #ICalValue"/> - <comment>Get the date of #ICalValue.</comment> + <comment>Gets the date of #ICalValue.</comment> </method> <method name="i_cal_value_set_action" corresponds="icalvalue_set_action" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyAction" name="v" comment="The action value."/> - <comment>Set the action in the #ICalValue.</comment> + <comment>Sets the action in the #ICalValue.</comment> </method> <method name="i_cal_value_new_action" corresponds="icalvalue_new_action" kind="constructor" since="1.0"> <parameter type="ICalPropertyAction" name="v" comment="The action value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type action.</comment> + <comment>Creates a new #ICalValue with the type action.</comment> </method> <method name="i_cal_value_get_action" corresponds="icalvalue_get_action" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyAction" comment="The action within #ICalValue"/> - <comment>Get the action of #ICalValue.</comment> + <comment>Gets the action of #ICalValue.</comment> </method> <method name="i_cal_value_set_cmd" corresponds="icalvalue_set_cmd" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyCmd" name="v" comment="The cmd value."/> - <comment>Set the cmd in the #ICalValue.</comment> + <comment>Sets the cmd in the #ICalValue.</comment> </method> <method name="i_cal_value_new_cmd" corresponds="icalvalue_new_cmd" kind="constructor" since="1.0"> <parameter type="ICalPropertyCmd" name="v" comment="The cmd value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type cmd.</comment> + <comment>Creates a new #ICalValue with the type cmd.</comment> </method> <method name="i_cal_value_get_cmd" corresponds="icalvalue_get_cmd" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyCmd" comment="The cmd within #ICalValue"/> - <comment>Get the cmd of #ICalValue.</comment> + <comment>Gets the cmd of #ICalValue.</comment> </method> <method name="i_cal_value_set_querylevel" corresponds="icalvalue_set_querylevel" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyQuerylevel" name="v" comment="The querylevel value."/> - <comment>Set the querylevel in the #ICalValue.</comment> + <comment>Sets the querylevel in the #ICalValue.</comment> </method> <method name="i_cal_value_new_querylevel" corresponds="icalvalue_new_querylevel" kind="constructor" since="1.0"> <parameter type="ICalPropertyQuerylevel" name="v" comment="The querylevel value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type querylevel.</comment> + <comment>Creates a new #ICalValue with the type querylevel.</comment> </method> <method name="i_cal_value_get_querylevel" corresponds="icalvalue_get_querylevel" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyQuerylevel" comment="The querylevel within #ICalValue"/> - <comment>Get the querylevel of #ICalValue.</comment> + <comment>Gets the querylevel of #ICalValue.</comment> </method> <method name="i_cal_value_set_carlevel" corresponds="icalvalue_set_carlevel" kind="set" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue."/> <parameter type="ICalPropertyCarlevel" name="v" comment="The carlevel value."/> - <comment>Set the carlevel in the #ICalValue.</comment> + <comment>Sets the carlevel in the #ICalValue.</comment> </method> <method name="i_cal_value_new_carlevel" corresponds="icalvalue_new_carlevel" kind="constructor" since="1.0"> <parameter type="ICalPropertyCarlevel" name="v" comment="The carlevel value"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly create #ICalValue."/> - <comment>Create a new #ICalValue with the type carlevel.</comment> + <comment>Creates a new #ICalValue with the type carlevel.</comment> </method> <method name="i_cal_value_get_carlevel" corresponds="icalvalue_get_carlevel" kind="get" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be queried."/> <returns type="ICalPropertyCarlevel" comment="The carlevel within #ICalValue"/> - <comment>Get the carlevel of #ICalValue.</comment> + <comment>Gets the carlevel of #ICalValue.</comment> </method> </structure> diff --git a/src/libical-glib/api/i-cal-duration.xml b/src/libical-glib/api/i-cal-duration.xml index 4850e628..bb91925c 100644 --- a/src/libical-glib/api/i-cal-duration.xml +++ b/src/libical-glib/api/i-cal-duration.xml @@ -17,96 +17,96 @@ <method name="i_cal_duration_is_neg" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be queried."/> <returns type="gboolean" comment="The is_neg." /> - <comment xml:space="preserve">Get the is_neg of #ICalDuration.</comment> + <comment xml:space="preserve">Gets the is_neg of #ICalDuration.</comment> <custom> g_return_val_if_fail (duration != NULL, 0); return (((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->is_neg) ? TRUE : FALSE;</custom> </method> <method name="i_cal_duration_set_is_neg" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be set."/> <parameter type="gboolean" name="is_neg" comment="The is_neg."/> - <comment>Set the is_neg of #ICalDuration.</comment> + <comment>Sets the is_neg of #ICalDuration.</comment> <custom> g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->is_neg = is_neg ? 1 : 0;</custom> </method> <method name="i_cal_duration_get_days" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be queried."/> <returns type="guint" comment="The days." /> - <comment xml:space="preserve">Get the days of #ICalDuration.</comment> + <comment xml:space="preserve">Gets the days of #ICalDuration.</comment> <custom> g_return_val_if_fail (duration != NULL, 0); return ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->days;</custom> </method> <method name="i_cal_duration_set_days" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be set."/> <parameter type="guint" name="days" comment="The days."/> - <comment>Set the days of #ICalDuration.</comment> + <comment>Sets the days of #ICalDuration.</comment> <custom> g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->days = days;</custom> </method> <method name="i_cal_duration_get_weeks" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be queried."/> <returns type="guint" comment="The weeks." /> - <comment xml:space="preserve">Get the weeks of #ICalDuration.</comment> + <comment xml:space="preserve">Gets the weeks of #ICalDuration.</comment> <custom> g_return_val_if_fail (duration != NULL, 0); return ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->weeks;</custom> </method> <method name="i_cal_duration_set_weeks" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be set."/> <parameter type="guint" name="weeks" comment="The weeks."/> - <comment>Set the weeks of #ICalDuration.</comment> + <comment>Sets the weeks of #ICalDuration.</comment> <custom> g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->weeks = weeks;</custom> </method> <method name="i_cal_duration_get_hours" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be queried."/> <returns type="guint" comment="The hours." /> - <comment xml:space="preserve">Get the hours of #ICalDuration.</comment> + <comment xml:space="preserve">Gets the hours of #ICalDuration.</comment> <custom> g_return_val_if_fail (duration != NULL, 0); return ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->hours;</custom> </method> <method name="i_cal_duration_set_hours" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be set."/> <parameter type="guint" name="hours" comment="The hours."/> - <comment>Set the hours of #ICalDuration.</comment> + <comment>Sets the hours of #ICalDuration.</comment> <custom> g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->hours = hours;</custom> </method> <method name="i_cal_duration_get_minutes" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be queried."/> <returns type="guint" comment="The minutes." /> - <comment xml:space="preserve">Get the minutes of #ICalDuration.</comment> + <comment xml:space="preserve">Gets the minutes of #ICalDuration.</comment> <custom> g_return_val_if_fail (duration != NULL, 0); return ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->minutes;</custom> </method> <method name="i_cal_duration_set_minutes" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be set."/> <parameter type="guint" name="minutes" comment="The minutes."/> - <comment>Set the minutes of #ICalDuration.</comment> + <comment>Sets the minutes of #ICalDuration.</comment> <custom> g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->minutes = minutes;</custom> </method> <method name="i_cal_duration_get_seconds" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be queried."/> <returns type="guint" comment="The seconds." /> - <comment xml:space="preserve">Get the seconds of #ICalDuration.</comment> + <comment xml:space="preserve">Gets the seconds of #ICalDuration.</comment> <custom> g_return_val_if_fail (duration != NULL, 0); return ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->seconds;</custom> </method> <method name="i_cal_duration_set_seconds" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be set."/> <parameter type="guint" name="seconds" comment="The seconds."/> - <comment>Set the seconds of #ICalDuration.</comment> + <comment>Sets the seconds of #ICalDuration.</comment> <custom> g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration))->seconds = seconds;</custom> </method> <method name="i_cal_duration_new_from_int" corresponds="icaldurationtype_from_int" kind="constructor" since="1.0"> <parameter type="gint" name="t" comment="the duration in second"/> <returns type="ICalDuration *" annotation="transfer full" comment="The newly created #ICalDuration" /> - <comment xml:space="preserve">Create a #ICalDuration from the duration in second</comment> + <comment xml:space="preserve">Creates a #ICalDuration from the duration in second</comment> </method> <method name="i_cal_duration_new_from_string" corresponds="icaldurationtype_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="str" comment="The string representation of the duration"/> <returns type="ICalDuration *" annotation="transfer full" comment="The newly created #ICalDuration" /> - <comment xml:space="preserve">Create a #ICalDuration from the duration in string</comment> + <comment xml:space="preserve">Creates a #ICalDuration from the duration in string</comment> </method> <method name="i_cal_duration_as_int" corresponds="icaldurationtype_as_int" kind="others" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be converted"/> @@ -120,11 +120,11 @@ </method> <method name="i_cal_duration_new_null_duration" corresponds="icaldurationtype_null_duration" kind="constructor" since="1.0"> <returns type="ICalDuration *" annotation="transfer full" comment="The newly created #ICalDuration" /> - <comment xml:space="preserve">Create a #ICalDuration with all the fields to be zero</comment> + <comment xml:space="preserve">Creates a #ICalDuration with all the fields to be zero</comment> </method> <method name="i_cal_duration_new_bad_duration" corresponds="icaldurationtype_bad_duration" kind="constructor" since="1.0"> <returns type="ICalDuration *" annotation="transfer full" comment="The newly created #ICalDuration" /> - <comment xml:space="preserve">Create a bad #ICalDuration</comment> + <comment xml:space="preserve">Creates a bad #ICalDuration</comment> </method> <method name="i_cal_duration_is_null_duration" corresponds="icaldurationtype_is_null_duration" kind="others" since="1.0"> <parameter type="ICalDuration *" name="duration" comment="The #ICalDuration to be checked"/> diff --git a/src/libical-glib/api/i-cal-enums.xml b/src/libical-glib/api/i-cal-enums.xml index 3da32879..3c9ba7b9 100644 --- a/src/libical-glib/api/i-cal-enums.xml +++ b/src/libical-glib/api/i-cal-enums.xml @@ -91,27 +91,27 @@ <method name="i_cal_request_status_desc" corresponds="icalenum_reqstat_desc" since="1.0"> <parameter type="ICalRequestStatus" name="stat" comment="The #ICalRequestStatus to be translated"/> <returns type="const gchar *" comment="The description of the @stat" /> - <comment xml:space="preserve">Return the descriptive text for a request status</comment> + <comment xml:space="preserve">Returns the descriptive text for a request status</comment> </method> <method name="i_cal_request_status_major" corresponds="icalenum_reqstat_major" since="1.0"> <parameter type="ICalRequestStatus" name="stat" comment="The #ICalRequestStatus to be queried"/> <returns type="gshort" comment="The major number for a request status" /> - <comment xml:space="preserve">Return the major number for a request status</comment> + <comment xml:space="preserve">Returns the major number for a request status</comment> </method> <method name="i_cal_request_status_minor" corresponds="icalenum_reqstat_minor" since="1.0"> <parameter type="ICalRequestStatus" name="stat" comment="The #ICalRequestStatus to be queried"/> <returns type="gshort" comment="The minor number for a request status" /> - <comment xml:space="preserve">Return the minor number for a request status</comment> + <comment xml:space="preserve">Returns the minor number for a request status</comment> </method> <method name="i_cal_request_status_from_num" corresponds="icalenum_num_to_reqstat" since="1.0"> <parameter type="gshort" name="major" comment="The major number"/> <parameter type="gshort" name="minor" comment="The minor number"/> <returns type="ICalRequestStatus" comment="The corresponding #ICalRequestStatus" /> - <comment xml:space="preserve">Return a request status for major/minor status numbers</comment> + <comment xml:space="preserve">Returns a request status for major/minor status numbers</comment> </method> <method name="i_cal_request_status_code" corresponds="icalenum_reqstat_code_r" since="1.0"> <parameter type="ICalRequestStatus" name="stat" comment="The #ICalRequestStatus to be queried"/> <returns type="gchar *" annotation="transfer full" comment="The code for a request status" /> - <comment xml:space="preserve">Return the code for a request status</comment> + <comment xml:space="preserve">Returns the code for a request status</comment> </method> </structure> diff --git a/src/libical-glib/api/i-cal-error.xml b/src/libical-glib/api/i-cal-error.xml index f7427391..22f5d23e 100644 --- a/src/libical-glib/api/i-cal-error.xml +++ b/src/libical-glib/api/i-cal-error.xml @@ -39,7 +39,7 @@ </method> <method name="i_cal_errno_return" corresponds="icalerrno_return" since="1.0"> <returns type="ICalErrorEnum" annotation="transfer full" translator="(ICalErrorEnum) *" translator_argus="NONE" comment="Return the error happened" /> - <comment xml:space="preserve">Return the error stored in the library. If no error, return I_CAL_NO_ERROR.</comment> + <comment xml:space="preserve">Returns the error stored in the library. If no error, return I_CAL_NO_ERROR.</comment> </method> <method name="i_cal_error_clear_errno" corresponds="icalerror_clear_errno" since="1.0"></method> <method name="i_cal_error_strerror" corresponds="icalerror_strerror" since="1.0"> @@ -49,22 +49,22 @@ </method> <method name="i_cal_error_perror" corresponds="icalerror_perror" since="1.0"> <returns type="const gchar *" annotation="transfer none" comment="The string representation of the current error" /> - <comment xml:space="preserve">Get the #ICalErrorEnum in the string representation. This method called the icalerrorno_return to get the current error</comment> + <comment xml:space="preserve">Gets the #ICalErrorEnum in the string representation. This method called the icalerrorno_return to get the current error</comment> </method> <method name="i_cal_bt" corresponds="ical_bt" kind="other" since="1.0"></method> <method name="i_cal_error_set_error_state" corresponds="icalerror_set_error_state" kind="set" since="1.0"> <parameter type="ICalErrorEnum" name="error" comment="The error enum"/> <parameter type="ICalErrorState" name="state" comment="The error state"/> - <comment xml:space="preserve">Set the state to the corresponding error in the library.</comment> + <comment xml:space="preserve">Sets the state to the corresponding error in the library.</comment> </method> <method name="i_cal_error_get_error_state" corresponds="icalerror_get_error_state" kind="get" since="1.0"> <parameter type="ICalErrorEnum" name="error" comment="The error to be checked"/> <returns type="ICalErrorState" comment="The state of the @error" /> - <comment xml:space="preserve">Get the state of an error</comment> + <comment xml:space="preserve">Gets the state of an error</comment> </method> <method name="i_cal_error_set_errno" corresponds="icalerror_set_errno" kind="set" since="1.0"> <parameter type="ICalErrorEnum" name="x" comment="The error to be set"/> - <comment xml:space="preserve">Set the errno.</comment> + <comment xml:space="preserve">Sets the errno.</comment> </method> <method name="i_cal_error_supress" corresponds="icalerror_supress" since="1.0"> <parameter type="const gchar *" name="error" comment="The error to be suppressed"/> diff --git a/src/libical-glib/api/i-cal-geo.xml b/src/libical-glib/api/i-cal-geo.xml index fbfba3fc..38687241 100644 --- a/src/libical-glib/api/i-cal-geo.xml +++ b/src/libical-glib/api/i-cal-geo.xml @@ -16,7 +16,7 @@ <structure namespace="ICal" name="Geo" native="struct icalgeotype" is_bare="true" default_native="i_cal_geo_new_default ()"> <method name="i_cal_geo_new_default" corresponds="CUSTOM" annotation="skip" kind="private" since="1.0"> <returns type="struct icalgeotype" annotation="transfer full" comment="The newly created #ICalGeo" /> - <comment xml:space="preserve">Create a new default #ICalGeo.</comment> + <comment xml:space="preserve">Creates a new default #ICalGeo.</comment> <custom> struct icalgeotype geotype; geotype.lat = 0; geotype.lon = 0; @@ -26,7 +26,7 @@ <parameter type="gdouble" name="lat" comment="Latitude."/> <parameter type="gdouble" name="lon" comment="Longitude."/> <returns type="ICalGeo *" annotation="transfer full" comment="The newly created #ICalGeo." /> - <comment xml:space="preserve">Create a new #ICalGeo.</comment> + <comment xml:space="preserve">Creates a new #ICalGeo.</comment> <custom> struct icalgeotype geo; geo = i_cal_geo_new_default(); @@ -38,7 +38,7 @@ <method name="i_cal_geo_clone" corresponds="CUSTOM" kind="clone" since="1.0"> <parameter type="const ICalGeo *" name="geo" comment="The #ICalGeo to clone."/> <returns type="ICalGeo *" annotation="transfer full" comment="The newly created #ICalGeo, copy of @geo." /> - <comment xml:space="preserve">Create a new #ICalGeo, copy of @geo.</comment> + <comment xml:space="preserve">Creates a new #ICalGeo, copy of @geo.</comment> <custom> struct icalgeotype *src; g_return_val_if_fail(I_CAL_IS_GEO(geo), NULL); @@ -51,28 +51,28 @@ <method name="i_cal_geo_get_lat" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalGeo *" name="geo" comment="The #ICalGeo to be queried."/> <returns type="gdouble" comment="The lat." /> - <comment xml:space="preserve">Get the lat of #ICalGeo.</comment> + <comment xml:space="preserve">Gets the lat of #ICalGeo.</comment> <custom> g_return_val_if_fail (geo != NULL, 0); return ((struct icalgeotype *)i_cal_object_get_native ((ICalObject *)geo))->lat;</custom> </method> <method name="i_cal_geo_set_lat" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalGeo *" name="geo" comment="The #ICalGeo to be set."/> <parameter type="gdouble" name="lat" comment="The lat."/> - <comment>Set the lat of #ICalGeo.</comment> + <comment>Sets the lat of #ICalGeo.</comment> <custom> g_return_if_fail (geo != NULL && I_CAL_IS_GEO (geo)); ((struct icalgeotype *)i_cal_object_get_native ((ICalObject *)geo))->lat = lat;</custom> </method> <method name="i_cal_geo_get_lon" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalGeo *" name="geo" comment="The #ICalGeo to be queried."/> <returns type="gdouble" comment="The lon." /> - <comment xml:space="preserve">Get the lon of #ICalGeo.</comment> + <comment xml:space="preserve">Gets the lon of #ICalGeo.</comment> <custom> g_return_val_if_fail (geo != NULL, 0); return ((struct icalgeotype *)i_cal_object_get_native ((ICalObject *)geo))->lon;</custom> </method> <method name="i_cal_geo_set_lon" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalGeo *" name="geo" comment="The #ICalGeo to be set."/> <parameter type="gdouble" name="lon" comment="The lon."/> - <comment>Set the lon of #ICalGeo.</comment> + <comment>Sets the lon of #ICalGeo.</comment> <custom> g_return_if_fail (geo != NULL && I_CAL_IS_GEO (geo)); ((struct icalgeotype *)i_cal_object_get_native ((ICalObject *)geo))->lon = lon;</custom> </method> diff --git a/src/libical-glib/api/i-cal-memory.xml b/src/libical-glib/api/i-cal-memory.xml index 34ef8198..94a303d4 100644 --- a/src/libical-glib/api/i-cal-memory.xml +++ b/src/libical-glib/api/i-cal-memory.xml @@ -17,7 +17,7 @@ <method name="i_cal_memory_tmp_buffer" corresponds="icalmemory_tmp_buffer" since="1.0"> <parameter type="size_t" name="size" comment="The size of the buffer to be created."/> <returns type="void *" annotation="transfer full" comment="The newly created buffer"/> - <comment xml:space="preserve">Create a buffer with target size.</comment> + <comment xml:space="preserve">Creates a buffer with target size.</comment> </method> <method name="i_cal_memory_tmp_copy" corresponds="icalmemory_tmp_copy" since="1.0"> <parameter type="const gchar *" name="str" comment="The string to be copied"/> @@ -34,7 +34,7 @@ <method name="i_cal_memory_new_buffer" corresponds="icalmemory_new_buffer" since="1.0"> <parameter type="size_t" name="size" comment="The size of the new buffer to be created."/> <returns type="void *" annotation="transfer full" comment="The newly created buffer with the target size."/> - <comment xml:space="preserve">Create a new buffer with target size. The caller should deallocate it when necessary.</comment> + <comment xml:space="preserve">Creates a new buffer with target size. The caller should deallocate it when necessary.</comment> </method> <method name="i_cal_memory_resize_buffer" corresponds="icalmemory_resize_buffer" since="1.0"> <parameter type="void *" name="buf" annotation="transfer full" comment="The buffer needs to be resized."/> diff --git a/src/libical-glib/api/i-cal-parameter.xml b/src/libical-glib/api/i-cal-parameter.xml index 94a4dd29..5a946b95 100644 --- a/src/libical-glib/api/i-cal-parameter.xml +++ b/src/libical-glib/api/i-cal-parameter.xml @@ -17,7 +17,7 @@ <method name="i_cal_parameter_new" corresponds="icalparameter_new" kind="constructor" since="1.0"> <parameter type="ICalParameterKind" name="v" comment="The type of #ICalParameter to be created"/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter." /> - <comment xml:space="preserve">Create a new #ICalParameter according to the kind type</comment> + <comment xml:space="preserve">Creates a new #ICalParameter according to the kind type</comment> </method> <method name="i_cal_parameter_clone" corresponds="icalparameter_new_clone" kind="clone" since="1.0"> <parameter type="ICalParameter *" name="p" annotation="in" comment="The #ICalParameter to be cloned"/> @@ -27,13 +27,13 @@ <method name="i_cal_parameter_new_from_string" corresponds="icalparameter_new_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="value" annotation="in, transfer none" comment="The string from which the #ICalParameter is created."/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created $ICalParameter with the properties specified in the @value." /> - <comment xml:space="preserve">Create a #ICalParameter from a string of form "PARAMNAME=VALUE".</comment> + <comment xml:space="preserve">Creates a #ICalParameter from a string of form "PARAMNAME=VALUE".</comment> </method> <method name="i_cal_parameter_new_from_value_string" corresponds="icalparameter_new_from_value_string" kind="constructor" since="1.0"> <parameter type="ICalParameterKind" name="kind" comment="The kind of #ICalParameter to be created."/> <parameter type="const gchar *" name="value" comment="The string from which #ICalParameter to be created."/> <returns type="ICalParameter *" annotation="transfer full" comment="The newly created #ICalParameter" /> - <comment xml:space="preserve">Create a new #ICalParameter from just the value, the part after the "="</comment> + <comment xml:space="preserve">Creates a new #ICalParameter from just the value, the part after the "="</comment> </method> <method name="i_cal_parameter_free" corresponds="icalparameter_free" annotation="skip" kind="destructor" since="1.0"> <parameter type="ICalParameter *" name="parameter" annotation="in" comment="The #ICalParameter to be freeed."/> @@ -57,42 +57,42 @@ <method name="i_cal_parameter_set_xname" corresponds="icalparameter_set_xname" kind="set" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter of which the xname to be set."/> <parameter type="const gchar *" name="v" comment="The name to be set into the @param."/> - <comment xml:space="preserve">Set the xname property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Sets the xname property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_get_xname" corresponds="icalparameter_get_xname" kind="get" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter to be queried"/> <returns type="const gchar *" annotation="allow-none" comment="the property of the @value" /> - <comment xml:space="preserve">Get the xname property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Gets the xname property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_set_xvalue" corresponds="icalparameter_set_xvalue" kind="set" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter of which the xvalue to be set."/> <parameter type="const gchar *" name="v" comment="The value to be set into the @param."/> - <comment xml:space="preserve">Set the xvalue property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Sets the xvalue property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_get_xvalue" corresponds="icalparameter_get_xvalue" kind="get" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter to be queried"/> <returns type="const gchar *" annotation="allow-none" comment="the property of the @value" /> - <comment xml:space="preserve">Get the xvalue property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Gets the xvalue property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_set_iana_name" corresponds="icalparameter_set_iana_name" kind="set" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter of which the iana_name to be set."/> <parameter type="const gchar *" name="v" comment="The name to be set into the @param."/> - <comment xml:space="preserve">Set the iana_name property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Sets the iana_name property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_get_iana_name" corresponds="icalparameter_get_iana_name" kind="get" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter to be queried"/> <returns type="const gchar *" annotation="allow-none" comment="the property of the @value" /> - <comment xml:space="preserve">Get the iana_name property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Gets the iana_name property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_set_iana_value" corresponds="icalparameter_set_iana_value" kind="set" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter of which the iana_value to be set."/> <parameter type="const gchar *" name="v" comment="The value to be set into the @param."/> - <comment xml:space="preserve">Set the iana_value property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Sets the iana_value property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_get_iana_value" corresponds="icalparameter_get_iana_value" kind="get" since="1.0"> <parameter type="ICalParameter *" name="param" comment="The #ICalParameter to be queried"/> <returns type="const gchar *" annotation="allow-none" comment="the property of the @value" /> - <comment xml:space="preserve">Get the iana_value property of the native part of the #ICalParameter.</comment> + <comment xml:space="preserve">Gets the iana_value property of the native part of the #ICalParameter.</comment> </method> <method name="i_cal_parameter_has_same_name" corresponds="icalparameter_has_same_name" kind="others" since="1.0"> <parameter type="ICalParameter *" name="param1" comment="The #ICalParameter to be checked"/> diff --git a/src/libical-glib/api/i-cal-parser.xml b/src/libical-glib/api/i-cal-parser.xml index e88cbe2c..1ec7f93d 100644 --- a/src/libical-glib/api/i-cal-parser.xml +++ b/src/libical-glib/api/i-cal-parser.xml @@ -32,7 +32,7 @@ typedef gchar *(*ICalParserLineGenFunc)(gchar *bytes, size_t size, gpointer user_data);</declaration> <method name="i_cal_parser_new" corresponds="icalparser_new" kind="constructor" since="1.0"> <returns type="ICalParser *" annotation="transfer full" comment="The newly created #ICalParser."/> - <comment xml:space="preserve">Create a default #ICalParser.</comment> + <comment xml:space="preserve">Creates a default #ICalParser.</comment> </method> <method name="i_cal_parser_add_line" corresponds="icalparser_add_line" since="1.0"> <parameter type="ICalParser *" name="parser" annotation="in, transfer full" comment="The #ICalParser used to parse the string into the #ICalComponent."/> @@ -48,7 +48,7 @@ typedef gchar *(*ICalParserLineGenFunc)(gchar *bytes, size_t size, gpointer user <method name="i_cal_parser_get_state" corresponds="icalparser_get_state" kind="get" since="1.0"> <parameter type="ICalParser *" name="parser" comment="The #ICalParser to be queried."/> <returns type="ICalParserState" comment="The parser state stored in the #ICalParser."/> - <comment xml:space="preserve">Get the state of the target parser.</comment> + <comment xml:space="preserve">Gets the state of the target parser.</comment> </method> <method name="i_cal_parser_free" corresponds="icalparser_free" kind="destructor" since="1.0"> <parameter type="ICalParser *" name="parser" comment="The #ICalParser to be freed."/> diff --git a/src/libical-glib/api/i-cal-period.xml b/src/libical-glib/api/i-cal-period.xml index aaa4b6aa..14dea443 100644 --- a/src/libical-glib/api/i-cal-period.xml +++ b/src/libical-glib/api/i-cal-period.xml @@ -17,7 +17,7 @@ <method name="i_cal_period_get_start" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalPeriod *" name="period" comment="The #ICalPeriod to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="The start of @period."/> - <comment>Get the start time from an #ICalPeriod.</comment> + <comment>Gets the start time from an #ICalPeriod.</comment> <custom> g_return_val_if_fail (period != NULL, NULL); g_return_val_if_fail (I_CAL_IS_PERIOD (period), NULL); @@ -26,7 +26,7 @@ <method name="i_cal_period_set_start" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalPeriod *" name="period" comment="The #ICalPeriod to be set."/> <parameter type="ICalTime *" name="start" comment="The start of @period."/> - <comment>Set the start time of an #ICalPeriod.</comment> + <comment>Sets the start time of an #ICalPeriod.</comment> <custom> struct icalperiodtype *periodtype; g_return_if_fail (period != NULL); g_return_if_fail (I_CAL_IS_PERIOD (period)); @@ -39,7 +39,7 @@ <method name="i_cal_period_get_end" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalPeriod *" name="period" comment="The #ICalPeriod to be queried."/> <returns type="ICalTime *" annotation="transfer full" comment="The end of @period."/> - <comment>Get the end time from an #ICalPeriod.</comment> + <comment>Gets the end time from an #ICalPeriod.</comment> <custom> g_return_val_if_fail (period != NULL, NULL); g_return_val_if_fail (I_CAL_IS_PERIOD (period), NULL); @@ -48,7 +48,7 @@ <method name="i_cal_period_set_end" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalPeriod *" name="period" comment="The #ICalPeriod to be set."/> <parameter type="ICalTime *" name="end" comment="The end of @period."/> - <comment>Set the end time of an #ICalPeriod.</comment> + <comment>Sets the end time of an #ICalPeriod.</comment> <custom> struct icalperiodtype *periodtype; g_return_if_fail (period != NULL); g_return_if_fail (I_CAL_IS_PERIOD (period)); @@ -61,7 +61,7 @@ <method name="i_cal_period_get_duration" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalPeriod *" name="period" comment="The #ICalPeriod to be queried."/> <returns type="ICalDuration *" annotation="transfer full" comment="The duration of @period."/> - <comment>Get the duration from an #ICalPeriod.</comment> + <comment>Gets the duration from an #ICalPeriod.</comment> <custom> g_return_val_if_fail (period != NULL, NULL); g_return_val_if_fail (I_CAL_IS_PERIOD (period), NULL); @@ -70,7 +70,7 @@ <method name="i_cal_period_set_duration" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalPeriod *" name="period" comment="The #ICalPeriod to be set."/> <parameter type="ICalDuration *" name="duration" comment="The duration of @period."/> - <comment>Set the duration of an #ICalPeriod.</comment> + <comment>Sets the duration of an #ICalPeriod.</comment> <custom> struct icalperiodtype *periodtype; g_return_if_fail (period != NULL); g_return_if_fail (I_CAL_IS_PERIOD (period)); @@ -83,7 +83,7 @@ <method name="i_cal_period_new_from_string" corresponds="icalperiodtype_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="str" comment="The string used to create the #ICalPeriod"/> <returns type="ICalPeriod *" annotation="transfer full" comment="The newly created #ICalPeriod"/> - <comment xml:space="preserve">Create a #ICalPeriod from a string.</comment> + <comment xml:space="preserve">Creates a #ICalPeriod from a string.</comment> </method> <method name="i_cal_period_as_ical_string" corresponds="icalperiodtype_as_ical_string_r" since="1.0"> <parameter type="ICalPeriod *" name="p" comment="The #ICalPeriod to be translated."/> @@ -92,7 +92,7 @@ </method> <method name="i_cal_period_new_null_period" corresponds="icalperiodtype_null_period" kind="constructor" since="1.0"> <returns type="ICalPeriod *" annotation="transfer full" comment="The newly created default #ICalPeriod"/> - <comment xml:space="preserve">Create a default #ICalPeriod.</comment> + <comment xml:space="preserve">Creates a default #ICalPeriod.</comment> </method> <method name="i_cal_period_is_null_period" corresponds="icalperiodtype_is_null_period" since="1.0"> <parameter type="ICalPeriod *" name="p" comment="The #ICalPeriod to be checked."/> diff --git a/src/libical-glib/api/i-cal-property.xml b/src/libical-glib/api/i-cal-property.xml index 6caa7eb2..bafa95bb 100644 --- a/src/libical-glib/api/i-cal-property.xml +++ b/src/libical-glib/api/i-cal-property.xml @@ -17,7 +17,7 @@ <method name="i_cal_property_new" corresponds="icalproperty_new" kind="constructor" since="1.0"> <parameter type="ICalPropertyKind" name="kind" comment="The kind of #ICalProperty to be created."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly created #ICalProperty with the type @kind."/> - <comment xml:space="preserve">Create a #ICalProperty of the target type.</comment> + <comment xml:space="preserve">Creates a #ICalProperty of the target type.</comment> </method> <method name="i_cal_property_clone" corresponds="icalproperty_new_clone" kind="clone" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be cloned."/> @@ -27,7 +27,7 @@ <method name="i_cal_property_new_from_string" corresponds="icalproperty_new_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="str" comment="The string used to construct a #ICalProperty."/> <returns type="ICalProperty *" annotation="transfer full" comment="The newly created #ICalProperty from @str."/> - <comment xml:space="preserve">Create a #ICalProperty from a string.</comment> + <comment xml:space="preserve">Creates a #ICalProperty from a string.</comment> </method> <method name="i_cal_property_as_ical_string" corresponds="icalproperty_as_ical_string_r" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be converted."/> @@ -41,7 +41,7 @@ <method name="i_cal_property_isa" corresponds="icalproperty_isa" since="1.0"> <parameter type="ICalProperty *" name="property" comment="The #ICalProperty which type is to be determined."/> <returns type="ICalPropertyKind" comment="The type of #ICalProperty."/> - <comment xml:space="preserve">Get the kind of #ICalProperty.</comment> + <comment xml:space="preserve">Gets the kind of #ICalProperty.</comment> </method> <method name="i_cal_property_isa_property" corresponds="icalproperty_isa_property" since="1.0"> <parameter type="ICalProperty *" name="property" comment="The object whose native part to be checked."/> @@ -66,19 +66,19 @@ <method name="i_cal_property_set_parameter" corresponds="icalproperty_set_parameter" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set."/> <parameter type="ICalParameter *" name="parameter" annotation="transfer none" owner_op="prop" comment="The parameter to be set into @prop."/> - <comment xml:space="preserve">Set a #ICalParameter into the #ICalProperty. It behaves like set the copy of the #ICalParameter. Upon completion the native part of #ICalParameter will be set to NULL.</comment> + <comment xml:space="preserve">Sets a #ICalParameter into the #ICalProperty. It behaves like set the copy of the #ICalParameter. Upon completion the native part of #ICalParameter will be set to NULL.</comment> </method> <method name="i_cal_property_set_parameter_from_string" corresponds="icalproperty_set_parameter_from_string" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set."/> <parameter type="const gchar *" name="name" comment="The name of the parameter."/> <parameter type="const gchar *" name="value" comment="The value of the parameter."/> - <comment xml:space="preserve">Set the #ICalProperty with the parameter defined by the name and value.</comment> + <comment xml:space="preserve">Sets the #ICalProperty with the parameter defined by the name and value.</comment> </method> <method name="i_cal_property_get_parameter_as_string" corresponds="icalproperty_get_parameter_as_string_r" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <parameter type="const gchar *" name="name" comment="The name of the target parameter."/> <returns type="gchar *" annotation="transfer full" comment="The string representation of the parameter."/> - <comment xml:space="preserve">Get the string representation of the target parameter in the #ICalProperty.</comment> + <comment xml:space="preserve">Gets the string representation of the target parameter in the #ICalProperty.</comment> </method> <method name="i_cal_property_remove_parameter_by_kind" corresponds="icalproperty_remove_parameter_by_kind" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be manipulated."/> @@ -104,23 +104,23 @@ <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <parameter type="ICalParameterKind" name="kind" comment="The target kind of #ICalParameter to be retrieved."/> <returns type="ICalParameter *" annotation="transfer full" translator_argus="(GObject *)prop" comment="The first #ICalParameter of @prop."/> - <comment xml:space="preserve">Get the first #ICalParameter from the parent #ICalProperty.</comment> + <comment xml:space="preserve">Gets the first #ICalParameter from the parent #ICalProperty.</comment> </method> <method name="i_cal_property_get_next_parameter" corresponds="icalproperty_get_next_parameter" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <parameter type="ICalParameterKind" name="kind" comment="The target kind of #ICalParameter to be retrieved."/> <returns type="ICalParameter *" annotation="transfer full" translator_argus="(GObject *)prop" comment="The next #ICalParameter of @prop."/> - <comment xml:space="preserve">Get the next #ICalParameter from the parent #ICalProperty.</comment> + <comment xml:space="preserve">Gets the next #ICalParameter from the parent #ICalProperty.</comment> </method> <method name="i_cal_property_set_value" corresponds="icalproperty_set_value" since="1.0"> <parameter type="ICalProperty *" name="prop" translator_argus="value" comment="The target #ICalProperty."/> <parameter type="ICalValue *" name="value" owner_op="prop" comment="The #ICalValue will be set as the property of @prop."/> - <comment xml:space="preserve">Set the #ICalProperty with the #ICalValue.</comment> + <comment xml:space="preserve">Sets the #ICalProperty with the #ICalValue.</comment> </method> <method name="i_cal_property_take_value" corresponds="CUSTOM" annotation="skip" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="The target #ICalProperty."/> <parameter type="ICalValue *" name="value" annotation="transfer full" comment="The #ICalValue will be set as the property of @prop."/> - <comment xml:space="preserve">Set the @prop with the @value and unrefs the @value.</comment> + <comment xml:space="preserve">Sets the @prop with the @value and unrefs the @value.</comment> <custom> g_return_if_fail(I_CAL_IS_PROPERTY(prop)); g_return_if_fail(I_CAL_IS_VALUE(value)); @@ -131,52 +131,52 @@ <parameter type="ICalProperty *" name="prop" comment="The #ICalProperty to be set."/> <parameter type="const gchar *" name="value" comment="The value used to construct the #ICalValue."/> <parameter type="const gchar *" name="kind" comment="The kind used to construct the #ICalValue."/> - <comment xml:space="preserve">Set the #ICalProperty with the #ICalValue constructed from string.</comment> + <comment xml:space="preserve">Sets the #ICalProperty with the #ICalValue constructed from string.</comment> </method> <method name="i_cal_property_get_value" corresponds="icalproperty_get_value" since="1.0"> <parameter type="const ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="ICalValue *" annotation="transfer full" translator_argus="(GObject *)prop" comment="The #ICalValue of @prop."/> - <comment xml:space="preserve">Get the #ICalValue of #ICalProperty.</comment> + <comment xml:space="preserve">Gets the #ICalValue of #ICalProperty.</comment> </method> <method name="i_cal_property_get_value_as_string" corresponds="icalproperty_get_value_as_string_r" since="1.0"> <parameter type="const ICalProperty *" name="prop" comment="The #ICalProperty to be queried."/> <returns type="gchar *" annotation="transfer full" comment="The string representation of the value of the #ICalProperty."/> - <comment xml:space="preserve">Get the string representation of the value in #ICalProperty.</comment> + <comment xml:space="preserve">Gets the string representation of the value in #ICalProperty.</comment> </method> <method name="i_cal_value_set_parent" corresponds="icalvalue_set_parent" since="2.0"> <parameter type="ICalValue *" name="value" comment="The child #ICalValue"/> <parameter type="ICalProperty *" name="property" annotation="nullable" comment="The parent #ICalProperty"/> - <comment xml:space="preserve">Set the parent property of a value.</comment> + <comment xml:space="preserve">Sets the parent property of a value.</comment> </method> <method name="i_cal_value_get_parent" corresponds="icalvalue_get_parent" since="3.0"> <parameter type="ICalValue *" name="value" comment="The child #ICalValue"/> <returns type="ICalProperty *" annotation="transfer full, nullable" comment="The parent #ICalProperty"/> - <comment xml:space="preserve">Get the parent #ICalProperty of the specified #ICalValue.</comment> + <comment xml:space="preserve">Gets the parent #ICalProperty of the specified #ICalValue.</comment> </method> <method name="i_cal_parameter_set_parent" corresponds="icalparameter_set_parent" since="3.0"> <parameter type="ICalParameter *" name="param" comment="The child #ICalParameter"/> <parameter type="ICalProperty *" name="property" annotation="nullable" comment="The parent #ICalProperty"/> - <comment xml:space="preserve">Set the parent #ICalProperty of an #ICalParameter.</comment> + <comment xml:space="preserve">Sets the parent #ICalProperty of an #ICalParameter.</comment> </method> <method name="i_cal_parameter_get_parent" corresponds="icalparameter_get_parent" since="3.0"> <parameter type="ICalParameter *" name="param" comment="The child #ICalParameter"/> <returns type="ICalProperty *" annotation="transfer full, nullable" comment="The parent #ICalProperty"/> - <comment xml:space="preserve">Get the parent #ICalProperty of the specified #ICalParameter.</comment> + <comment xml:space="preserve">Gets the parent #ICalProperty of the specified #ICalParameter.</comment> </method> <method name="i_cal_property_set_x_name" corresponds="icalproperty_set_x_name" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="A #ICalProperty"/> <parameter type="const gchar *" name="name" comment="The name string."/> - <comment xml:space="preserve">Set the name of x property for the #ICalProperty.</comment> + <comment xml:space="preserve">Sets the name of x property for the #ICalProperty.</comment> </method> <method name="i_cal_property_get_x_name" corresponds="icalproperty_get_x_name" since="1.0"> <parameter type="ICalProperty *" name="prop" comment="A #ICalProperty."/> <returns type="const gchar *" annotation="nullable" comment="The name of x property."/> - <comment xml:space="preserve">Get the name of x property.</comment> + <comment xml:space="preserve">Gets the name of x property.</comment> </method> <method name="i_cal_property_get_property_name" corresponds="icalproperty_get_property_name_r" since="1.0"> <parameter type="const ICalProperty *" name="prop" comment="A #ICalProperty."/> <returns type="gchar *" annotation="transfer full" comment="Property name of #ICalProperty."/> - <comment xml:space="preserve">Get the property name of #ICalProperty.</comment> + <comment xml:space="preserve">Gets the property name of #ICalProperty.</comment> </method> <method name="i_cal_parameter_value_to_value_kind" corresponds="icalparameter_value_to_value_kind" since="1.0"> <parameter type="ICalParameterValue" name="value" comment="A #ICalParameterValue."/> diff --git a/src/libical-glib/api/i-cal-recur-iterator.xml b/src/libical-glib/api/i-cal-recur-iterator.xml index ac905632..13dde314 100644 --- a/src/libical-glib/api/i-cal-recur-iterator.xml +++ b/src/libical-glib/api/i-cal-recur-iterator.xml @@ -18,18 +18,18 @@ <parameter type="ICalRecurrence *" name="rule" comment="The rule applied on the #ICalRecurIterator."/> <parameter type="ICalTime *" name="dtstart" comment="The start time of the recurrence."/> <returns type="ICalRecurIterator *" annotation="transfer full" comment="The newly created #ICalRecurIterator"/> - <comment xml:space="preserve">Create an #ICalRecurIterator.</comment> + <comment xml:space="preserve">Creates an #ICalRecurIterator.</comment> </method> <method name="i_cal_recur_iterator_next" corresponds="icalrecur_iterator_next" since="1.0"> <parameter type="ICalRecurIterator *" name="iterator" comment="The iterator."/> <returns type="ICalTime *" annotation="transfer full" comment="The next occurrence according to this recurrence rule."/> - <comment xml:space="preserve">Get the next occurrence from an iterator.</comment> + <comment xml:space="preserve">Gets the next occurrence from an iterator.</comment> </method> <method name="i_cal_recur_iterator_set_start" corresponds="icalrecur_iterator_set_start" since="3.0"> <parameter type="ICalRecurIterator *" name="iterator" comment="The iterator."/> <parameter type="ICalTime *" name="start" comment="The date-time to move the iterator to."/> <returns type="gint" comment="1 if succeeded, 0 if failed, like when the recurrence type is unsupported."/> - <comment xml:space="preserve">Set the date-time at which the iterator will start, where 'start' is a value between DTSTART and UNTIL. + <comment xml:space="preserve">Sets the date-time at which the iterator will start, where 'start' is a value between DTSTART and UNTIL. Note: CAN NOT be used with RRULEs that contain COUNT.</comment> </method> <method name="i_cal_recur_iterator_free" corresponds="icalrecur_iterator_free" annotation="skip" kind="destructor" since="1.0"> diff --git a/src/libical-glib/api/i-cal-recurrence.xml b/src/libical-glib/api/i-cal-recurrence.xml index 1d5d71a6..205d6737 100644 --- a/src/libical-glib/api/i-cal-recurrence.xml +++ b/src/libical-glib/api/i-cal-recurrence.xml @@ -66,7 +66,7 @@ </method> <method name="i_cal_recurrence_rscale_supported_calendars" corresponds="icalrecurrencetype_rscale_supported_calendars" kind="other" since="2.0"> <returns type="ICalArray *" annotation="transfer full" translator_argus="NULL, FALSE" comment="Array of calendars. Currently always NULL."/> - <comment xml:space="preserve">Get an array of calendars supporting rscale (currently always return NULL).</comment> + <comment xml:space="preserve">Gets an array of calendars supporting rscale (currently always return NULL).</comment> </method> <method name="i_cal_recurrence_new_default" corresponds="CUSTOM" annotation="skip" kind="private" since="1.0"> <returns type="struct icalrecurrencetype" comment="The default value."/> @@ -76,7 +76,7 @@ </method> <method name="i_cal_recurrence_new" corresponds="CUSTOM" kind="constructor" since="1.0"> <returns type="ICalRecurrence *" annotation="transfer full" comment="The newly created #ICalRecurrence." /> - <comment xml:space="preserve">Create a new #ICalRecurrence.</comment> + <comment xml:space="preserve">Creates a new #ICalRecurrence.</comment> <custom> return i_cal_recurrence_new_full(i_cal_recurrence_new_default());</custom> </method> <method name="i_cal_recurrence_clear" corresponds="icalrecurrencetype_clear" since="1.0"> @@ -115,14 +115,14 @@ <method name="i_cal_recurrence_get_until" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="ICalTime *" annotation="transfer full" comment="The until of #ICalRecurrence."/> - <comment>Get the until from #ICalRecurrence.</comment> + <comment>Gets the until from #ICalRecurrence.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); return i_cal_time_new_full (((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->until);</custom> </method> <method name="i_cal_recurrence_set_until" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="ICalTime *" name="until" comment="The until of #ICalRecurrence."/> - <comment>Set the until from #ICalRecurrence.</comment> + <comment>Sets the until from #ICalRecurrence.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (until != NULL && I_CAL_IS_TIME(until)); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->until = *(icaltimetype *)i_cal_object_get_native ((ICalObject *)until);</custom> @@ -130,63 +130,63 @@ <method name="i_cal_recurrence_get_freq" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="ICalRecurrenceFrequency" comment="The freq of #ICalRecurrence."/> - <comment>Get the freq from #ICalRecurrence.</comment> + <comment>Gets the freq from #ICalRecurrence.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_NO_RECURRENCE); return (ICalRecurrenceFrequency) (((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->freq);</custom> </method> <method name="i_cal_recurrence_set_freq" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="ICalRecurrenceFrequency" name="freq" comment="The freq of #ICalRecurrence."/> - <comment>Set the freq from #ICalRecurrence.</comment> + <comment>Sets the freq from #ICalRecurrence.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); ((struct icalrecurrencetype *) i_cal_object_get_native ((ICalObject *)recur))->freq = (icalrecurrencetype_frequency) freq;</custom> </method> <method name="i_cal_recurrence_get_count" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="gint" comment="The count of #ICalRecurrence."/> - <comment>Get the count from #ICalRecurrence.</comment> + <comment>Gets the count from #ICalRecurrence.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), 0); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->count;</custom> </method> <method name="i_cal_recurrence_set_count" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="gint" name="count" comment="The count of #ICalRecurrence."/> - <comment>Set the count from #ICalRecurrence.</comment> + <comment>Sets the count from #ICalRecurrence.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->count = count;</custom> </method> <method name="i_cal_recurrence_get_interval" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="gshort" comment="The interval of #ICalRecurrence."/> - <comment>Get the interval from #ICalRecurrence.</comment> + <comment>Gets the interval from #ICalRecurrence.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), 0); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->interval;</custom> </method> <method name="i_cal_recurrence_set_interval" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="gshort" name="interval" comment="The interval of #ICalRecurrence."/> - <comment>Set the interval from #ICalRecurrence.</comment> + <comment>Sets the interval from #ICalRecurrence.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->interval = interval;</custom> </method> <method name="i_cal_recurrence_get_week_start" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="ICalRecurrenceWeekday" comment="The week_start of #ICalRecurrence."/> - <comment>Get the week_start from #ICalRecurrence.</comment> + <comment>Gets the week_start from #ICalRecurrence.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_NO_WEEKDAY); return (ICalRecurrenceWeekday) (((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->week_start);</custom> </method> <method name="i_cal_recurrence_set_week_start" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="ICalRecurrenceWeekday" name="week_start" comment="The week_start of #ICalRecurrence."/> - <comment>Set the week_start from #ICalRecurrence.</comment> + <comment>Sets the week_start from #ICalRecurrence.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->week_start = (icalrecurrencetype_weekday) week_start;</custom> </method> <method name="i_cal_recurrence_get_by_second_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_second of #ICalRecurrence."/> - <comment>Get the by_second array from #ICalRecurrence. The array size if I_CAL_BY_SECOND_SIZE.</comment> + <comment>Gets the by_second array from #ICalRecurrence. The array size if I_CAL_BY_SECOND_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, TRUE, sizeof (gshort)); @@ -196,7 +196,7 @@ <method name="i_cal_recurrence_set_by_second_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_second array in @recur at once. The array size can be less than I_CAL_BY_SECOND_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_second array in @recur at once. The array size can be less than I_CAL_BY_SECOND_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -216,7 +216,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_second of #ICalRecurrence, less than %I_CAL_BY_SECOND_SIZE."/> <returns type="gshort" comment="The by_second of #ICalRecurrence at index @index."/> - <comment>Get the by_second value at index @index. The index should be less than %I_CAL_BY_SECOND_SIZE.</comment> + <comment>Gets the by_second value at index @index. The index should be less than %I_CAL_BY_SECOND_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_SECOND_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_second[index];</custom> @@ -225,7 +225,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_second of #ICalRecurrence, less than I_CAL_BY_SECOND_SIZE."/> <parameter type="gshort" name="value" comment="The value to be set into by_second of #ICalRecurrence."/> - <comment>Set the by_second array from #ICalRecurrence at the given index. The array size is I_CAL_BY_SECOND_SIZE.</comment> + <comment>Sets the by_second array from #ICalRecurrence at the given index. The array size is I_CAL_BY_SECOND_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_SECOND_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_second[index] = value;</custom> @@ -233,7 +233,7 @@ <method name="i_cal_recurrence_get_by_minute_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_minute of #ICalRecurrence."/> - <comment>Get the by_minute array from #ICalRecurrence. The array size is I_CAL_BY_MINUTE_SIZE.</comment> + <comment>Gets the by_minute array from #ICalRecurrence. The array size is I_CAL_BY_MINUTE_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -243,7 +243,7 @@ <method name="i_cal_recurrence_set_by_minute_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_minute array in @recur at once. The array size can be less than I_CAL_BY_MINUTE_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_minute array in @recur at once. The array size can be less than I_CAL_BY_MINUTE_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -263,7 +263,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_minute of #ICalRecurrence, less than %I_CAL_BY_MINUTE_SIZE."/> <returns type="gshort" comment="The by_minute of #ICalRecurrence at index @index."/> - <comment>Get the by_minute value at index @index. The index should be less than %I_CAL_BY_MINUTE_SIZE.</comment> + <comment>Gets the by_minute value at index @index. The index should be less than %I_CAL_BY_MINUTE_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_MINUTE_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_minute[index];</custom> @@ -272,7 +272,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_minute of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_minute of #ICalRecurrence."/> - <comment>Set the by_minute array from #ICalRecurrence at the given index. The array size is I_CAL_BY_MINUTE_SIZE.</comment> + <comment>Sets the by_minute array from #ICalRecurrence at the given index. The array size is I_CAL_BY_MINUTE_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_MINUTE_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_minute[index] = value;</custom> @@ -280,7 +280,7 @@ <method name="i_cal_recurrence_get_by_hour_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_hour of #ICalRecurrence."/> - <comment>Get the by_hour array from #ICalRecurrence. The array size is I_CAL_BY_HOUR_SIZE.</comment> + <comment>Gets the by_hour array from #ICalRecurrence. The array size is I_CAL_BY_HOUR_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -290,7 +290,7 @@ <method name="i_cal_recurrence_set_by_hour_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_hour array in @recur at once. The array size can be less than I_CAL_BY_HOUR_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_hour array in @recur at once. The array size can be less than I_CAL_BY_HOUR_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -310,7 +310,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_hour of #ICalRecurrence, less than %I_CAL_BY_HOUR_SIZE."/> <returns type="gshort" comment="The by_hour of #ICalRecurrence at index @index."/> - <comment>Get the by_hour value at index @index. The index should be less than %I_CAL_BY_HOUR_SIZE.</comment> + <comment>Gets the by_hour value at index @index. The index should be less than %I_CAL_BY_HOUR_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_HOUR_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_hour[index];</custom> @@ -319,7 +319,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_hour of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_hour of #ICalRecurrence."/> - <comment>Set the by_hour array from #ICalRecurrence at the given index. The array size is I_CAL_BY_HOUR_SIZE.</comment> + <comment>Sets the by_hour array from #ICalRecurrence at the given index. The array size is I_CAL_BY_HOUR_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_HOUR_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_hour[index] = value;</custom> @@ -327,7 +327,7 @@ <method name="i_cal_recurrence_get_by_day_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_day of #ICalRecurrence."/> - <comment>Get the by_day array from #ICalRecurrence. The array size is I_CAL_BY_DAY_SIZE.</comment> + <comment>Gets the by_day array from #ICalRecurrence. The array size is I_CAL_BY_DAY_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -337,7 +337,7 @@ <method name="i_cal_recurrence_set_by_day_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_day array in @recur at once. The array size can be less than I_CAL_BY_DAY_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_day array in @recur at once. The array size can be less than I_CAL_BY_DAY_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -357,7 +357,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_day of #ICalRecurrence, less than %I_CAL_BY_DAY_SIZE."/> <returns type="gshort" comment="The by_day of #ICalRecurrence at index @index."/> - <comment>Get the by_day value at index @index. The index should be less than %I_CAL_BY_DAY_SIZE.</comment> + <comment>Gets the by_day value at index @index. The index should be less than %I_CAL_BY_DAY_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_DAY_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_day[index];</custom> @@ -366,7 +366,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_day of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_day of #ICalRecurrence."/> - <comment>Set the by_day array from #ICalRecurrence at the given index. The array size if I_CAL_BY_DAY_SIZE.</comment> + <comment>Sets the by_day array from #ICalRecurrence at the given index. The array size if I_CAL_BY_DAY_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_DAY_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_day[index] = value;</custom> @@ -374,7 +374,7 @@ <method name="i_cal_recurrence_get_by_month_day_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_month_day of #ICalRecurrence."/> - <comment>Get the by_month_day array from #ICalRecurrence. The array size is I_CAL_BY_MONTHDAY_SIZE.</comment> + <comment>Gets the by_month_day array from #ICalRecurrence. The array size is I_CAL_BY_MONTHDAY_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -384,7 +384,7 @@ <method name="i_cal_recurrence_set_by_month_day_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_month_day array in @recur at once. The array size can be less than I_CAL_BY_MONTHDAY_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_month_day array in @recur at once. The array size can be less than I_CAL_BY_MONTHDAY_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -404,7 +404,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_month_day of #ICalRecurrence, less than %I_CAL_BY_MONTHDAY_SIZE."/> <returns type="gshort" comment="The by_month_day of #ICalRecurrence at index @index."/> - <comment>Get the by_month_day value at index @index. The index should be less than %I_CAL_BY_MONTHDAY_SIZE.</comment> + <comment>Gets the by_month_day value at index @index. The index should be less than %I_CAL_BY_MONTHDAY_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_MONTHDAY_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_month_day[index];</custom> @@ -413,7 +413,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_month_day of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_month_day of #ICalRecurrence."/> - <comment>Set the by_month_day array from #ICalRecurrence at the given index. The array size if I_CAL_BY_MONTHDAY_SIZE.</comment> + <comment>Sets the by_month_day array from #ICalRecurrence at the given index. The array size if I_CAL_BY_MONTHDAY_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_MONTHDAY_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_month_day[index] = value;</custom> @@ -421,7 +421,7 @@ <method name="i_cal_recurrence_get_by_year_day_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_year_day of #ICalRecurrence."/> - <comment>Get the by_year_day array from #ICalRecurrence. The array size is I_CAL_BY_YEARDAY_SIZE.</comment> + <comment>Gets the by_year_day array from #ICalRecurrence. The array size is I_CAL_BY_YEARDAY_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -431,7 +431,7 @@ <method name="i_cal_recurrence_set_by_year_day_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_year_day array in @recur at once. The array size can be less than I_CAL_BY_YEARDAY_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_year_day array in @recur at once. The array size can be less than I_CAL_BY_YEARDAY_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -451,7 +451,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_year_day of #ICalRecurrence, less than %I_CAL_BY_YEARDAY_SIZE."/> <returns type="gshort" comment="The by_year_day of #ICalRecurrence at index @index."/> - <comment>Get the by_year_day value at index @index. The index should be less than %I_CAL_BY_YEARDAY_SIZE.</comment> + <comment>Gets the by_year_day value at index @index. The index should be less than %I_CAL_BY_YEARDAY_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_YEARDAY_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_year_day[index];</custom> @@ -460,7 +460,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_year_day of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_year_day of #ICalRecurrence."/> - <comment>Set the by_year_day array from #ICalRecurrence at the given index. The array size if I_CAL_BY_YEARDAY_SIZE.</comment> + <comment>Sets the by_year_day array from #ICalRecurrence at the given index. The array size if I_CAL_BY_YEARDAY_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_YEARDAY_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_year_day[index] = value;</custom> @@ -468,7 +468,7 @@ <method name="i_cal_recurrence_get_by_week_no_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_week_no of #ICalRecurrence."/> - <comment>Get the by_week_no array from #ICalRecurrence. The array size is I_CAL_BY_WEEKNO_SIZE.</comment> + <comment>Gets the by_week_no array from #ICalRecurrence. The array size is I_CAL_BY_WEEKNO_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -478,7 +478,7 @@ <method name="i_cal_recurrence_set_by_week_no_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_week_no array in @recur at once. The array size can be less than I_CAL_BY_WEEKNO_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_week_no array in @recur at once. The array size can be less than I_CAL_BY_WEEKNO_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -498,7 +498,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_week_no of #ICalRecurrence, less than %I_CAL_BY_WEEKNO_SIZE."/> <returns type="gshort" comment="The by_week_no of #ICalRecurrence at index @index."/> - <comment>Get the by_week_no value at index @index. The index should be less than %I_CAL_BY_WEEKNO_SIZE.</comment> + <comment>Gets the by_week_no value at index @index. The index should be less than %I_CAL_BY_WEEKNO_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_WEEKNO_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_week_no[index];</custom> @@ -507,7 +507,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_week_no of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_week_no of #ICalRecurrence."/> - <comment>Set the by_week_no array from #ICalRecurrence at the given index. The array size is I_CAL_BY_WEEKNO_SIZE.</comment> + <comment>Sets the by_week_no array from #ICalRecurrence at the given index. The array size is I_CAL_BY_WEEKNO_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_WEEKNO_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_week_no[index] = value;</custom> @@ -515,7 +515,7 @@ <method name="i_cal_recurrence_get_by_month_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_month of #ICalRecurrence."/> - <comment>Get the by_month array from #ICalRecurrence. The array size is I_CAL_BY_MONTH_SIZE.</comment> + <comment>Gets the by_month array from #ICalRecurrence. The array size is I_CAL_BY_MONTH_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -525,7 +525,7 @@ <method name="i_cal_recurrence_set_by_month_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_month array in @recur at once. The array size can be less than I_CAL_BY_MONTH_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_month array in @recur at once. The array size can be less than I_CAL_BY_MONTH_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -545,7 +545,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_month of #ICalRecurrence, less than %I_CAL_BY_MONTH_SIZE."/> <returns type="gshort" comment="The by_month of #ICalRecurrence at index @index."/> - <comment>Get the by_month value at index @index. The index should be less than %I_CAL_BY_MONTH_SIZE.</comment> + <comment>Gets the by_month value at index @index. The index should be less than %I_CAL_BY_MONTH_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_MONTH_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_month[index];</custom> @@ -554,7 +554,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_month of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_month of #ICalRecurrence."/> - <comment>Set the by_month array from #ICalRecurrence at the given index. The array size is I_CAL_BY_MONTH_SIZE.</comment> + <comment>Sets the by_month array from #ICalRecurrence at the given index. The array size is I_CAL_BY_MONTH_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_MONTH_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_month[index] = value;</custom> @@ -562,7 +562,7 @@ <method name="i_cal_recurrence_get_by_set_pos_array" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <returns type="GArray *" annotation="transfer full, element-type gshort" comment="The by_set_pos of #ICalRecurrence."/> - <comment>Get the by_set_pos array from #ICalRecurrence. The array size is I_CAL_BY_SETPOS_SIZE.</comment> + <comment>Gets the by_set_pos array from #ICalRecurrence. The array size is I_CAL_BY_SETPOS_SIZE.</comment> <custom> GArray *array; g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), NULL); array = g_array_new (FALSE, FALSE, sizeof (gshort)); @@ -572,7 +572,7 @@ <method name="i_cal_recurrence_set_by_set_pos_array" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="GArray *" name="values" annotation="element-type gshort" comment="The array of values."/> - <comment>Set the by_set_pos array in @recur at once. The array size can be less than I_CAL_BY_SETPOS_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> + <comment>Sets the by_set_pos array in @recur at once. The array size can be less than I_CAL_BY_SETPOS_SIZE. Shorter arrays are terminated with I_CAL_RECURRENCE_ARRAY_MAX value, longer arrays are truncated.</comment> <custom> struct icalrecurrencetype *rt; guint ii; @@ -592,7 +592,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_set_pos of #ICalRecurrence, less than %I_CAL_BY_SETPOS_SIZE."/> <returns type="gshort" comment="The by_week_no of #ICalRecurrence at index @index."/> - <comment>Get the by_set_pos value at index @index. The index should be less than %I_CAL_BY_SETPOS_SIZE.</comment> + <comment>Gets the by_set_pos value at index @index. The index should be less than %I_CAL_BY_SETPOS_SIZE.</comment> <custom> g_return_val_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur), I_CAL_RECURRENCE_ARRAY_MAX); g_return_val_if_fail (index < I_CAL_BY_SETPOS_SIZE, I_CAL_RECURRENCE_ARRAY_MAX); return ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_set_pos[index];</custom> @@ -601,7 +601,7 @@ <parameter type="ICalRecurrence *" name="recur" comment="The #ICalRecurrence."/> <parameter type="guint" name="index" comment="The index in by_set_pos of #ICalRecurrence."/> <parameter type="gshort" name="value" comment="The value to be set into by_set_pos of #ICalRecurrence."/> - <comment>Set the by_set_pos array from #ICalRecurrence at the given index. The array size is I_CAL_BY_SETPOS_SIZE.</comment> + <comment>Sets the by_set_pos array from #ICalRecurrence at the given index. The array size is I_CAL_BY_SETPOS_SIZE.</comment> <custom> g_return_if_fail (recur != NULL && I_CAL_IS_RECURRENCE (recur)); g_return_if_fail (index < I_CAL_BY_SETPOS_SIZE); ((struct icalrecurrencetype *)i_cal_object_get_native ((ICalObject *)recur))->by_set_pos[index] = value;</custom> diff --git a/src/libical-glib/api/i-cal-reqstat.xml b/src/libical-glib/api/i-cal-reqstat.xml index 4b3f3023..38fce2fe 100644 --- a/src/libical-glib/api/i-cal-reqstat.xml +++ b/src/libical-glib/api/i-cal-reqstat.xml @@ -17,7 +17,7 @@ <method name="i_cal_reqstat_new_from_string" corresponds="icalreqstattype_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="str" comment="A string."/> <returns type="ICalReqstat *" annotation="transfer full" comment="The newly created #ICalReqstat."/> - <comment xml:space="preserve">Create a #ICalReqstat from string.</comment> + <comment xml:space="preserve">Creates a #ICalReqstat from string.</comment> </method> <method name="i_cal_reqstat_to_string" corresponds="icalreqstattype_as_string_r" since="1.0"> <parameter type="ICalReqstat *" name="stat" comment="A #ICalReqstat."/> @@ -26,7 +26,7 @@ </method> <method name="i_cal_reqstat_new_default" corresponds="CUSTOM" kind="private" annotation="skip" since="1.0"> <returns type="struct icalreqstattype" annotation="transfer full" comment="The newly created #ICalReqstat" /> - <comment xml:space="preserve">Create a new default #ICalReqstat</comment> + <comment xml:space="preserve">Creates a new default #ICalReqstat</comment> <custom> struct icalreqstattype reqstattype; reqstattype.code = ICAL_UNKNOWN_STATUS; reqstattype.desc = NULL; @@ -36,28 +36,28 @@ <method name="i_cal_reqstat_get_code" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalReqstat *" name="reqstat" comment="The #ICalReqstat."/> <returns type="ICalRequestStatus" comment="The code of @reqstat."/> - <comment>Get the code of #ICalReqstat.</comment> + <comment>Gets the code of #ICalReqstat.</comment> <custom> g_return_val_if_fail (reqstat != NULL && I_CAL_IS_REQSTAT (reqstat), I_CAL_UNKNOWN_STATUS); return (ICalRequestStatus) (((struct icalreqstattype *)i_cal_object_get_native ((ICalObject *)reqstat))->code);</custom> </method> <method name="i_cal_reqstat_set_code" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalReqstat *" name="reqstat" comment="The #ICalReqstat."/> <parameter type="ICalRequestStatus" name="code" comment="The code of @reqstat."/> - <comment>Set the code of #ICalReqstat.</comment> + <comment>Sets the code of #ICalReqstat.</comment> <custom> g_return_if_fail (reqstat != NULL && I_CAL_IS_REQSTAT (reqstat)); ((struct icalreqstattype *)i_cal_object_get_native ((ICalObject *)reqstat))->code = (icalrequeststatus) (code);</custom> </method> <method name="i_cal_reqstat_get_desc" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalReqstat *" name="reqstat" comment="The #ICalReqstat."/> <returns type="const gchar *" annotation="transfer none" comment="The desc of @reqstat."/> - <comment>Get the desc of #ICalReqstat.</comment> + <comment>Gets the desc of #ICalReqstat.</comment> <custom> g_return_val_if_fail (reqstat != NULL && I_CAL_IS_REQSTAT (reqstat), NULL); return ((struct icalreqstattype *)i_cal_object_get_native ((ICalObject *)reqstat))->desc;</custom> </method> <method name="i_cal_reqstat_get_debug" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalReqstat *" name="reqstat" comment="The #ICalReqstat."/> <returns type="const gchar *" annotation="transfer none" comment="The debug of @reqstat."/> - <comment>Get the debug of #ICalReqstat.</comment> + <comment>Gets the debug of #ICalReqstat.</comment> <custom> g_return_val_if_fail (reqstat != NULL && I_CAL_IS_REQSTAT (reqstat), NULL); return ((struct icalreqstattype *)i_cal_object_get_native ((ICalObject *)reqstat))->debug;</custom> </method> diff --git a/src/libical-glib/api/i-cal-time-span.xml b/src/libical-glib/api/i-cal-time-span.xml index 96ae1704..e51494fc 100644 --- a/src/libical-glib/api/i-cal-time-span.xml +++ b/src/libical-glib/api/i-cal-time-span.xml @@ -19,7 +19,7 @@ <parameter type="time_t" name="end" comment="End of the time span."/> <parameter type="gboolean" name="is_busy" comment="Whether the time span is busy."/> <returns type="ICalTimeSpan *" annotation="transfer full" comment="The newly created #ICalTimeSpan." /> - <comment xml:space="preserve">Create a new #ICalTimeSpan. Free it with g_object_unref(), when no longer needed.</comment> + <comment xml:space="preserve">Creates a new #ICalTimeSpan. Free it with g_object_unref(), when no longer needed.</comment> <custom> struct icaltime_span span; span.start = start; span.end = end; @@ -29,7 +29,7 @@ <method name="i_cal_time_span_clone" corresponds="CUSTOM" kind="constructor" since="3.0.5"> <parameter type="const ICalTimeSpan *" name="src" comment="A time span to clone."/> <returns type="ICalTimeSpan *" annotation="transfer full" comment="The newly created #ICalTimeSpan, clone of @src." /> - <comment xml:space="preserve">Create a new #ICalTimeSpan, clone of @src. Free it with g_object_unref(), when no longer needed.</comment> + <comment xml:space="preserve">Creates a new #ICalTimeSpan, clone of @src. Free it with g_object_unref(), when no longer needed.</comment> <custom> struct icaltime_span *span; g_return_val_if_fail(I_CAL_IS_TIME_SPAN(src), NULL); span = ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)src)); @@ -39,42 +39,42 @@ <method name="i_cal_time_span_get_start" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalTimeSpan *" name="timespan" comment="The #ICalTimeSpan to be queried."/> <returns type="time_t" comment="The start." /> - <comment xml:space="preserve">Get the start of #ICalTimeSpan.</comment> + <comment xml:space="preserve">Gets the start of #ICalTimeSpan.</comment> <custom> g_return_val_if_fail (timespan != NULL, 0); return ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)timespan))->start;</custom> </method> <method name="i_cal_time_span_set_start" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTimeSpan *" name="timespan" comment="The #ICalTimeSpan to be set."/> <parameter type="time_t" name="start" comment="The start." /> - <comment xml:space="preserve">Set the start of #ICalTimeSpan.</comment> + <comment xml:space="preserve">Sets the start of #ICalTimeSpan.</comment> <custom> g_return_if_fail (timespan != NULL); ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)timespan))->start = start;</custom> </method> <method name="i_cal_time_span_get_end" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalTimeSpan *" name="timespan" comment="The #ICalTimeSpan to be queried."/> <returns type="time_t" comment="The end." /> - <comment xml:space="preserve">Get the end of #ICalTimeSpan.</comment> + <comment xml:space="preserve">Gets the end of #ICalTimeSpan.</comment> <custom> g_return_val_if_fail (timespan != NULL, 0); return ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)timespan))->end;</custom> </method> <method name="i_cal_time_span_set_end" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTimeSpan *" name="timespan" comment="The #ICalTimeSpan to be set."/> <parameter type="time_t" name="end" comment="The end." /> - <comment xml:space="preserve">Set the end of #ICalTimeSpan.</comment> + <comment xml:space="preserve">Sets the end of #ICalTimeSpan.</comment> <custom> g_return_if_fail (timespan != NULL); ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)timespan))->end = end;</custom> </method> <method name="i_cal_time_span_get_is_busy" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalTimeSpan *" name="timespan" comment="The #ICalTimeSpan to be queried."/> <returns type="gboolean" comment="The is_busy." /> - <comment xml:space="preserve">Get the is_busy of #ICalTimeSpan.</comment> + <comment xml:space="preserve">Gets the is_busy of #ICalTimeSpan.</comment> <custom> g_return_val_if_fail (timespan != NULL, FALSE); return ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)timespan))->is_busy != 0;</custom> </method> <method name="i_cal_time_span_set_is_busy" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTimeSpan *" name="timespan" comment="The #ICalTimeSpan to be set."/> <parameter type="gboolean" name="is_busy" comment="The is_busy." /> - <comment xml:space="preserve">Set the is_busy of #ICalTimeSpan.</comment> + <comment xml:space="preserve">Sets the is_busy of #ICalTimeSpan.</comment> <custom> g_return_if_fail (timespan != NULL); ((struct icaltime_span *)i_cal_object_get_native ((ICalObject *)timespan))->is_busy = is_busy ? 1 : 0;</custom> </method> diff --git a/src/libical-glib/api/i-cal-time.xml b/src/libical-glib/api/i-cal-time.xml index 7c162322..a87d7131 100644 --- a/src/libical-glib/api/i-cal-time.xml +++ b/src/libical-glib/api/i-cal-time.xml @@ -16,13 +16,13 @@ <structure namespace="ICal" name="Time" native="struct icaltimetype" is_bare="true" default_native="icaltime_null_time()"> <method name="i_cal_time_new" corresponds="CUSTOM" kind="constructor" since="1.0"> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime. It is a null time" /> - <comment xml:space="preserve">Create a new #ICalTime.</comment> + <comment xml:space="preserve">Creates a new #ICalTime.</comment> <custom> return i_cal_time_new_full(icaltime_null_time());</custom> </method> <method name="i_cal_time_clone" corresponds="CUSTOM" kind="constructor" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to clone."/> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime, copy of @timetype." /> - <comment xml:space="preserve">Create a new #ICalTime, copy of @timetype.</comment> + <comment xml:space="preserve">Creates a new #ICalTime, copy of @timetype.</comment> <custom> struct icaltimetype *itt; g_return_val_if_fail(I_CAL_IS_TIME(timetype), NULL); @@ -34,20 +34,20 @@ </method> <method name="i_cal_time_new_null_time" corresponds="icaltime_null_time" kind="constructor" since="1.0"> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime" /> - <comment xml:space="preserve">Create a default time which is an epoch time</comment> + <comment xml:space="preserve">Creates a default time which is an epoch time</comment> </method> <method name="i_cal_time_new_null_date" corresponds="icaltime_null_date" kind="constructor" since="1.0"> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime" /> - <comment xml:space="preserve">Create a null date, which indicates no time has been set</comment> + <comment xml:space="preserve">Creates a null date, which indicates no time has been set</comment> </method> <method name="i_cal_time_new_current_with_zone" corresponds="icaltime_current_time_with_zone" kind="others" since="1.0"> <parameter type="ICalTimezone *" name="zone" annotation="nullable" comment="The timezone used to create a #ICalTime according to the current time"/> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime" /> - <comment xml:space="preserve">Create a #ICalTime according to the timezone and current time</comment> + <comment xml:space="preserve">Creates a #ICalTime according to the timezone and current time</comment> </method> <method name="i_cal_time_new_today" corresponds="icaltime_today" kind="others" since="1.0"> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime" /> - <comment xml:space="preserve">Create a #ICalTime representing today</comment> + <comment xml:space="preserve">Creates a #ICalTime representing today</comment> </method> <method name="i_cal_time_new_from_timet_with_zone" corresponds="icaltime_from_timet_with_zone" kind="others" since="1.0"> <parameter type="const time_t" name="v" comment="The seconds past since epoch time"/> @@ -59,75 +59,75 @@ <method name="i_cal_time_new_from_string" corresponds="icaltime_from_string" kind="others" since="1.0"> <parameter type="const gchar *" name="str" comment="The ISO format string"/> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime" /> - <comment xml:space="preserve">create a time from an ISO format string</comment> + <comment xml:space="preserve">Creates a time from an ISO format string</comment> </method> <method name="i_cal_time_new_from_day_of_year" corresponds="icaltime_from_day_of_year" kind="constructor" since="1.0"> <parameter type="const gint" name="day" comment="The day of a year"/> <parameter type="const gint" name="year" comment="The year"/> <returns type="ICalTime *" annotation="transfer full" comment="The newly created #ICalTime" /> - <comment xml:space="preserve">Create a new time, given a day of year and a year.</comment> + <comment xml:space="preserve">Creates a new time, given a day of year and a year.</comment> </method> <method name="i_cal_time_as_timet" corresponds="icaltime_as_timet" since="1.0"> <parameter type="const ICalTime *" name="tt" comment="The #ICalTime to be converted"/> <returns type="time_t" comment="the time as seconds past the UNIX epoch" /> - <comment xml:space="preserve">Return the time as seconds past the UNIX epoch</comment> + <comment xml:space="preserve">Returns the time as seconds past the UNIX epoch</comment> </method> <method name="i_cal_time_as_timet_with_zone" corresponds="icaltime_as_timet_with_zone" since="1.0"> <parameter type="const ICalTime *" name="tt" comment="The #ICalTime to be converted"/> <parameter type="const ICalTimezone *" name="zone" annotation="nullable" comment="The timezone"/> <returns type="time_t" comment="the time as seconds past the UNIX epoch" /> - <comment xml:space="preserve">Return the time as seconds past the UNIX epoch, using timezones.</comment> + <comment xml:space="preserve">Returns the time as seconds past the UNIX epoch, using timezones.</comment> </method> <method name="i_cal_time_as_ical_string" corresponds="icaltime_as_ical_string_r" since="1.0"> <parameter type="const ICalTime *" name="tt" comment="The #ICalTime to be converted"/> <returns type="gchar *" annotation="transfer full" comment="The string representation" /> - <comment xml:space="preserve">Return a string represention of the time, in RFC2445 format.</comment> + <comment xml:space="preserve">Returns a string represention of the time, in RFC2445 format.</comment> </method> <method name="i_cal_time_get_timezone" corresponds="(void *)icaltime_get_timezone" kind="get" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/> <returns type="ICalTimezone *" annotation="transfer none" translator_argus="(GObject *)tt, TRUE" comment="The timezone information" /> - <comment xml:space="preserve">Return the timezone</comment> + <comment xml:space="preserve">Returns the timezone</comment> </method> <method name="i_cal_time_set_timezone" corresponds="icaltime_set_timezone" kind="set" since="1.0"> <parameter type="ICalTime *" name="tt" native_op="POINTER" comment="The #ICalTime"/> <parameter type="const ICalTimezone *" name="zone" annotation="nullable" comment="The timezone"/> - <comment xml:space="preserve">Set the timezone of the @tt</comment> + <comment xml:space="preserve">Sets the timezone of the @tt</comment> </method> <method name="i_cal_time_get_tzid" corresponds="icaltime_get_tzid" kind="get" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/> <returns type="const gchar *" annotation="allow-none, transfer none" comment="The tzid of #ICalTime, or NULL if floating type" /> - <comment xml:space="preserve">Return the tzid, or NULL for a floating time</comment> + <comment xml:space="preserve">Returns the tzid, or NULL for a floating time</comment> </method> <method name="i_cal_time_day_of_year" corresponds="icaltime_day_of_year" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/> <returns type="gint" comment="the day of the year of the given time" /> - <comment xml:space="preserve">Return the day of the year of the given time</comment> + <comment xml:space="preserve">Returns the day of the year of the given time</comment> </method> <method name="i_cal_time_day_of_week" corresponds="icaltime_day_of_week" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/> <returns type="gint" comment="the day of the week of the given time. Sunday is 1." /> - <comment xml:space="preserve">Return the day of the week of the given time. Sunday is 1</comment> + <comment xml:space="preserve">Returns the day of the week of the given time. Sunday is 1</comment> </method> <method name="i_cal_time_start_doy_week" corresponds="icaltime_start_doy_week" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/> <parameter type="gint" name="fdow" comment="The first day of the week" /> <returns type="gint" comment="the day of the year for the Sunday of the week that the given time is within." /> - <comment xml:space="preserve">Return the day of the year for the first day of the week that the given time is within.</comment> + <comment xml:space="preserve">Returns the day of the year for the first day of the week that the given time is within.</comment> </method> <method name="i_cal_time_week_number" corresponds="icaltime_week_number" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/> <returns type="gint" comment="the week number for the week the given time is within." /> - <comment xml:space="preserve">Return the week number for the week the given time is within.</comment> + <comment xml:space="preserve">Returns the week number for the week the given time is within.</comment> </method> <method name="i_cal_time_is_null_time" corresponds="icaltime_is_null_time" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be checked"/> <returns type="gboolean" comment="Whether @tt is null_time. 1 if yes, 0 if not." /> - <comment xml:space="preserve">Return true if the time is null.</comment> + <comment xml:space="preserve">Returns true if the time is null.</comment> </method> <method name="i_cal_time_is_valid_time" corresponds="icaltime_is_valid_time" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be checked"/> <returns type="gboolean" comment="Whether @tt is null_time. 1 if yes, 0 if not." /> - <comment xml:space="preserve">Return true if the time is null.</comment> + <comment xml:space="preserve">Returns true if the time is null.</comment> </method> <method name="i_cal_time_is_date" corresponds="icaltime_is_date" since="1.0"> <parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be checked"/> @@ -143,7 +143,7 @@ <parameter type="const ICalTime *" name="a" annotation="in, transfer none" comment="The #ICalTime to be compared"/> <parameter type="const ICalTime *" name="b" annotation="in, transfer none" comment="The #ICalTime to be compared"/> <returns type="gint" comment="-1, 0, or 1 to indicate that a less than b, a==b or a larger than b." /> - <comment xml:space="preserve">Return -1, 0, or 1 to indicate that a less than b, a==b or a larger than b.</comment> + <comment xml:space="preserve">Returns -1, 0, or 1 to indicate that a less than b, a==b or a larger than b.</comment> </method> <method name="i_cal_time_compare_date_only" corresponds="icaltime_compare_date_only" since="1.0"> <parameter type="const ICalTime *" name="a" annotation="in, transfer none" comment="The #ICalTime to be compared"/> @@ -208,7 +208,7 @@ <parameter type="gint" name="month" comment="The target month"/> <parameter type="gint" name="year" comment="The target year"/> <returns type="gint" comment="The number of days in the target month in the target year." /> - <comment xml:space="preserve">Get the number of days in the target month in the target year.</comment> + <comment xml:space="preserve">Gets the number of days in the target month in the target year.</comment> </method> <method name="i_cal_time_days_is_leap_year" corresponds="icaltime_is_leap_year" since="1.0"> <parameter type="gint" name="year" comment="The target year"/> @@ -218,14 +218,14 @@ <method name="i_cal_time_days_in_year" corresponds="icaltime_days_in_year" since="2.0"> <parameter type="gint" name="year" comment="The target year"/> <returns type="gint" comment="Days in this year." /> - <comment xml:space="preserve">Return the number of days in this year.</comment> + <comment xml:space="preserve">Returns the number of days in this year.</comment> </method> <method name="i_cal_time_span_new" corresponds="icaltime_span_new" kind="constructor" since="1.0"> <parameter type="ICalTime *" name="dtstart" comment="The start of #ICalTimeSpan"/> <parameter type="ICalTime *" name="dtend" comment="The end of #ICalTimeSpan"/> <parameter type="gint" name="is_busy" comment="Whether this span is busy"/> <returns type="ICalTimeSpan *" annotation="transfer full" comment="The newly create #ICalTimeSpan"/> - <comment xml:space="preserve">Create a new #ICalTimeSpan.</comment> + <comment xml:space="preserve">Creates a new #ICalTimeSpan.</comment> </method> <method name="i_cal_time_span_overlaps" corresponds="icaltime_span_overlaps" kind="other" since="1.0"> <parameter type="ICalTimeSpan *" name="s1" native_op="POINTER" comment="The first #ICalTimeSpan"/> @@ -249,110 +249,110 @@ <parameter type="ICalTime *" name="t1" comment="The subtracted #ICalTime."/> <parameter type="ICalTime *" name="t2" comment="The subtracting #ICalTime."/> <returns type="ICalDuration *" annotation="transfer full" comment="The #ICalDuration between two #ICalTime."/> - <comment xml:space="preserve">Get the duration between two time.</comment> + <comment xml:space="preserve">Gets the duration between two time.</comment> </method> <method name="i_cal_time_get_year" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gint" comment="The year."/> - <comment xml:space="preserve">Get the year of #ICalTime.</comment> + <comment xml:space="preserve">Gets the year of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->year;</custom> </method> <method name="i_cal_time_set_year" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gint" name="year" comment="The year."/> - <comment>Set the year of #ICalTime.</comment> + <comment>Sets the year of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->year = year;</custom> </method> <method name="i_cal_time_get_month" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gint" comment="The month." /> - <comment xml:space="preserve">Get the month of #ICalTime.</comment> + <comment xml:space="preserve">Gets the month of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->month;</custom> </method> <method name="i_cal_time_set_month" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gint" name="month" comment="The month."/> - <comment>Set the month of #ICalTime.</comment> + <comment>Sets the month of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->month = month;</custom> </method> <method name="i_cal_time_get_day" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gint" comment="The day." /> - <comment xml:space="preserve">Get the day of #ICalTime.</comment> + <comment xml:space="preserve">Gets the day of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->day;</custom> </method> <method name="i_cal_time_set_day" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gint" name="day" comment="The day."/> - <comment>Set the day of #ICalTime.</comment> + <comment>Sets the day of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->day = day;</custom> </method> <method name="i_cal_time_get_hour" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gint" comment="The hour." /> - <comment xml:space="preserve">Get the hour of #ICalTime.</comment> + <comment xml:space="preserve">Gets the hour of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->hour;</custom> </method> <method name="i_cal_time_set_hour" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gint" name="hour" comment="The hour."/> - <comment>Set the hour of #ICalTime.</comment> + <comment>Sets the hour of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->hour = hour;</custom> </method> <method name="i_cal_time_get_minute" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gint" comment="The minute." /> - <comment xml:space="preserve">Get the minute of #ICalTime.</comment> + <comment xml:space="preserve">Gets the minute of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->minute;</custom> </method> <method name="i_cal_time_set_minute" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gint" name="minute" comment="The minute."/> - <comment>Set the minute of #ICalTime.</comment> + <comment>Sets the minute of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->minute = minute;</custom> </method> <method name="i_cal_time_get_second" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gint" comment="The second." /> - <comment xml:space="preserve">Get the second of #ICalTime.</comment> + <comment xml:space="preserve">Gets the second of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->second;</custom> </method> <method name="i_cal_time_set_second" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gint" name="second" comment="The second."/> - <comment>Set the second of #ICalTime.</comment> + <comment>Sets the second of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->second = second;</custom> </method> <method name="i_cal_time_set_is_date" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gboolean" name="is_date" comment="The is_date."/> - <comment>Set the is_date of #ICalTime.</comment> + <comment>Sets the is_date of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->is_date = is_date ? 1 : 0;</custom> </method> <method name="i_cal_time_is_daylight" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="const ICalTime *" name="timetype" comment="The #ICalTime to be queried."/> <returns type="gboolean" comment="The is_daylight." /> - <comment xml:space="preserve">Get the is_daylight of #ICalTime.</comment> + <comment xml:space="preserve">Gets the is_daylight of #ICalTime.</comment> <custom> g_return_val_if_fail (timetype != NULL, 0); return ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->is_daylight;</custom> </method> <method name="i_cal_time_set_is_daylight" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTime *" name="timetype" comment="The #ICalTime to be set."/> <parameter type="gboolean" name="is_daylight" comment="The is_daylight."/> - <comment>Set the is_daylight of #ICalTime.</comment> + <comment>Sets the is_daylight of #ICalTime.</comment> <custom> g_return_if_fail (timetype != NULL && I_CAL_IS_TIME(timetype)); ((struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype))->is_daylight = is_daylight ? 1 : 0;</custom> </method> @@ -361,7 +361,7 @@ <parameter type="gint *" name="year" annotation="out caller-allocates, optional" comment="Out parameter for the 'year' part of the date."/> <parameter type="gint *" name="month" annotation="out caller-allocates, optional" comment="Out parameter for the 'month' part of the date."/> <parameter type="gint *" name="day" annotation="out caller-allocates, optional" comment="Out parameter for the 'day' part of the date."/> - <comment xml:space="preserve">Get the year/month/date parts of the @timetype in one call.</comment> + <comment xml:space="preserve">Gets the year/month/date parts of the @timetype in one call.</comment> <custom> icaltimetype *itt; g_return_if_fail(timetype != NULL); itt = (struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype); @@ -378,7 +378,7 @@ <parameter type="gint" name="year" comment="The 'year' part of the date." /> <parameter type="gint" name="month" comment="The 'month' part of the date." /> <parameter type="gint" name="day" comment="The 'day' part of the date." /> - <comment xml:space="preserve">Set the year/month/date parts of the @timetype in one call. This doesn't verify validity of the given date.</comment> + <comment xml:space="preserve">Sets the year/month/date parts of the @timetype in one call. This doesn't verify validity of the given date.</comment> <custom> icaltimetype *itt; g_return_if_fail(timetype != NULL); itt = (struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype); @@ -392,7 +392,7 @@ <parameter type="gint *" name="hour" annotation="out caller-allocates, optional" comment="Out parameter for the 'hour' part of the time."/> <parameter type="gint *" name="minute" annotation="out caller-allocates, optional" comment="Out parameter for the 'minute' part of the time."/> <parameter type="gint *" name="second" annotation="out caller-allocates, optional" comment="Out parameter for the 'second' part of the time."/> - <comment xml:space="preserve">Get the hour/minute/second parts of the @timetype in one call.</comment> + <comment xml:space="preserve">Gets the hour/minute/second parts of the @timetype in one call.</comment> <custom> icaltimetype *itt; g_return_if_fail(timetype != NULL); itt = (struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype); @@ -409,7 +409,7 @@ <parameter type="gint" name="hour" comment="The 'hour' part of the time." /> <parameter type="gint" name="minute" comment="The 'minute' part of the time." /> <parameter type="gint" name="second" comment="The 'second' part of the time." /> - <comment xml:space="preserve">Set the hour/minute/second parts of the @timetype in one call. This doesn't verify validity of the given time.</comment> + <comment xml:space="preserve">Sets the hour/minute/second parts of the @timetype in one call. This doesn't verify validity of the given time.</comment> <custom> icaltimetype *itt; g_return_if_fail(timetype != NULL); itt = (struct icaltimetype *)i_cal_object_get_native ((ICalObject *)timetype); diff --git a/src/libical-glib/api/i-cal-timezone.xml b/src/libical-glib/api/i-cal-timezone.xml index 476208e3..cab9ca57 100644 --- a/src/libical-glib/api/i-cal-timezone.xml +++ b/src/libical-glib/api/i-cal-timezone.xml @@ -99,7 +99,7 @@ <parameter type="ICalComponent *" name="comp" comment="The VTIMEZONE component of an #ICalTimezone, initializing the tzid, location and tzname fields."/> <returns type="gint" comment="Whether the action is successful. 1 for success, 0 for failure."/> <comment xml:space="preserve">Sets the VTIMEZONE component of #ICalTimezone, initializing the tzid, location and tzname fields. It returns 1 on success or 0 on failure, i.e. no TZID was found. - * + * * @note The @zone assumes ownership of the @comp, thus make sure you pass an unowned #ICalComponent.</comment> <custom xml:space="preserve"> g_return_val_if_fail(I_CAL_IS_TIMEZONE(zone), 0); g_return_val_if_fail(I_CAL_IS_COMPONENT(comp), 0); @@ -111,7 +111,7 @@ <method name="i_cal_timezone_get_display_name" corresponds="icaltimezone_get_display_name" kind="get" since="1.0"> <parameter type="const ICalTimezone *" name="zone" annotation="nullable" comment="The #ICalTimezone to be queried"/> <returns type="const gchar *" comment="The display name of @zone"/> - <comment xml:space="preserve">Get the display name of the @zone.</comment> + <comment xml:space="preserve">Gets the display name of the @zone.</comment> </method> <method name="i_cal_time_convert_timezone" corresponds="icaltimezone_convert_time" kind="other" since="1.0"> <parameter type="ICalTime *" name="tt" native_op="POINTER" comment="The time to be converted"/> @@ -135,7 +135,7 @@ </method> <method name="i_cal_timezone_array_new" corresponds="CUSTOM" kind="other" since="1.0"> <returns type="ICalArray *" annotation="transfer full" translator_argus="NULL, FALSE" comment="Create a new array."/> - <comment xml:space="preserve">Create a new array of timezones.</comment> + <comment xml:space="preserve">Creates a new array of timezones.</comment> <custom> ICalArray *zones_array; zones_array = i_cal_array_new_full(icaltimezone_array_new (), NULL, FALSE); @@ -151,7 +151,7 @@ <parameter type="ICalArray *" name="timezones" comment="The timezones to be populated"/> <parameter type="ICalComponent *" name="child" comment="The component to be appended to @timezones."/> <comment>Populate the array of timezones with a component. - * + * * @note The @timezones assumes ownership of the @child, thus make sure you pass an unowned #ICalComponent.</comment> <custom xml:space="preserve"> g_return_if_fail(I_CAL_IS_ARRAY(timezones)); g_return_if_fail(I_CAL_IS_COMPONENT(child)); @@ -173,16 +173,16 @@ <method name="i_cal_timezone_get_location_from_vtimezone" corresponds="icaltimezone_get_location_from_vtimezone" kind="get" since="2.0"> <parameter type="ICalComponent *" name="component" comment="The #ICalComponent to be queried."/> <returns type="gchar *" comment="The location of vtimezone."/> - <comment xml:space="preserve">Get the location of the vtimezone in component.</comment> + <comment xml:space="preserve">Gets the location of the vtimezone in component.</comment> </method> <method name="i_cal_timezone_get_tznames_from_vtimezone" corresponds="icaltimezone_get_tznames_from_vtimezone" kind="get" since="2.0"> <parameter type="ICalComponent *" name="component" comment="The #ICalComponent to be queried."/> <returns type="gchar *" comment="The name of vtimezone."/> - <comment xml:space="preserve">Get the name of the vtimezone in component.</comment> + <comment xml:space="preserve">Gets the name of the vtimezone in component.</comment> </method> <method name="i_cal_timezone_set_zone_directory" corresponds="set_zone_directory" kind="others" since="1.0"> <parameter type="const gchar *" name="path" comment="The path to look for the zonefiles"/> - <comment xml:space="preserve">Set the directory to look for the zonefiles</comment> + <comment xml:space="preserve">Sets the directory to look for the zonefiles</comment> </method> <method name="i_cal_timezone_free_zone_directory" corresponds="free_zone_directory" kind="others" since="1.0"> <comment xml:space="preserve">Free memory dedicated to the zonefile directory</comment> @@ -192,11 +192,11 @@ </method> <method name="i_cal_timezone_set_builtin_tzdata" corresponds="icaltimezone_set_builtin_tzdata" kind="set" since="2.0"> <parameter type="gboolean" name="set" comment="Whether to use builtin timezones files."/> - <comment xml:space="preserve">Set whether to use builtin timezones files.</comment> + <comment xml:space="preserve">Sets whether to use builtin timezones files.</comment> </method> <method name="i_cal_timezone_get_builtin_tzdata" corresponds="icaltimezone_get_builtin_tzdata" kind="get" since="2.0"> <returns type="gboolean" comment="Whether to use builtin timezones files."/> - <comment xml:space="preserve">Get whether to use builtin timezones files.</comment> + <comment xml:space="preserve">Gets whether to use builtin timezones files.</comment> </method> <method name="i_cal_timezone_dump_changes" corresponds="icaltimezone_dump_changes" kind="other" since="1.0"> <parameter type="ICalTimezone *" name="zone" comment="The timezone to be queried."/> @@ -209,7 +209,7 @@ <parameter type="ICalArray *" name="timezones" comment="The array to be visited."/> <parameter type="guint" name="index" comment="The index"/> <returns type="ICalTimezone *" annotation="transfer full" translator_argus="timezones, FALSE" comment="The #ICalTimezone at the position @index in @timezones."/> - <comment>Get the #ICalTimezone at specified position in array.</comment> + <comment>Gets the #ICalTimezone at specified position in array.</comment> <custom> return i_cal_timezone_new_full ((gpointer)i_cal_array_element_at (timezones, index), (GObject *)timezones, FALSE);</custom> </method> </structure> diff --git a/src/libical-glib/api/i-cal-trigger.xml b/src/libical-glib/api/i-cal-trigger.xml index f5fffec8..dc1788a9 100644 --- a/src/libical-glib/api/i-cal-trigger.xml +++ b/src/libical-glib/api/i-cal-trigger.xml @@ -17,12 +17,12 @@ <method name="i_cal_trigger_new_from_int" corresponds="icaltriggertype_from_int" kind="constructor" since="1.0"> <parameter type="const gint" name="reltime" comment="An integer."/> <returns type="ICalTrigger *" annotation="transfer full" comment="The newly created #ICalTrigger."/> - <comment xml:space="preserve">Create a #ICalTrigger from integer.</comment> + <comment xml:space="preserve">Creates a #ICalTrigger from integer.</comment> </method> <method name="i_cal_trigger_new_from_string" corresponds="icaltriggertype_from_string" kind="constructor" since="1.0"> <parameter type="const gchar *" name="str" comment="A string."/> <returns type="ICalTrigger *" annotation="transfer full" comment="The newly created #ICalTrigger."/> - <comment xml:space="preserve">Create a #ICalTrigger from a string.</comment> + <comment xml:space="preserve">Creates a #ICalTrigger from a string.</comment> </method> <method name="i_cal_trigger_is_null_trigger" corresponds="icaltriggertype_is_null_trigger" since="1.0"> <parameter type="ICalTrigger *" name="tr" comment="A #ICalTrigger."/> @@ -37,14 +37,14 @@ <method name="i_cal_trigger_get_time" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalTrigger *" name="trigger" comment="The #ICalTrigger."/> <returns type="ICalTime *" annotation="transfer full" comment="The time of #ICalTrigger."/> - <comment>Get the time from #ICalTrigger.</comment> + <comment>Gets the time from #ICalTrigger.</comment> <custom> g_return_val_if_fail (trigger != NULL && I_CAL_IS_TRIGGER (trigger), NULL); return i_cal_time_new_full (((struct icaltriggertype *)i_cal_object_get_native ((ICalObject *)trigger))->time);</custom> </method> <method name="i_cal_trigger_set_time" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTrigger *" name="trigger" comment="The #ICalTrigger."/> <parameter type="ICalTime *" name="time" comment="The time of #ICalTrigger."/> - <comment>Set the time from #ICalTrigger.</comment> + <comment>Sets the time from #ICalTrigger.</comment> <custom> g_return_if_fail (trigger != NULL && I_CAL_IS_TRIGGER (trigger)); g_return_if_fail (time != NULL && I_CAL_IS_TIME(time)); ((struct icaltriggertype *)i_cal_object_get_native ((ICalObject *)trigger))->time = *(struct icaltimetype *)i_cal_object_get_native ((ICalObject *)time);</custom> @@ -52,14 +52,14 @@ <method name="i_cal_trigger_get_duration" corresponds="CUSTOM" kind="get" since="1.0"> <parameter type="ICalTrigger *" name="trigger" comment="The #ICalTrigger."/> <returns type="ICalDuration *" annotation="transfer full" comment="The duration of #ICalTrigger."/> - <comment>Get the duration from #ICalTrigger.</comment> + <comment>Gets the duration from #ICalTrigger.</comment> <custom> g_return_val_if_fail (trigger != NULL && I_CAL_IS_TRIGGER (trigger), NULL); return i_cal_duration_new_full (((struct icaltriggertype *)i_cal_object_get_native ((ICalObject *)trigger))->duration);</custom> </method> <method name="i_cal_trigger_set_duration" corresponds="CUSTOM" kind="set" since="1.0"> <parameter type="ICalTrigger *" name="trigger" comment="The #ICalTrigger."/> <parameter type="ICalDuration *" name="duration" comment="The duration of #ICalTrigger."/> - <comment>Set the duration from #ICalTrigger.</comment> + <comment>Sets the duration from #ICalTrigger.</comment> <custom> g_return_if_fail (trigger != NULL && I_CAL_IS_TRIGGER (trigger)); g_return_if_fail (duration != NULL && I_CAL_IS_DURATION (duration)); ((struct icaltriggertype *)i_cal_object_get_native ((ICalObject *)trigger))->duration = *(struct icaldurationtype *)i_cal_object_get_native ((ICalObject *)duration);</custom> diff --git a/src/libical-glib/api/i-cal-unknowntokenhandling.xml b/src/libical-glib/api/i-cal-unknowntokenhandling.xml index 3d1a0671..e16dd04d 100644 --- a/src/libical-glib/api/i-cal-unknowntokenhandling.xml +++ b/src/libical-glib/api/i-cal-unknowntokenhandling.xml @@ -21,10 +21,10 @@ </enum> <method name="i_cal_get_unknown_token_handling_setting" corresponds="ical_get_unknown_token_handling_setting" kind="get" since="1.0"> <returns type="ICalUnknowntokenhandling" comment="The setting of #ICalUnknowntokenhandling"/> - <comment>Get the setting of #ICalUnknowntokenhandling</comment> + <comment>Gets the setting of #ICalUnknowntokenhandling</comment> </method> <method name="i_cal_set_unknown_token_handling_setting" corresponds="ical_set_unknown_token_handling_setting" kind="set" since="1.0"> <parameter type="ICalUnknowntokenhandling" name="newSetting" comment="A #ICalUnknowntokenhandling"/> - <comment>Set the setting of #ICalUnknowntokenhandling</comment> + <comment>Sets the setting of #ICalUnknowntokenhandling</comment> </method> </structure> diff --git a/src/libical-glib/api/i-cal-value.xml b/src/libical-glib/api/i-cal-value.xml index a46a51b3..efac92cb 100644 --- a/src/libical-glib/api/i-cal-value.xml +++ b/src/libical-glib/api/i-cal-value.xml @@ -17,7 +17,7 @@ <method name="i_cal_value_new" corresponds="icalvalue_new" kind="constructor" since="1.0"> <parameter type="ICalValueKind" name="kind" comment="A #ICalValueKind"/> <returns type="ICalValue *" annotation="transfer full" comment="The newly created #ICalValue."/> - <comment xml:space="preserve">Create a new #ICalValue with specific kind.</comment> + <comment xml:space="preserve">Creates a new #ICalValue with specific kind.</comment> </method> <method name="i_cal_value_clone" corresponds="icalvalue_new_clone" kind="clone" since="1.0"> <parameter type="const ICalValue *" name="value" comment="The #ICalValue to be cloned."/> @@ -28,7 +28,7 @@ <parameter type="ICalValueKind" name="kind" comment="A #ICalValueKind"/> <parameter type="const gchar *" name="str" comment="A string."/> <returns type="ICalValue *" annotation="transfer full" comment="The newly created #ICalValue based on the @kind and @str."/> - <comment xml:space="preserve">Create a new #ICalValue based on the #ICalValueKind and a string.</comment> + <comment xml:space="preserve">Creates a new #ICalValue based on the #ICalValueKind and a string.</comment> </method> <method name="i_cal_value_free" corresponds="icalvalue_free" annotation="skip" kind="destructor" since="1.0"> <parameter type="ICalValue *" name="value" comment="The #ICalValue to be freed."/> @@ -47,7 +47,7 @@ <method name="i_cal_value_isa" corresponds="icalvalue_isa" since="1.0"> <parameter type="const ICalValue *" name="value" comment="A #ICalValue."/> <returns type="ICalValueKind" comment="The kind of @value."/> - <comment xml:space="preserve">Get the kind of #ICalValue.</comment> + <comment xml:space="preserve">Gets the kind of #ICalValue.</comment> </method> <method name="i_cal_value_isa_value" corresponds="icalvalue_isa_value" since="1.0"> <parameter type="ICalValue *" name="value" comment="A #ICalValue"/> diff --git a/src/libical/astime.h b/src/libical/astime.h index b8710b28..201a3747 100644 --- a/src/libical/astime.h +++ b/src/libical/astime.h @@ -62,8 +62,8 @@ typedef struct ut_instant /* Functions in caldate.c */ -LIBICAL_ICAL_EXPORT long caldat(UTinstantPtr); /** converts julian date to year,mo,da */ +LIBICAL_ICAL_EXPORT long caldat(UTinstantPtr); /** Converts julian date to year,mo,da */ -LIBICAL_ICAL_EXPORT double juldat(UTinstantPtr); /** returns julian day from year,mo,da */ +LIBICAL_ICAL_EXPORT double juldat(UTinstantPtr); /** Returns julian day from year,mo,da */ #endif diff --git a/src/libical/icalattach.h b/src/libical/icalattach.h index 15a09441..9a606773 100644 --- a/src/libical/icalattach.h +++ b/src/libical/icalattach.h @@ -54,7 +54,7 @@ typedef struct icalattach_impl icalattach; typedef void (*icalattach_free_fn_t) (char *data, void *user_data); /** - * @brief Create new ::icalattach object from a URL. + * @brief Creates new ::icalattach object from a URL. * @param url The URL to create the object from * @return An ::icalattach object with the given URL as association * @sa icalattach_unref() @@ -86,7 +86,7 @@ typedef void (*icalattach_free_fn_t) (char *data, void *user_data); LIBICAL_ICAL_EXPORT icalattach *icalattach_new_from_url(const char *url); /** - * @brief Create new ::icalattach object from data. + * @brief Creates new ::icalattach object from data. * @param data The data to create the ::icalattach from * @param free_fn The function to free the data * @param free_fn_data Data to pass to the @a free_fn diff --git a/src/libical/icalcomponent.c b/src/libical/icalcomponent.c index fc0cd3df..21f29b42 100644 --- a/src/libical/icalcomponent.c +++ b/src/libical/icalcomponent.c @@ -849,7 +849,7 @@ static int icalcomponent_is_busy(icalcomponent *comp) } /** - * @brief cycle through all recurrances of an event + * @brief cycles through all recurrances of an event * * @param comp A valid VEVENT component * @param start Ignore timespans before this @@ -1402,7 +1402,7 @@ if (inner == 0) { \ } \ prop = icalcomponent_get_first_property(inner, p_kind); -/** @brief Set DTSTART property to given icaltime +/** @brief Sets DTSTART property to given icaltime * * This method respects the icaltime type (DATE vs DATE-TIME) and * timezone (or lack thereof). @@ -1427,7 +1427,7 @@ void icalcomponent_set_dtstart(icalcomponent *comp, struct icaltimetype v) } } -/** @brief Get DTSTART property as an icaltime +/** @brief Gets DTSTART property as an icaltime * * If DTSTART is a DATE-TIME with a timezone parameter and a * corresponding VTIMEZONE is present in the component, the @@ -2405,7 +2405,7 @@ static int icalcomponent_compare_vtimezones(icalcomponent *vtimezone1, icalcompo } /** - * @brief set the RELCALID property of a component. + * @brief Sets the RELCALID property of a component. * * @param comp Valid calendar component. * @param v Relcalid URL value @@ -2424,7 +2424,7 @@ void icalcomponent_set_relcalid(icalcomponent *comp, const char *v) } /** - * @brief get the RELCALID property of a component. + * @brief Gets the RELCALID property of a component. * * @param comp Valid calendar component. */ @@ -2451,7 +2451,7 @@ const char *icalcomponent_get_relcalid(icalcomponent *comp) return icalproperty_get_relcalid(prop); } -/** @brief Return the time a TODO task is DUE. +/** @brief Returns the time a TODO task is DUE. * * @param comp Valid calendar component. * diff --git a/src/libical/icalcomponent.h b/src/libical/icalcomponent.h index a755a3ab..649f14b8 100644 --- a/src/libical/icalcomponent.h +++ b/src/libical/icalcomponent.h @@ -146,13 +146,13 @@ LIBICAL_ICAL_EXPORT icalcomponent *icalcompiter_deref(icalcompiter * i); /* Working with embedded error properties */ LIBICAL_ICAL_EXPORT int icalcomponent_check_restrictions(icalcomponent *comp); -/** Count embedded errors. */ +/** Counts embedded errors. */ LIBICAL_ICAL_EXPORT int icalcomponent_count_errors(icalcomponent *component); -/** Remove all X-LIC-ERROR properties*/ +/** Removes all X-LIC-ERROR properties*/ LIBICAL_ICAL_EXPORT void icalcomponent_strip_errors(icalcomponent *component); -/** Convert some X-LIC-ERROR properties into RETURN-STATUS properties*/ +/** Converts some X-LIC-ERROR properties into RETURN-STATUS properties*/ LIBICAL_ICAL_EXPORT void icalcomponent_convert_errors(icalcomponent *component); /* Internal operations. They are private, and you should not be using them. */ diff --git a/src/libical/icalenums.c b/src/libical/icalenums.c index 42ee7fd2..759ff405 100644 --- a/src/libical/icalenums.c +++ b/src/libical/icalenums.c @@ -77,7 +77,7 @@ static const struct {ICAL_UNKNOWN_STATUS, 0, 0, "Error: Unknown request status"} }; -/*** @brief Return the descriptive text for a request status +/*** @brief Returns the descriptive text for a request status */ const char *icalenum_reqstat_desc(icalrequeststatus stat) { diff --git a/src/libical/icalerror.h b/src/libical/icalerror.h index aaf6ac1c..932d88cc 100644 --- a/src/libical/icalerror.h +++ b/src/libical/icalerror.h @@ -112,7 +112,7 @@ typedef enum icalerrorenum #endif /** - * @brief Return the current ::icalerrno value + * @brief Returns the current ::icalerrno value * @return A pointer to the current ::icalerrno value * * Yields a pointer to the current ::icalerrno value. This can @@ -194,7 +194,7 @@ LIBICAL_ICAL_EXPORT int icalerror_get_errors_are_fatal(void); #endif /* __GNU_C__ */ /** - * @brief Reset icalerrno to ::ICAL_NO_ERROR + * @brief Resets icalerrno to ::ICAL_NO_ERROR * * ### Usage * ```c @@ -227,7 +227,7 @@ typedef enum icalerrorstate } icalerrorstate; /** - * @brief Find description string for error + * @brief Finds description string for error * @param e The type of error that occurred * @return A string describing the error that occurred * @@ -249,7 +249,7 @@ typedef enum icalerrorstate LIBICAL_ICAL_EXPORT const char *icalerror_strerror(icalerrorenum e); /** - * @brief Return the description string for the current error in ::icalerrno + * @brief Returns the description string for the current error in ::icalerrno * * @par Error handling * If the type of error @a e wasn't found, it returns the description @@ -282,7 +282,7 @@ LIBICAL_ICAL_EXPORT const char *icalerror_perror(void); LIBICAL_ICAL_EXPORT void ical_bt(void); /** - * @brief Set the ::icalerrorstate for a given ::icalerrorenum @a error + * @brief Sets the ::icalerrorstate for a given ::icalerrorenum @a error * @param error The error to change * @param state The new error state of the error * @@ -297,14 +297,14 @@ LIBICAL_ICAL_EXPORT void ical_bt(void); LIBICAL_ICAL_EXPORT void icalerror_set_error_state(icalerrorenum error, icalerrorstate state); /** - * @brief Get the error state (severity) for a given error + * @brief Gets the error state (severity) for a given error * @param error The error to examine * @return Returns the severity of the error */ LIBICAL_ICAL_EXPORT icalerrorstate icalerror_get_error_state(icalerrorenum error); /** - * @brief Read an error from a string + * @brief Reads an error from a string * @param str The error name string * @return An ::icalerrorenum representing the error * @@ -569,7 +569,7 @@ if (!(test)) { \ LIBICAL_ICAL_EXPORT icalerrorstate icalerror_supress(const char *error); /** - * Assign the given error the given icalerrorstate (severity) + * Assigns the given error the given icalerrorstate (severity) * @param error The error in question * @param es The icalerrorstate (severity) to set it to * diff --git a/src/libical/icalmemory.h b/src/libical/icalmemory.h index 3af7e38d..7eb7e010 100644 --- a/src/libical/icalmemory.h +++ b/src/libical/icalmemory.h @@ -97,7 +97,7 @@ LIBICAL_ICAL_EXPORT void *icalmemory_tmp_buffer(size_t size); LIBICAL_ICAL_EXPORT char *icalmemory_tmp_copy(const char *str); /** - * @brief Add an externally allocated buffer to the ring. + * @brief Adds an externally allocated buffer to the ring. * @param buf The externally allocated buffer to add to the ring * * Adds an externally allocated buffer to the ring. This ensures that libical @@ -123,7 +123,7 @@ LIBICAL_ICAL_EXPORT char *icalmemory_tmp_copy(const char *str); LIBICAL_ICAL_EXPORT void icalmemory_add_tmp_buffer(void *buf); /** - * @brief Free all memory used in the ring + * @brief Frees all memory used in the ring * * Frees all memory used in the ring. Depending on if ::HAVE_PTHREAD is set or * not, the ring buffer is allocated on a per-thread basis, meaning that if all @@ -231,7 +231,7 @@ LIBICAL_ICAL_EXPORT void icalmemory_free_buffer(void *buf); have memory problems. */ /** - * @brief Append a string to a buffer. + * @brief Appends a string to a buffer. * @param buf The buffer to append the string to. * @param pos The position to append the string at. * @param buf_size The size of the buffer (will be changed if buffer is @@ -272,7 +272,7 @@ LIBICAL_ICAL_EXPORT void icalmemory_append_string(char **buf, char **pos, size_t const char *string); /** - * @brief Append a character to a buffer. + * @brief Appends a character to a buffer. * @param buf The buffer to append the character to. * @param pos The position to append the character at. * @param buf_size The size of the buffer (will be changed if buffer is @@ -313,7 +313,7 @@ LIBICAL_ICAL_EXPORT void icalmemory_append_string(char **buf, char **pos, size_t LIBICAL_ICAL_EXPORT void icalmemory_append_char(char **buf, char **pos, size_t *buf_size, char ch); /** - * @brief Create a duplicate of a string. + * @brief Creates a duplicate of a string. * @param s The string to duplicate. * @return A pointer to a string containing the same data as @a s * diff --git a/src/libical/icalparameter.c b/src/libical/icalparameter.c index d82c0356..efcb1b03 100644 --- a/src/libical/icalparameter.c +++ b/src/libical/icalparameter.c @@ -257,7 +257,7 @@ static void icalparameter_append_encoded_value(char **buf, char **buf_ptr, } /** - * Return a string representation of the parameter according to RFC5445/RFC6868. + * Returns a string representation of the parameter according to RFC5445/RFC6868. * * param = param-name "=" param-value * param-name = iana-token / x-token diff --git a/src/libical/icalparameter.h b/src/libical/icalparameter.h index 69f95dfe..84691116 100644 --- a/src/libical/icalparameter.h +++ b/src/libical/icalparameter.h @@ -95,7 +95,7 @@ LIBICAL_ICAL_EXPORT icalparameter *icalparameter_new(icalparameter_kind kind); LIBICAL_ICAL_EXPORT icalparameter *icalparameter_new_clone(icalparameter *p); /** - * @brief Create ::icalparameter object from string + * @brief Creates new ::icalparameter object from string * @param value The string from which to create the ::icalparameter, in the form `"PARAMNAME=VALUE"` * @return An ::icalparameter that corresponds to the given string. * @@ -123,7 +123,7 @@ LIBICAL_ICAL_EXPORT icalparameter *icalparameter_new_clone(icalparameter *p); LIBICAL_ICAL_EXPORT icalparameter *icalparameter_new_from_string(const char *value); /** - * @brief Create ::icalparameter of a given @a kind with a given @a value + * @brief Creates new ::icalparameter of a given @a kind with a given @a value * @param kind The kind of ::icalparameter to create * @param value The value of the parameter * @return An ::icalparameter with the given kind and value. @@ -176,7 +176,7 @@ LIBICAL_ICAL_EXPORT icalparameter *icalparameter_new_from_value_string(icalparam LIBICAL_ICAL_EXPORT void icalparameter_free(icalparameter *parameter); /** - * @brief Convert ::icalparameter into an string representation + * @brief Converts ::icalparameter into a string representation * @param parameter The ::icalparameter to convert * @return A string representing the parameter according to RFC5445/RFC6868. * @sa icalparameter_as_ical_string_r() @@ -208,7 +208,7 @@ LIBICAL_ICAL_EXPORT void icalparameter_free(icalparameter *parameter); LIBICAL_ICAL_EXPORT char *icalparameter_as_ical_string(icalparameter *parameter); /** - * @brief Convert ::icalparameter into an string representation + * @brief Converts ::icalparameter into an string representation * @param parameter The ::icalparameter to convert * @return A string representing the parameter according to RFC5445/RFC6868. * @sa icalparameter_as_ical_string() @@ -265,7 +265,7 @@ LIBICAL_ICAL_EXPORT char *icalparameter_as_ical_string_r(icalparameter *paramete LIBICAL_ICAL_EXPORT icalparameter_kind icalparameter_isa(icalparameter *parameter); /** - * Determine if the given param is an icalparameter + * Determines if the given param is an icalparameter * @param param The libical-originated object to check * @return 1 if the object is an icalparameter, 0 otherwise. * @note This function expects to be given an object originating from @@ -571,7 +571,7 @@ LIBICAL_ICAL_EXPORT int icalparameter_has_same_name(icalparameter *param1, icalp /** * @brief Returns a string representing the given ::icalparameter_kind * @param kind The icalparameter_kind - * @return A string representing kind + * @return A string representing @a kind * * @par Error handling * When passed a non-existing ::icalparameter_kind, it returns `NULL`. @@ -615,7 +615,7 @@ LIBICAL_ICAL_EXPORT icalparameter_kind icalparameter_string_to_kind(const char * /** * @brief Checks the validity of a ::icalparameter_kind * @param kind The icalparameter_kind - * @return 1 if if the kind is valid, 0 otherwise + * @return 1 if if @a kind is valid, 0 otherwise * * ### Usage * ```c diff --git a/src/libical/icalparser.c b/src/libical/icalparser.c index 3dfc2df3..f9af7ed4 100644 --- a/src/libical/icalparser.c +++ b/src/libical/icalparser.c @@ -169,7 +169,7 @@ static char *parser_get_next_char(char c, char *str, int qm) return 0; } -/** make a new tmp buffer out of a substring */ +/** makes a new tmp buffer out of a substring */ static char *make_segment(char *start, char *end) { char *buf, *tmp; diff --git a/src/libical/icalparser.h b/src/libical/icalparser.h index 867fd297..1c0571b9 100644 --- a/src/libical/icalparser.h +++ b/src/libical/icalparser.h @@ -284,7 +284,7 @@ LIBICAL_ICAL_EXPORT icalcomponent *icalparser_parse(icalparser *parser, LIBICAL_ICAL_EXPORT void icalparser_set_gen_data(icalparser *parser, void *data); /** - * @brief Parse a string and return the parsed ::icalcomponent. + * @brief Parses a string and returns the parsed ::icalcomponent. * @param str The iCal formatted data to be parsed * @return An ::icalcomponent representing the iCalendar * @@ -317,8 +317,7 @@ LIBICAL_ICAL_EXPORT icalcomponent *icalparser_parse_string(const char *str); ***********************************************************************/ /** - * @brief Given a line generator function, return a single iCal content line. - * @return Aa pointer to a single line of data or `NULL` if it reached + * @brief Given a line generator function, returns a single iCal content line. * end of file reading from the @a line_gen_func. Note that the pointer * returned is owned by libical and must not be `free()`d by the user. * @param parser The parser object to use diff --git a/src/libical/icalproperty.c b/src/libical/icalproperty.c index d5f0c502..fb365444 100644 --- a/src/libical/icalproperty.c +++ b/src/libical/icalproperty.c @@ -625,7 +625,7 @@ char *icalproperty_get_parameter_as_string_r(icalproperty *prop, const char *nam return str; } -/** @brief Remove all parameters with the specified kind. +/** @brief Removes all parameters with the specified kind. * * @param prop A valid icalproperty. * @param kind The kind to remove (ex. ICAL_TZID_PARAMETER) @@ -652,7 +652,7 @@ void icalproperty_remove_parameter_by_kind(icalproperty *prop, icalparameter_kin } } -/** @brief Remove all parameters with the specified name. +/** @brief Removes all parameters with the specified name. * * @param prop A valid icalproperty. * @param name The name of the parameter to remove @@ -695,7 +695,7 @@ void icalproperty_remove_parameter_by_name(icalproperty *prop, const char *name) } } -/** @brief Remove the specified parameter reference from the property. +/** @brief Removes the specified parameter reference from the property. * * @param prop A valid icalproperty. * @param parameter A reference to a specific icalparameter. @@ -1072,7 +1072,7 @@ void icalproperty_normalize(icalproperty *prop) prop->parameters = sorted_params; } -/** @brief Get a DATE or DATE-TIME property as an icaltime +/** @brief Gets a DATE or DATE-TIME property as an icaltime * * If the property is a DATE-TIME with a TZID parameter and a * corresponding VTIMEZONE is present in the component, the diff --git a/src/libical/icalproperty.h b/src/libical/icalproperty.h index de81270f..dddbfb78 100644 --- a/src/libical/icalproperty.h +++ b/src/libical/icalproperty.h @@ -98,7 +98,7 @@ LIBICAL_ICAL_EXPORT icalproperty *icalvalue_get_parent(icalvalue *value); LIBICAL_ICAL_EXPORT void icalproperty_set_x_name(icalproperty *prop, const char *name); LIBICAL_ICAL_EXPORT const char *icalproperty_get_x_name(icalproperty *prop); -/** Return the name of the property -- the type name converted to a +/** Returns the name of the property -- the type name converted to a * string, or the value of _get_x_name if the type is and X * property */ diff --git a/src/libical/icalproperty_cxx.cpp b/src/libical/icalproperty_cxx.cpp index b30b54b2..fd2a7e48 100644 --- a/src/libical/icalproperty_cxx.cpp +++ b/src/libical/icalproperty_cxx.cpp @@ -167,7 +167,7 @@ std::string ICalProperty::get_value_as_string() return static_cast<std::string>(icalproperty_get_value_as_string(imp)); } -/** Return the name of the property -- the type name converted to a +/** Returns the name of the property -- the type name converted to a * string, or the value of get_x_name if the type is X property */ std::string ICalProperty::get_name() const diff --git a/src/libical/icalproperty_cxx.h b/src/libical/icalproperty_cxx.h index a13ac14d..e243dd2e 100644 --- a/src/libical/icalproperty_cxx.h +++ b/src/libical/icalproperty_cxx.h @@ -81,7 +81,7 @@ public: ICalValue *get_value(); std::string get_value_as_string(); - /** Return the name of the property -- the type name converted + /** Returns the name of the property -- the type name converted * to a string, or the value of get_x_name if the type is X * property */ diff --git a/src/libical/icalrecur.c b/src/libical/icalrecur.c index 73178450..2687e9f2 100644 --- a/src/libical/icalrecur.c +++ b/src/libical/icalrecur.c @@ -1464,7 +1464,7 @@ static int initialize_rscale(icalrecur_iterator *impl) return 1; } -/* Set Gregorian date and convert to RSCALE */ +/* Sets Gregorian date and convert to RSCALE */ static void set_datetime(icalrecur_iterator *impl, icaltimetype date) { UErrorCode status = U_ZERO_ERROR; @@ -1759,7 +1759,7 @@ static int initialize_rscale(icalrecur_iterator *impl) return 1; } -/* Set Gregorian date */ +/* Sets Gregorian date */ static void set_datetime(icalrecur_iterator *impl, icaltimetype date) { impl->last.year = date.year; diff --git a/src/libical/icalrecur.h b/src/libical/icalrecur.h index ae11a9ae..1fb300dd 100644 --- a/src/libical/icalrecur.h +++ b/src/libical/icalrecur.h @@ -242,10 +242,10 @@ LIBICAL_ICAL_EXPORT icalrecur_iterator *icalrecur_iterator_new(struct icalrecurr LIBICAL_ICAL_EXPORT int icalrecur_iterator_set_start(icalrecur_iterator *impl, struct icaltimetype start); -/** Get the next occurrence from an iterator */ +/** Gets the next occurrence from an iterator */ LIBICAL_ICAL_EXPORT struct icaltimetype icalrecur_iterator_next(icalrecur_iterator *); -/** Free the iterator */ +/** Frees the iterator */ LIBICAL_ICAL_EXPORT void icalrecur_iterator_free(icalrecur_iterator *); /** diff --git a/src/libical/icaltime.c b/src/libical/icaltime.c index e5c6284c..6d60d83d 100644 --- a/src/libical/icaltime.c +++ b/src/libical/icaltime.c @@ -291,7 +291,7 @@ time_t icaltime_as_timet(const struct icaltimetype tt) return t; } -/** Return the time as seconds past the UNIX epoch, using the +/** Returns the time as seconds past the UNIX epoch, using the * given timezone. * * This convenience method combines a call to icaltime_convert_to_zone() @@ -708,7 +708,7 @@ int icaltime_is_utc(const struct icaltimetype t) } /** - * Return true if the time is null. + * Returns true if the time is null. */ int icaltime_is_null_time(const struct icaltimetype t) { @@ -720,7 +720,7 @@ int icaltime_is_null_time(const struct icaltimetype t) } /** - * Return -1, 0, or 1 to indicate that a<b, a==b, or a>b. + * Returns -1, 0, or 1 to indicate that a<b, a==b, or a>b. * This calls icaltime_compare function after converting them to the utc * timezone. */ @@ -946,9 +946,9 @@ void icaltime_adjust(struct icaltimetype *tt, tt->day = day; } -/** @brief Convert time to a given timezone +/** @brief Converts time to a given timezone * - * Convert a time from its native timezone to a given timezone. + * Converts a time from its native timezone to a given timezone. * * If tt is a date, the returned time is an exact * copy of the input. If it's a floating time, the returned object @@ -999,9 +999,9 @@ const char *icaltime_get_tzid(const struct icaltimetype t) } } -/** @brief Set the timezone +/** @brief Sets the timezone * - * Force the icaltime to be interpreted relative to another timezone. + * Forces the icaltime to be interpreted relative to another timezone. * If you need to do timezone conversion, applying offset adjustments, * then you should use icaltime_convert_to_zone instead. */ diff --git a/src/libical/icaltime.h b/src/libical/icaltime.h index 8623ba6a..5883d7bc 100644 --- a/src/libical/icaltime.h +++ b/src/libical/icaltime.h @@ -119,11 +119,11 @@ struct icaltimetype typedef struct icaltimetype icaltimetype; -/** Return a null time, which indicates no time has been set. +/** Returns a null time, which indicates no time has been set. This time represent the beginning of the epoch */ LIBICAL_ICAL_EXPORT struct icaltimetype icaltime_null_time(void); -/** Return a null date */ +/** Returns a null date */ LIBICAL_ICAL_EXPORT struct icaltimetype icaltime_null_date(void); /** Returns the current time in the given timezone, as an icaltimetype. */ @@ -152,11 +152,11 @@ LIBICAL_ICAL_EXPORT struct icaltimetype icaltime_from_day_of_year(const int doy, */ LIBICAL_ICAL_EXPORT time_t icaltime_as_timet(const struct icaltimetype); -/** Return the time as seconds past the UNIX epoch, using timezones. */ +/** Returns the time as seconds past the UNIX epoch, using timezones. */ LIBICAL_ICAL_EXPORT time_t icaltime_as_timet_with_zone(const struct icaltimetype tt, const icaltimezone *zone); -/** Return a string represention of the time, in RFC5545 format. */ +/** Returns a string represention of the time, in RFC5545 format. */ LIBICAL_ICAL_EXPORT const char *icaltime_as_ical_string(const struct icaltimetype tt); LIBICAL_ICAL_EXPORT char *icaltime_as_ical_string_r(const struct icaltimetype tt); @@ -171,20 +171,20 @@ LIBICAL_ICAL_EXPORT const char *icaltime_get_tzid(const struct icaltimetype t); LIBICAL_ICAL_EXPORT struct icaltimetype icaltime_set_timezone(struct icaltimetype *t, const icaltimezone *zone); -/** Return the day of the year of the given time */ +/** Returns the day of the year of the given time */ LIBICAL_ICAL_EXPORT int icaltime_day_of_year(const struct icaltimetype t); -/** Return the day of the week of the given time. Sunday is 1 */ +/** Returns the day of the week of the given time. Sunday is 1 */ LIBICAL_ICAL_EXPORT int icaltime_day_of_week(const struct icaltimetype t); -/** Return the day of the year for the first day of the week that the +/** Returns the day of the year for the first day of the week that the given time is within. */ LIBICAL_ICAL_EXPORT int icaltime_start_doy_week(const struct icaltimetype t, int fdow); -/** Return the week number for the week the given time is within */ +/** Returns the week number for the week the given time is within */ LIBICAL_ICAL_EXPORT int icaltime_week_number(const struct icaltimetype t); -/** Return true if the time is null. */ +/** Returns true if the time is null. */ LIBICAL_ICAL_EXPORT int icaltime_is_null_time(const struct icaltimetype t); /** Returns false if the time is clearly invalid, but is not null. This @@ -198,7 +198,7 @@ LIBICAL_ICAL_EXPORT int icaltime_is_date(const struct icaltimetype t); /** @brief Returns true if time is relative to UTC zone */ LIBICAL_ICAL_EXPORT int icaltime_is_utc(const struct icaltimetype t); -/** Return -1, 0, or 1 to indicate that a is less than b, a equals b, or a is greater than b */ +/** Returns -1, 0, or 1 to indicate that a is less than b, a equals b, or a is greater than b */ LIBICAL_ICAL_EXPORT int icaltime_compare(const struct icaltimetype a, const struct icaltimetype b); /** like icaltime_compare, but only use the date parts. */ @@ -223,13 +223,13 @@ LIBICAL_ICAL_EXPORT struct icaltimetype icaltime_normalize(const struct icaltime LIBICAL_ICAL_EXPORT struct icaltimetype icaltime_convert_to_zone(const struct icaltimetype tt, icaltimezone *zone); -/** Return the number of days in the given month */ +/** Returns the number of days in the given month */ LIBICAL_ICAL_EXPORT int icaltime_days_in_month(const int month, const int year); -/** Return whether you've specified a leapyear or not. */ +/** Returns whether you've specified a leapyear or not. */ LIBICAL_ICAL_EXPORT int icaltime_is_leap_year(const int year); -/** Return the number of days in this year */ +/** Returns the number of days in this year */ LIBICAL_ICAL_EXPORT int icaltime_days_in_year(const int year); /** @brief calculate an icaltimespan given a start and end time. */ diff --git a/src/libical/icaltimezone.h b/src/libical/icaltimezone.h index d31a415a..9c598737 100644 --- a/src/libical/icaltimezone.h +++ b/src/libical/icaltimezone.h @@ -60,7 +60,7 @@ LIBICAL_ICAL_EXPORT void icaltimezone_set_tzid_prefix(const char *new_prefix); * @par Accessing timezones. */ -/** Free any builtin timezone information **/ +/** Frees any builtin timezone information **/ LIBICAL_ICAL_EXPORT void icaltimezone_free_builtin_timezones(void); /** Returns the array of builtin icaltimezones. */ @@ -171,10 +171,10 @@ LIBICAL_ICAL_EXPORT void icaltimezone_truncate_vtimezone(icalcomponent *vtz, * @par Handling the default location the timezone files */ -/** Set the directory to look for the zonefiles */ +/** Sets the directory to look for the zonefiles */ LIBICAL_ICAL_EXPORT void set_zone_directory(const char *path); -/** Free memory dedicated to the zonefile directory */ +/** Frees memory dedicated to the zonefile directory */ LIBICAL_ICAL_EXPORT void free_zone_directory(void); LIBICAL_ICAL_EXPORT void icaltimezone_release_zone_tab(void); diff --git a/src/libical/vcomponent_cxx.cpp b/src/libical/vcomponent_cxx.cpp index f71e9df3..23c90b5c 100644 --- a/src/libical/vcomponent_cxx.cpp +++ b/src/libical/vcomponent_cxx.cpp @@ -207,7 +207,7 @@ ICalProperty *VComponent::get_next_property(const icalproperty_kind &kind) } /* Working with components */ -/* Return the first VEVENT, VTODO or VJOURNAL sub-component if it is one of those types */ +/* Returns the first VEVENT, VTODO or VJOURNAL sub-component if it is one of those types */ VComponent *VComponent::get_inner() { return new VComponent(icalcomponent_get_inner(imp)); diff --git a/src/libicalss/icalbdbset.c b/src/libicalss/icalbdbset.c index 0294e0fe..c77e9a14 100644 --- a/src/libicalss/icalbdbset.c +++ b/src/libicalss/icalbdbset.c @@ -678,7 +678,7 @@ int icalbdbset_get(DB *dbp, DB_TXN *tid, DBT *key, DBT *data, u_int32_t flags) return dbp->get(dbp, tid, key, data, flags); } -/** Return the path of the database file **/ +/** Returns the path of the database file **/ const char *icalbdbset_path(icalset *set) { @@ -982,7 +982,7 @@ int icalbdbset_count_components(icalset *set, icalcomponent_kind kind) return icalcomponent_count_components(bset->cluster, kind); } -/** Set the gauge **/ +/** Sets the gauge **/ icalerrorenum icalbdbset_select(icalset *set, icalgauge *gauge) { diff --git a/src/libicalss/icalbdbset.h b/src/libicalss/icalbdbset.h index f7e3b880..1fe2e2cf 100644 --- a/src/libicalss/icalbdbset.h +++ b/src/libicalss/icalbdbset.h @@ -107,7 +107,7 @@ LIBICAL_ICALSS_EXPORT icalerrorenum icalbdbset_select(icalset *store, icalgauge LIBICAL_ICALSS_EXPORT void icalbdbset_clear(icalset *store); -/* Get and search for a component by uid */ +/* Gets and searches for a component by uid */ LIBICAL_ICALSS_EXPORT icalcomponent *icalbdbset_fetch(icalset *set, icalcomponent_kind kind, const char *uid); diff --git a/src/libicalss/icalclassify.c b/src/libicalss/icalclassify.c index c5b54b1e..2685b087 100644 --- a/src/libicalss/icalclassify.c +++ b/src/libicalss/icalclassify.c @@ -57,7 +57,7 @@ char *icalclassify_lowercase(const char *str) return xnew; } -/* Return a set of components that intersect in time with comp. For +/* Returns a set of components that intersect in time with comp. For component X and Y to intersect: X.DTSTART < Y.DTEND && X.DTEND > Y.DTSTART */ diff --git a/src/libicalss/icaldirset.h b/src/libicalss/icaldirset.h index 053e11b9..214c3000 100644 --- a/src/libicalss/icaldirset.h +++ b/src/libicalss/icaldirset.h @@ -42,7 +42,7 @@ LIBICAL_ICALSS_EXPORT void icaldirset_free(icalset *set); LIBICAL_ICALSS_EXPORT const char *icaldirset_path(icalset *set); -/* Mark the cluster as changed, so it will be written to disk when it +/* Marks the cluster as changed, so it will be written to disk when it is freed. Commit writes to disk immediately*/ LIBICAL_ICALSS_EXPORT void icaldirset_mark(icalset *set); @@ -54,13 +54,13 @@ LIBICAL_ICALSS_EXPORT icalerrorenum icaldirset_remove_component(icalset *store, LIBICAL_ICALSS_EXPORT int icaldirset_count_components(icalset *store, icalcomponent_kind kind); -/* Restrict the component returned by icaldirset_first, _next to those +/* Restricts the component returned by icaldirset_first, _next to those that pass the gauge. _clear removes the gauge. */ LIBICAL_ICALSS_EXPORT icalerrorenum icaldirset_select(icalset *store, icalgauge *gauge); LIBICAL_ICALSS_EXPORT void icaldirset_clear(icalset *store); -/* Get a component by uid */ +/* Gets a component by uid */ LIBICAL_ICALSS_EXPORT icalcomponent *icaldirset_fetch(icalset *store, icalcomponent_kind kind, const char *uid); @@ -68,12 +68,12 @@ LIBICAL_ICALSS_EXPORT int icaldirset_has_uid(icalset *store, const char *uid); LIBICAL_ICALSS_EXPORT icalcomponent *icaldirset_fetch_match(icalset *set, icalcomponent *c); -/* Modify components according to the MODIFY method of CAP. Works on +/* Modifies components according to the MODIFY method of CAP. Works on the currently selected components. */ LIBICAL_ICALSS_EXPORT icalerrorenum icaldirset_modify(icalset *store, icalcomponent *oldc, icalcomponent *newc); -/* Iterate through the components. If a gauge has been defined, these +/* Iterates through the components. If a gauge has been defined, these will skip over components that do not pass the gauge */ LIBICAL_ICALSS_EXPORT icalcomponent *icaldirset_get_current_component(icalset *store); diff --git a/src/libicalss/icalfileset.h b/src/libicalss/icalfileset.h index 50af6d76..7f2a101b 100644 --- a/src/libicalss/icalfileset.h +++ b/src/libicalss/icalfileset.h @@ -56,15 +56,15 @@ LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_remove_component(icalset *set, LIBICAL_ICALSS_EXPORT int icalfileset_count_components(icalset *set, icalcomponent_kind kind); /** - * Restrict the component returned by icalfileset_first, _next to those + * Restricts the component returned by icalfileset_first, _next to those * that pass the gauge. _clear removes the gauge */ LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_select(icalset *set, icalgauge *gauge); -/** clear the gauge **/ +/** Clears the gauge **/ LIBICAL_ICALSS_EXPORT void icalfileset_clear(icalset *set); -/** Get and search for a component by uid **/ +/** Gets and searches for a component by uid **/ LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_fetch(icalset *set, icalcomponent_kind kind, const char *uid); @@ -73,14 +73,14 @@ LIBICAL_ICALSS_EXPORT int icalfileset_has_uid(icalset *set, const char *uid); LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_fetch_match(icalset *set, icalcomponent *c); /** - * Modify components according to the MODIFY method of CAP. Works on the + * Modifies components according to the MODIFY method of CAP. Works on the * currently selected components. */ LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_modify(icalset *set, icalcomponent *oldcomp, icalcomponent *newcomp); -/* Iterate through components. If a gauge has been defined, these +/* Iterates through components. If a gauge has been defined, these will skip over components that do not pass the gauge */ LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_get_current_component(icalset *cluster); @@ -99,7 +99,7 @@ LIBICAL_ICALSS_EXPORT icalcomponent *icalfilesetiter_to_next(icalset *set, icals LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_form_a_matched_recurrence_component(icalsetiter * itr); -/** Return a reference to the internal component. You probably should +/** Returns a reference to the internal component. You probably should not be using this. */ LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_get_component(icalset *cluster); diff --git a/src/libicalss/icalset.c b/src/libicalss/icalset.c index 0c7f30c3..eba4943f 100644 --- a/src/libicalss/icalset.c +++ b/src/libicalss/icalset.c @@ -369,7 +369,7 @@ icalset *icalset_new_dir_reader(const char *path) /* Functions for built-in methods */ /** - * free memory associated with this icalset + * frees memory associated with this icalset * automatically calls the implementation specific free routine */ diff --git a/src/libicalss/icalset.h b/src/libicalss/icalset.h index 978c76d2..eb33de0a 100644 --- a/src/libicalss/icalset.h +++ b/src/libicalss/icalset.h @@ -131,7 +131,7 @@ LIBICAL_ICALSS_EXPORT int icalset_count_components(icalset *set, icalcomponent_k that pass the gauge. */ LIBICAL_ICALSS_EXPORT icalerrorenum icalset_select(icalset *set, icalgauge *gauge); -/** Get a component by uid */ +/** Gets a component by uid */ LIBICAL_ICALSS_EXPORT icalcomponent *icalset_fetch(icalset *set, const char *uid); LIBICAL_ICALSS_EXPORT int icalset_has_uid(icalset *set, const char *uid); diff --git a/src/libicalss/icalspanlist.c b/src/libicalss/icalspanlist.c index de3326c1..046eb58b 100644 --- a/src/libicalss/icalspanlist.c +++ b/src/libicalss/icalspanlist.c @@ -120,7 +120,7 @@ icalspanlist *icalspanlist_new(icalset *set, struct icaltimetype start, struct i range.start = icaltime_as_timet(start); range.end = icaltime_as_timet(end); - /* Get a list of spans of busy time from the events in the set + /* Gets a list of spans of busy time from the events in the set and order the spans based on the start time */ for (c = icalset_get_first_component(set); diff --git a/src/libicalss/icalspanlist.h b/src/libicalss/icalspanlist.h index 260f84a6..a3aa0638 100644 --- a/src/libicalss/icalspanlist.h +++ b/src/libicalss/icalspanlist.h @@ -39,7 +39,7 @@ LIBICAL_ICALSS_EXPORT icalspanlist *icalspanlist_new(icalset *set, */ LIBICAL_ICALSS_EXPORT void icalspanlist_free(icalspanlist *spl); -/** Get first next free time after time t. all times are in UTC. */ +/** Gets first next free time after time t. all times are in UTC. */ LIBICAL_ICALSS_EXPORT struct icalperiodtype icalspanlist_next_free_time(icalspanlist *sl, struct icaltimetype t); diff --git a/src/libicalss/icalspanlist_cxx.h b/src/libicalss/icalspanlist_cxx.h index 70706c65..4fffd44e 100644 --- a/src/libicalss/icalspanlist_cxx.h +++ b/src/libicalss/icalspanlist_cxx.h @@ -61,18 +61,18 @@ public: /** Destructor */ ~ICalSpanList(); - /** Return a VFREEBUSY icalcomponent */ + /** Returns a VFREEBUSY icalcomponent */ VComponent *get_vfreebusy(const char *organizer, const char *attendee); ICalSpanList &operator=(const ICalSpanList &); - /** Return the base data when casting */ + /** Returns the base data when casting */ operator icalspanlist *() { return data; } - /** Return a vector of the number of events over delta t */ + /** Returns a vector of the number of events over delta t */ std::vector < int >as_vector(int delta_t); /** Dump the spanlist to stdout */ diff --git a/src/python/LibicalWrap_icaltime.i b/src/python/LibicalWrap_icaltime.i index f917f248..8ef33bf2 100644 --- a/src/python/LibicalWrap_icaltime.i +++ b/src/python/LibicalWrap_icaltime.i @@ -18,7 +18,7 @@ Contributions from: - ======================================================================*/ + ======================================================================*/ // Add some methods to the icaltimetype struct %extend icaltimetype { @@ -26,32 +26,32 @@ /* ***** Special methods ***** */ int __cmp__(const icaltimetype b) { return icaltime_compare(*($self), b); } - + /* ***** Conversion methods ***** */ const char* as_ical_string() { return icaltime_as_ical_string(*($self)); } time_t as_timet(const icaltimezone *zone=NULL) { return icaltime_as_timet_with_zone(*($self), zone); } - + /* ***** Accessor methods ***** */ - + const char *get_tzid() { return icaltime_get_tzid(*($self)); } int day_of_year() { return icaltime_day_of_year(*($self)); } int day_of_week() { return icaltime_day_of_week(*($self)); } - /** Return the day of the year for the first day of the week that the + /** Returns the day of the year for the first day of the week that the given time is within. */ int start_doy_week(int fdow) { return icaltime_start_doy_week(*($self), fdow); } - /** Return the week number for the week the given time is within */ + /** Returns the week number for the week the given time is within */ int week_number() { return icaltime_week_number(*($self)); } - - + + /* ***** Query methods ***** */ - + int is_null_time() { return icaltime_is_null_time(*($self)); } /** Returns false if the time is clearly invalid, but is not null. This @@ -63,10 +63,10 @@ but they do the same thing. */ int is_date() { return icaltime_is_date(*($self)); } int is_utc() { return icaltime_is_utc(*($self)); } - + /* ***** Modify, compare and utility methods ***** */ - - /** Return -1, 0, or 1 to indicate that a<b, a==b or a>b */ + + /** Returns -1, 0, or 1 to indicate that a<b, a==b or a>b */ int compare(const icaltimetype b) { return icaltime_compare(*($self), b); } /** like icaltime_compare, but only use the date parts. */ @@ -89,12 +89,12 @@ } /* ***** Static methods ***** */ - + static icaltimetype from_timet(const time_t tm, const int is_date=0, const icaltimezone *zone=NULL) { return icaltime_from_timet_with_zone(tm, is_date, zone); } - + static icaltimetype null_time(void) { return icaltime_null_time(); } static icaltimetype null_date(void) { return icaltime_null_date(); } @@ -117,18 +117,18 @@ return icaltime_from_string(str); } #endif - - /** Return the number of days in the given month */ + + /** Returns the number of days in the given month */ static int days_in_month(const int month, const int year) { return icaltime_days_in_month(month, year); } - /** Return whether you've specified a leapyear or not. */ + /** Returns whether you've specified a leapyear or not. */ static int is_leap_year (const int year) { return icaltime_is_leap_year(year); } - /** Return the number of days in this year */ + /** Returns the number of days in this year */ /* static int days_in_year (const int year) { return icaltime_days_in_year(year); } */ } @@ -154,7 +154,7 @@ icaltimetype.as_datetime = icaltimetype_as_datetime def icaltimetype_from_datetime(dt): "from_datetime() -> returns icaltimetype object" tt = icaltimetype() - + tt.year = dt.year tt.month = dt.month tt.day = dt.day @@ -166,7 +166,7 @@ def icaltimetype_from_datetime(dt): tt.zone = 0 tt.is_date = False tt.isdaylight = False - + return tt icaltimetype.from_datetime = staticmethod(icaltimetype_from_datetime) diff --git a/src/python/LibicalWrap_icaltimezone.i b/src/python/LibicalWrap_icaltimezone.i index 75c80860..dada5d76 100644 --- a/src/python/LibicalWrap_icaltimezone.i +++ b/src/python/LibicalWrap_icaltimezone.i @@ -78,7 +78,7 @@ void icaltimezone_set_tzid_prefix(const char *new_prefix); * @par Accessing timezones. */ -/** Free any builtin timezone information **/ +/** Frees any builtin timezone information **/ void icaltimezone_free_builtin_timezones(void); /** Returns the array of builtin icaltimezones. */ @@ -118,10 +118,10 @@ int icaltimezone_get_utc_offset_of_utc_time (icaltimezone *zone, * @par Handling the default location the timezone files */ -/** Set the directory to look for the zonefiles */ +/** Sets the directory to look for the zonefiles */ void set_zone_directory(const char *path); -/** Free memory dedicated to the zonefile directory */ +/** Frees memory dedicated to the zonefile directory */ void free_zone_directory(void); void icaltimezone_release_zone_tab(void); diff --git a/src/test/regression-classify.c b/src/test/regression-classify.c index 24480c7c..38cacfee 100644 --- a/src/test/regression-classify.c +++ b/src/test/regression-classify.c @@ -27,7 +27,7 @@ #include <libicalss/icalss.h> #include "regression.h" -/* Get a note about the purpose of the property*/ +/* Gets a note about the purpose of the property*/ static const char *get_note(icalcomponent *c) { icalproperty *p; @@ -49,7 +49,7 @@ static const char *get_note(icalcomponent *c) return note; } -/* Get the expected result about the purpose of the property*/ +/* Gets the expected result about the purpose of the property*/ static const char *get_expect(icalcomponent *c) { diff --git a/src/test/regression-recur.c b/src/test/regression-recur.c index 91dd1a7d..e11112e6 100644 --- a/src/test/regression-recur.c +++ b/src/test/regression-recur.c @@ -38,7 +38,7 @@ static void sig_alrm(int i) #endif -/* Get the expected result about the purpose of the property*/ +/* Gets the expected result about the purpose of the property*/ static int get_expected_numevents(icalcomponent *c) { diff --git a/src/test/regression.c b/src/test/regression.c index 463d0df8..19f22b3d 100644 --- a/src/test/regression.c +++ b/src/test/regression.c @@ -90,7 +90,7 @@ END:BOOGA\ END:VCALENDAR"; */ -/* Return a list of all attendees who are required. */ +/* Returns a list of all attendees who are required. */ /* static char** get_required_attendees(icalcomponent* event) { |