GNOME.org
 

[evolution-data-server] ecal: GIR annotation fixes

commit 81c89081e47547cd36763d0eec2b7101461f3a42
Author: Philip Withnall <philip tecnocode co uk>
Date:   Mon Jun 18 17:24:22 2012 +0100

    ecal: GIR annotation fixes
    
    Various documentation comment fixes and annotation additions. Various APIs
    have been marked as (skip) because they previously werenât introspectable and
    have been deprecated, so thereâs little point making them introspectable and
    cluttering the GIR file with them.

 calendar/libecal/e-cal-check-timezones.c |   18 ++--
 calendar/libecal/e-cal-client-view.c     |    7 +-
 calendar/libecal/e-cal-client.c          |  130 ++++++++++++++++-------------
 calendar/libecal/e-cal-component.c       |  125 +++++++++++++++++------------
 calendar/libecal/e-cal-recur.c           |   27 ++++---
 calendar/libecal/e-cal-util.c            |   46 +++++++----
 calendar/libecal/e-cal-view.c            |    4 +-
 calendar/libecal/e-cal.c                 |   68 ++++++++--------
 8 files changed, 239 insertions(+), 186 deletions(-)
---
diff --git a/calendar/libecal/e-cal-check-timezones.c b/calendar/libecal/e-cal-check-timezones.c
index 2c63601..a32b0cb 100644
--- a/calendar/libecal/e-cal-check-timezones.c
+++ b/calendar/libecal/e-cal-check-timezones.c
@@ -29,7 +29,7 @@
 #include <string.h>
 #include <ctype.h>
 
-/**
+/*
  * Matches a location to a system timezone definition via a fuzzy
  * search and returns the matching TZID, or NULL if none found.
  *
@@ -130,7 +130,7 @@ e_cal_match_tzid (const gchar *tzid)
 
  done:
 	if (systzid && !strcmp(systzid, "UTC")) {
-		/**
+		/*
 		 * UTC is special: it doesn't have a real VTIMEZONE in
 		 * EDS. Matching some pseudo VTTIMEZONE with UTC in the TZID
 		 * to our internal UTC "timezone" breaks
@@ -210,13 +210,13 @@ addsystemtz (gpointer key,
  *            VTIMEZONE and arbitrary other components, in
  *            arbitrary order: these other components are
  *            modified by this call
- * @comps:    a list of icalcomponent instances which
- *            also have to be patched; may be NULL
- * @tzlookup: a callback function which is called to retrieve
+ * @comps: (element-type icalcomponent) (allow-none): a list of #icalcomponent
+ * instances which also have to be patched; may be %NULL
+ * @tzlookup: (allow-none): a callback function which is called to retrieve
  *            a calendar's VTIMEZONE definition; the returned
  *            definition is *not* freed by e_cal_check_timezones()
  *            (to be compatible with e_cal_get_timezone());
- *            NULL indicates that no such timezone exists
+ *            %NULL indicates that no such timezone exists
  *            or an error occurred
  * @custom:   an arbitrary pointer which is passed through to
  *            the tzlookup function
@@ -531,8 +531,8 @@ e_cal_tzlookup_icomp (const gchar *tzid,
  *            VTIMEZONE and arbitrary other components, in
  *            arbitrary order: these other components are
  *            modified by this call
- * @comps:    a list of icalcomponent instances which
- *            also have to be patched; may be NULL
+ * @comps: (element-type icalcomponent) (allow-none): a list of #icalcomponent
+ * instances which also have to be patched; may be %NULL
  * @tzlookup: a callback function which is called to retrieve
  *            a calendar's VTIMEZONE definition; the returned
  *            definition is *not* freed by e_cal_client_check_timezones()
@@ -576,7 +576,7 @@ e_cal_tzlookup_icomp (const gchar *tzid,
  * the TZID. All items referencing the renamed TZID are adapted
  * accordingly.
  *
- * Returns: TRUE if successful, FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
  *
  * Since: 3.2
  **/
diff --git a/calendar/libecal/e-cal-client-view.c b/calendar/libecal/e-cal-client-view.c
index ef09718..d44f27c 100644
--- a/calendar/libecal/e-cal-client-view.c
+++ b/calendar/libecal/e-cal-client-view.c
@@ -428,12 +428,12 @@ _e_cal_client_view_new (ECalClient *client,
 }
 
 /**
- * e_cal_client_view_get_client
+ * e_cal_client_view_get_client:
  * @view: A #ECalClientView object.
  *
  * Get the #ECalClient associated with this view.
  *
- * Returns: the associated client.
+ * Returns: (transfer none): the associated client.
  *
  * Since: 3.2
  **/
@@ -530,7 +530,8 @@ e_cal_client_view_stop (ECalClientView *view,
 /**
  * e_cal_client_view_set_fields_of_interest:
  * @view: An #ECalClientView object
- * @fields_of_interest: List of field names in which the client is interested
+ * @fields_of_interest: (element-type utf8) (allow-none): List of field names in
+ * which the client is interested, or %NULL to reset the fields of interest
  * @error: A #GError
  *
  * Client can instruct server to which fields it is interested in only, thus
diff --git a/calendar/libecal/e-cal-client.c b/calendar/libecal/e-cal-client.c
index e1e37bf..79859b0 100644
--- a/calendar/libecal/e-cal-client.c
+++ b/calendar/libecal/e-cal-client.c
@@ -65,7 +65,7 @@ static guint signals[LAST_SIGNAL];
 
 G_DEFINE_TYPE (ECalClient, e_cal_client, E_TYPE_CLIENT)
 
-/**
+/*
  * Well-known calendar backend properties:
  * @CAL_BACKEND_PROPERTY_CAL_EMAIL_ADDRESS: Contains default calendar's email
  *   address suggested by the backend.
@@ -79,7 +79,7 @@ G_DEFINE_TYPE (ECalClient, e_cal_client, E_TYPE_CLIENT)
  * See also: @CLIENT_BACKEND_PROPERTY_OPENED, @CLIENT_BACKEND_PROPERTY_OPENING,
  *   @CLIENT_BACKEND_PROPERTY_ONLINE, @CLIENT_BACKEND_PROPERTY_READONLY
  *   @CLIENT_BACKEND_PROPERTY_CACHE_DIR, @CLIENT_BACKEND_PROPERTY_CAPABILITIES
- **/
+ */
 
 /**
  * e_cal_client_source_type_enum_get_type:
@@ -169,7 +169,7 @@ e_cal_client_error_create (ECalClientError code,
 	return g_error_new_literal (E_CAL_CLIENT_ERROR, code, custom_msg ? custom_msg : e_cal_client_error_to_string (code));
 }
 
-/**
+/*
  * If the specified GError is a remote error, then create a new error
  * representing the remote error.  If the error is anything else, then
  * leave it alone.
@@ -701,7 +701,7 @@ e_cal_client_get_source_type (ECalClient *client)
 }
 
 /**
- * e_cal_client_get_local_attachment_store
+ * e_cal_client_get_local_attachment_store:
  * @client: A calendar client.
  *
  * Queries the URL where the calendar attachments are
@@ -907,10 +907,10 @@ e_cal_client_check_recurrences_no_master (ECalClient *client)
 
 /**
  * e_cal_client_free_icalcomp_slist:
- * @icalcomps: slist of icalcomponent objects
+ * @icalcomps: (element-type icalcomponent): list of icalcomponent objects
  *
- * Frees each element of @icalcomps list and the list itself.
- * Each element is an object of icalcomponent type.
+ * Frees each element of the @icalcomps list and the list itself.
+ * Each element is an object of type #icalcomponent.
  *
  * Since: 3.2
  **/
@@ -923,10 +923,10 @@ e_cal_client_free_icalcomp_slist (GSList *icalcomps)
 
 /**
  * e_cal_client_free_ecalcomp_slist:
- * @ecalcomps: list of ECalComponent objects
+ * @ecalcomps: (element-type ECalComponent): list of #ECalComponent objects
  *
- * Frees each element of @ecalcomps list and the list itself.
- * Each element is an object of ECalComponent type.
+ * Frees each element of the @ecalcomps list and the list itself.
+ * Each element is an object of type #ECalComponent.
  *
  * Since: 3.2
  **/
@@ -1655,17 +1655,17 @@ e_cal_client_generate_instances (ECalClient *client,
 
 /**
  * e_cal_client_generate_instances_sync:
- * @client: A calendar client.
- * @start: Start time for query.
- * @end: End time for query.
- * @cb: Callback for each generated instance.
- * @cb_data: Closure data for the callback.
+ * @client: A calendar client
+ * @start: Start time for query
+ * @end: End time for query
+ * @cb: (closure cb_data) (scope call): Callback for each generated instance
+ * @cb_data: (closure): Closure data for the callback
  *
- * Does a combination of #e_cal_client_get_object_list () and
- * #e_cal_client_recur_generate_instances().
+ * Does a combination of e_cal_client_get_object_list() and
+ * e_cal_client_recur_generate_instances().
  *
  * The callback function should do a g_object_ref() of the calendar component
- * it gets passed if it intends to keep it around, since it will be unref'ed
+ * it gets passed if it intends to keep it around, since it will be unreffed
  * as soon as the callback returns.
  *
  * Since: 3.2
@@ -1875,12 +1875,12 @@ e_cal_client_generate_instances_for_object (ECalClient *client,
 
 /**
  * e_cal_client_generate_instances_for_object_sync:
- * @client: A calendar client.
- * @icalcomp: Object to generate instances from.
- * @start: Start time for query.
- * @end: End time for query.
- * @cb: Callback for each generated instance.
- * @cb_data: Closure data for the callback.
+ * @client: A calendar client
+ * @icalcomp: Object to generate instances from
+ * @start: Start time for query
+ * @end: End time for query
+ * @cb: (closure cb_data) (scope call): Callback for each generated instance
+ * @cb_data: (closure): Closure data for the callback
  *
  * Does a combination of #e_cal_client_get_object_list () and
  * #e_cal_client_recur_generate_instances(), like #e_cal_client_generate_instances_sync(), but
@@ -2885,11 +2885,12 @@ complete_get_objects_for_uid (ECalClientSourceType source_type,
  * e_cal_client_get_objects_for_uid_finish:
  * @client: an #ECalClient
  * @result: a #GAsyncResult
- * @ecalcomps: (out): Return value for the list of objects obtained from the backend
+ * @ecalcomps: (out) (transfer full) (element-type ECalComponent): Return value
+ * for the list of objects obtained from the backend
  * @error: (out): a #GError to set an error, if any
  *
  * Finishes previous call of e_cal_client_get_objects_for_uid() and
- * sets @ecalcomps to a list of #ECalComponent-s corresponding to
+ * sets @ecalcomps to a list of #ECalComponent<!-- -->s corresponding to
  * found components for a given uid of the same type as this client.
  * This list should be freed with e_cal_client_free_ecalcomp_slist().
  *
@@ -2917,8 +2918,9 @@ e_cal_client_get_objects_for_uid_finish (ECalClient *client,
  * e_cal_client_get_objects_for_uid_sync:
  * @client: an #ECalClient
  * @uid: Unique identifier for a calendar component
- * @ecalcomps: (out): Return value for the list of objects obtained from the backend
- * @cancellable: a #GCancellable; can be %NULL
+ * @ecalcomps: (out) (transfer full) (element-type ECalComponent): Return value
+ * for the list of objects obtained from the backend
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Queries a calendar for all calendar components with the given unique
@@ -3026,7 +3028,8 @@ complete_get_object_list (gboolean res,
  * e_cal_client_get_object_list_finish:
  * @client: an #ECalClient
  * @result: a #GAsyncResult
- * @icalcomps: (out): list of matching #icalcomponent-s
+ * @icalcomps: (out) (element-type icalcomponent): list of matching
+ * #icalcomponent<!-- -->s
  * @error: (out): a #GError to set an error, if any
  *
  * Finishes previous call of e_cal_client_get_object_list() and
@@ -3057,8 +3060,9 @@ e_cal_client_get_object_list_finish (ECalClient *client,
  * e_cal_client_get_object_list_sync:
  * @client: an #ECalClient
  * @sexp: an S-expression representing the query
- * @icalcomps: (out): list of matching #icalcomponent-s
- * @cancellable: a #GCancellable; can be %NULL
+ * @icalcomps: (out) (element-type icalcomponent): list of matching
+ * #icalcomponent<!-- -->s
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Gets a list of objects from the calendar that match the query specified
@@ -3170,7 +3174,8 @@ complete_get_object_list_as_comps (gboolean res,
  * e_cal_client_get_object_list_as_comps_finish:
  * @client: an #ECalClient
  * @result: a #GAsyncResult
- * @ecalcomps: (out): list of matching #ECalComponent-s
+ * @ecalcomps: (out) (element-type ECalComponent): list of matching
+ * #ECalComponent<!-- -->s
  * @error: (out): a #GError to set an error, if any
  *
  * Finishes previous call of e_cal_client_get_object_list_as_comps() and
@@ -3201,8 +3206,9 @@ e_cal_client_get_object_list_as_comps_finish (ECalClient *client,
  * e_cal_client_get_object_list_as_comps_sync:
  * @client: an #ECalClient
  * @sexp: an S-expression representing the query
- * @ecalcomps: (out): list of matching #ECalComponent-s
- * @cancellable: a #GCancellable; can be %NULL
+ * @ecalcomps: (out) (element-type ECalComponent): list of matching
+ * #ECalComponent<!-- -->s
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Gets a list of objects from the calendar that match the query specified
@@ -3244,8 +3250,8 @@ e_cal_client_get_object_list_as_comps_sync (ECalClient *client,
  * @client: an #ECalClient
  * @start: Start time for query
  * @end: End time for query
- * @users: List of users to retrieve free/busy information for
- * @cancellable: a #GCancellable; can be %NULL
+ * @users: (element-type utf8): List of users to retrieve free/busy information for
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @callback: callback to call when a result is ready
  * @user_data: user data for the @callback
  *
@@ -3306,8 +3312,8 @@ e_cal_client_get_free_busy_finish (ECalClient *client,
  * @client: an #ECalClient
  * @start: Start time for query
  * @end: End time for query
- * @users: List of users to retrieve free/busy information for
- * @cancellable: a #GCancellable; can be %NULL
+ * @users: (element-type utf8): List of users to retrieve free/busy information for
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Gets free/busy information from the calendar server.
@@ -3483,8 +3489,8 @@ e_cal_client_create_object_sync (ECalClient *client,
 /**
  * e_cal_client_create_objects:
  * @client: an #ECalClient
- * @icalcomps: The components to create
- * @cancellable: a #GCancellable; can be %NULL
+ * @icalcomps: (element-type icalcomponent): The components to create
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @callback: callback to call when a result is ready
  * @user_data: user data for the @callback
  *
@@ -3521,7 +3527,8 @@ e_cal_client_create_objects (ECalClient *client,
  * e_cal_client_create_objects_finish:
  * @client: an #ECalClient
  * @result: a #GAsyncResult
- * @uids: (out): Return value for the UIDs assigned to the new components by the calendar backend
+ * @uids: (out) (element-type utf8): Return value for the UIDs assigned to the
+ * new components by the calendar backend
  * @error: (out): a #GError to set an error, if any
  *
  * Finishes previous call of e_cal_client_create_objects() and
@@ -3552,9 +3559,10 @@ e_cal_client_create_objects_finish (ECalClient *client,
 /**
  * e_cal_client_create_objects_sync:
  * @client: an #ECalClient
- * @icalcomps: The components to create
- * @uids: (out): Return value for the UIDs assigned to the new components by the calendar backend
- * @cancellable: a #GCancellable; can be %NULL
+ * @icalcomps: (element-type icalcomponent): The components to create
+ * @uids: (out) (element-type utf8): Return value for the UIDs assigned to the
+ * new components by the calendar backend
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Requests the calendar backend to create the objects specified by the @icalcomps
@@ -3714,9 +3722,9 @@ e_cal_client_modify_object_sync (ECalClient *client,
 /**
  * e_cal_client_modify_objects:
  * @client: an #ECalClient
- * @comps: Components to modify
+ * @comps: (element-type icalcomponent): Components to modify
  * @mod: Type of modification
- * @cancellable: a #GCancellable; can be %NULL
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @callback: callback to call when a result is ready
  * @user_data: user data for the @callback
  *
@@ -3783,9 +3791,9 @@ e_cal_client_modify_objects_finish (ECalClient *client,
 /**
  * e_cal_client_modify_objects_sync:
  * @client: an #ECalClient
- * @comps: Components to modify
+ * @comps: (element-type icalcomponent): Components to modify
  * @mod: Type of modification
- * @cancellable: a #GCancellable; can be %NULL
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Requests the calendar backend to modify existing objects. If an object
@@ -3953,7 +3961,8 @@ e_cal_client_remove_object_sync (ECalClient *client,
 /**
  * e_cal_client_remove_objects:
  * @client: an #ECalClient
- * @ids: A list of #ECalComponentId objects identifying the objects to remove
+ * @ids: (element-type ECalComponentId): A list of #ECalComponentId objects
+ * identifying the objects to remove
  * @mod: Type of the removal
  * @cancellable: a #GCancellable; can be %NULL
  * @callback: callback to call when a result is ready
@@ -4013,9 +4022,10 @@ e_cal_client_remove_objects_finish (ECalClient *client,
 /**
  * e_cal_client_remove_objects_sync:
  * @client: an #ECalClient
- * @ids: A list of #ECalComponentId objects identifying the objects to remove
+ * @ids: (element-type ECalComponentId): A list of #ECalComponentId objects
+ * identifying the objects to remove
  * @mod: Type of the removal
- * @cancellable: a #GCancellable; can be %NULL
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * This function allows the removal of instances of recurrent
@@ -4234,7 +4244,8 @@ complete_send_objects (gboolean res,
  * e_cal_client_send_objects_finish:
  * @client: an #ECalClient
  * @result: a #GAsyncResult
- * @users: (out): List of users to send the @modified_icalcomp to
+ * @users: (out) (element-type utf8): List of users to send
+ * the @modified_icalcomp to
  * @modified_icalcomp: (out): Return value for the icalcomponent to be sent
  * @error: (out): a #GError to set an error, if any
  *
@@ -4269,9 +4280,10 @@ e_cal_client_send_objects_finish (ECalClient *client,
  * e_cal_client_send_objects_sync:
  * @client: an #ECalClient
  * @icalcomp: An icalcomponent to be sent
- * @users: (out): List of users to send the @modified_icalcomp to
+ * @users: (out) (element-type utf8): List of users to send
+ * the @modified_icalcomp to
  * @modified_icalcomp: (out): Return value for the icalcomponent to be sent
- * @cancellable: a #GCancellable; can be %NULL
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
  * Requests a calendar backend to send meeting information stored in @icalcomp.
@@ -4354,7 +4366,8 @@ e_cal_client_get_attachment_uris (ECalClient *client,
  * e_cal_client_get_attachment_uris_finish:
  * @client: an #ECalClient
  * @result: a #GAsyncResult
- * @attachment_uris: (out:) Return the list of attachment uris
+ * @attachment_uris: (out) (element-type utf8): Return the list of attachment
+ * URIs
  * @error: (out): a #GError to set an error, if any
  *
  * Finishes previous call of e_cal_client_get_attachment_uris() and
@@ -4394,11 +4407,12 @@ e_cal_client_get_attachment_uris_finish (ECalClient *client,
  * @client: an #ECalClient
  * @uid: Unique identifier for a calendar component
  * @rid: Recurrence identifier
- * @attachment_uris: (out:) Return the list of attachment uris
- * @cancellable: a #GCancellable; can be %NULL
+ * @attachment_uris: (out) (element-type utf8): Return the list of attachment
+ * URIs
+ * @cancellable: (allow-none): a #GCancellable; can be %NULL
  * @error: (out): a #GError to set an error, if any
  *
- * Queries a calendar for a specified component's object attachment uris.
+ * Queries a calendar for a specified component's object attachment URIs.
  * The list should be freed with e_client_util_free_string_slist().
  *
  * Returns: %TRUE if successful, %FALSE otherwise.
diff --git a/calendar/libecal/e-cal-component.c b/calendar/libecal/e-cal-component.c
index 0e0b8d1..14ad046 100644
--- a/calendar/libecal/e-cal-component.c
+++ b/calendar/libecal/e-cal-component.c
@@ -496,8 +496,8 @@ e_cal_component_new_from_icalcomponent (icalcomponent *icalcomp)
  * Creates a new calendar component object by copying the information from
  * another one.
  *
- * Returns: A newly-created calendar component with the same values as the
- * original one.
+ * Returns: (transfer full): A newly-created calendar component with the same
+ * values as the original one.
  **/
 ECalComponent *
 e_cal_component_clone (ECalComponent *comp)
@@ -1690,11 +1690,12 @@ set_attachment_list (icalcomponent *icalcomp,
 
 /**
  * e_cal_component_get_attachment_list:
- * @comp: A calendar component object.
- * @attachment_list: Return list of URLS to attachments.
+ * @comp: A calendar component object
+ * @attachment_list: (out) (transfer full) (element-type utf8): Return list of
+ * URIs to attachments
  *
  * Queries the attachment properties of the calendar component object. When done,
- * the @attachment_list should be freed by calling #g_slist_free.
+ * the @attachment_list should be freed by calling g_slist_free().
  **/
 void
 e_cal_component_get_attachment_list (ECalComponent *comp,
@@ -1714,10 +1715,10 @@ e_cal_component_get_attachment_list (ECalComponent *comp,
 
 /**
  * e_cal_component_set_attachment_list:
- * @comp: A calendar component object.
- * @attachment_list: list of urls to attachment pointers.
+ * @comp: A calendar component object
+ * @attachment_list: (element-type utf8): list of URIs to attachment pointers
  *
- * This currently handles only attachments that are urls
+ * This currently handles only attachments that are URIs
  * in the file system - not inline binaries.
  *
  * Sets the attachments of a calendar component object
@@ -1870,8 +1871,9 @@ e_cal_component_set_categories (ECalComponent *comp,
 /**
  * e_cal_component_get_categories_list:
  * @comp: A calendar component object.
- * @categ_list: Return value for the list of strings, where each string is a
- * category. This should be freed using e_cal_component_free_categories_list().
+ * @categ_list: (out) (transfer full) (element-type utf8): Return value for the
+ * list of strings, where each string is a category. This should be freed using
+ * e_cal_component_free_categories_list().
  *
  * Queries the list of categories of a calendar component object.  Each element
  * in the returned categ_list is a string with the corresponding category.
@@ -1951,7 +1953,7 @@ stringify_categories (GSList *categ_list)
 /**
  * e_cal_component_set_categories_list:
  * @comp: A calendar component object.
- * @categ_list: List of strings, one for each category.
+ * @categ_list: (element-type utf8): List of strings, one for each category.
  *
  * Sets the list of categories of a calendar component object.
  **/
@@ -2177,8 +2179,9 @@ set_text_list (ECalComponent *comp,
 /**
  * e_cal_component_get_comment_list:
  * @comp: A calendar component object.
- * @text_list: Return value for the comment properties and their parameters, as
- * a list of #ECalComponentText structures.  This should be freed using the
+ * @text_list: (out) (transfer full) (element-type ECalComponentText): Return
+ * value for the comment properties and their parameters, as a list of
+ * #ECalComponentText structures.  This should be freed using the
  * e_cal_component_free_text_list() function.
  *
  * Queries the comments of a calendar component object.  The comment property can
@@ -2204,7 +2207,8 @@ e_cal_component_get_comment_list (ECalComponent *comp,
 /**
  * e_cal_component_set_comment_list:
  * @comp: A calendar component object.
- * @text_list: List of #ECalComponentText structures.
+ * @text_list: (element-type ECalComponentText): List of #ECalComponentText
+ * structures.
  *
  * Sets the comments of a calendar component object.  The comment property can
  * appear several times inside a calendar component, and so a list of
@@ -2228,8 +2232,9 @@ e_cal_component_set_comment_list (ECalComponent *comp,
 /**
  * e_cal_component_get_contact_list:
  * @comp: A calendar component object.
- * @text_list: Return value for the contact properties and their parameters, as
- * a list of #ECalComponentText structures.  This should be freed using the
+ * @text_list: (out) (transfer full) (element-type ECalComponentText): Return
+ * value for the contact properties and their parameters, as a list of
+ * #ECalComponentText structures.  This should be freed using the
  * e_cal_component_free_text_list() function.
  *
  * Queries the contact of a calendar component object.  The contact property can
@@ -2255,7 +2260,8 @@ e_cal_component_get_contact_list (ECalComponent *comp,
 /**
  * e_cal_component_set_contact_list:
  * @comp: A calendar component object.
- * @text_list: List of #ECalComponentText structures.
+ * @text_list: (element-type ECalComponentText): List of #ECalComponentText
+ * structures.
  *
  * Sets the contact of a calendar component object.  The contact property can
  * appear several times inside a calendar component, and so a list of
@@ -2426,8 +2432,9 @@ e_cal_component_set_created (ECalComponent *comp,
 /**
  * e_cal_component_get_description_list:
  * @comp: A calendar component object.
- * @text_list: Return value for the description properties and their parameters,
- * as a list of #ECalComponentText structures.  This should be freed using the
+ * @text_list: (out) (transfer full) (element-type ECalComponentText): Return
+ * value for the description properties and their parameters, as a list of
+ * #ECalComponentText structures.  This should be freed using the
  * e_cal_component_free_text_list() function.
  *
  * Queries the description of a calendar component object.  Journal components
@@ -2454,7 +2461,8 @@ e_cal_component_get_description_list (ECalComponent *comp,
 /**
  * e_cal_component_set_description_list:
  * @comp: A calendar component object.
- * @text_list: List of #ECalComponentSummary structures.
+ * @text_list: (element-type ECalComponentSummary): List of
+ * #ECalComponentSummary structures.
  *
  * Sets the description of a calendar component object.  Journal components may
  * have more than one description, and as such this function takes in a list of
@@ -2988,7 +2996,8 @@ set_period_list (ECalComponent *comp,
 /**
  * e_cal_component_get_exdate_list:
  * @comp: A calendar component object.
- * @exdate_list: Return value for the list of exception dates, as a list of
+ * @exdate_list: (out) (transfer full) (element-type ECalComponentDateTime):
+ * Return value for the list of exception dates, as a list of
  * #ECalComponentDateTime structures.  This should be freed using the
  * e_cal_component_free_exdate_list() function.
  *
@@ -3035,7 +3044,8 @@ e_cal_component_get_exdate_list (ECalComponent *comp,
 /**
  * e_cal_component_set_exdate_list:
  * @comp: A calendar component object.
- * @exdate_list: List of #ECalComponentDateTime structures.
+ * @exdate_list: (element-type ECalComponentDateTime): List of
+ * #ECalComponentDateTime structures.
  *
  * Sets the list of exception dates in a calendar component object.
  **/
@@ -3192,9 +3202,9 @@ set_recur_list (ECalComponent *comp,
 /**
  * e_cal_component_get_exrule_list:
  * @comp: A calendar component object.
- * @recur_list: List of exception rules as struct #icalrecurrencetype
- * structures.  This should be freed using the e_cal_component_free_recur_list()
- * function.
+ * @recur_list: (out) (element-type icalrecurrencetype) (transfer full): List of
+ * exception rules as struct #icalrecurrencetype structures.  This should be
+ * freed using the e_cal_component_free_recur_list() function.
  *
  * Queries the list of exception rule properties of a calendar component
  * object.
@@ -3218,7 +3228,8 @@ e_cal_component_get_exrule_list (ECalComponent *comp,
 /**
  * e_cal_component_get_exrule_property_list:
  * @comp: A calendar component object.
- * @recur_list: Returns a list of exception rule properties.
+ * @recur_list: (out) (transfer none) (element-type icalrecurrencetype):
+ * Returns a list of exception rule properties
  *
  * Queries the list of exception rule properties of a calendar component object.
  **/
@@ -3241,7 +3252,8 @@ e_cal_component_get_exrule_property_list (ECalComponent *comp,
 /**
  * e_cal_component_set_exrule_list:
  * @comp: A calendar component object.
- * @recur_list: List of struct #icalrecurrencetype structures.
+ * @recur_list: (element-type icalrecurrencetype): List of struct
+ * #icalrecurrencetype structures.
  *
  * Sets the list of exception rules in a calendar component object.
  **/
@@ -3850,9 +3862,10 @@ e_cal_component_set_recurid (ECalComponent *comp,
 /**
  * e_cal_component_get_rdate_list:
  * @comp: A calendar component object.
- * @period_list: Return value for the list of recurrence dates, as a list of
- * #ECalComponentPeriod structures.  This should be freed using the
- * e_cal_component_free_period_list() function.
+ * @period_list: (out) (transfer full) (element-type ECalComponentPeriod):
+ * Return value for the list of recurrence dates, as a list of
+ * #ECalComponentPeriod structures.  This should be freed using
+ * e_cal_component_free_period_list()
  *
  * Queries the list of recurrence date properties in a calendar component
  * object.
@@ -3876,7 +3889,8 @@ e_cal_component_get_rdate_list (ECalComponent *comp,
 /**
  * e_cal_component_set_rdate_list:
  * @comp: A calendar component object.
- * @period_list: List of #ECalComponentPeriod structures.
+ * @period_list: (element-type ECalComponentPeriod): List of
+ * #ECalComponentPeriod structures
  *
  * Sets the list of recurrence dates in a calendar component object.
  **/
@@ -3923,9 +3937,9 @@ e_cal_component_has_rdates (ECalComponent *comp)
 /**
  * e_cal_component_get_rrule_list:
  * @comp: A calendar component object.
- * @recur_list: List of recurrence rules as struct #icalrecurrencetype
- * structures.  This should be freed using the e_cal_component_free_recur_list()
- * function.
+ * @recur_list: (out) (transfer full) (element-type icalrecurrencetype): List of
+ * recurrence rules as struct #icalrecurrencetype structures.  This should be
+ * freed using e_cal_component_free_recur_list().
  *
  * Queries the list of recurrence rule properties of a calendar component
  * object.
@@ -3949,7 +3963,8 @@ e_cal_component_get_rrule_list (ECalComponent *comp,
 /**
  * e_cal_component_get_rrule_property_list:
  * @comp: A calendar component object.
- * @recur_list: Returns a list of recurrence rule properties.
+ * @recur_list: (out) (transfer none) (element-type icalrecurrencetype): Returns
+ * a list of recurrence rule properties.
  *
  * Queries a list of recurrence rule properties of a calendar component object.
  **/
@@ -3972,7 +3987,8 @@ e_cal_component_get_rrule_property_list (ECalComponent *comp,
 /**
  * e_cal_component_set_rrule_list:
  * @comp: A calendar component object.
- * @recur_list: List of struct #icalrecurrencetype structures.
+ * @recur_list: (element-type icalrecurrencetype): List of struct
+ * #icalrecurrencetype structures.
  *
  * Sets the list of recurrence rules in a calendar component object.
  **/
@@ -4308,7 +4324,7 @@ e_cal_component_set_sequence (ECalComponent *comp,
 /**
  * e_cal_component_get_status:
  * @comp: A calendar component object.
- * @status: Return value for the status value.  It is set to #ICAL_STATUS_NONE
+ * @status: (out): Return value for the status value.  It is set to #ICAL_STATUS_NONE
  * if the component has no status property.
  *
  * Queries the status property of a calendar component object.
@@ -4828,9 +4844,9 @@ set_attendee_list (icalcomponent *icalcomp,
 /**
  * e_cal_component_get_attendee_list:
  * @comp: A calendar component object.
- * @attendee_list: Return value for the attendee property.
- * This should be freed using the e_cal_component_free_attendee_list ()
- * function.
+ * @attendee_list: (out) (transfer full) (element-type ECalComponentAttendee):
+ * Return value for the attendee property. This should be freed using
+ * e_cal_component_free_attendee_list().
  *
  * Queries the attendee properties of the calendar component object
  **/
@@ -4853,7 +4869,8 @@ e_cal_component_get_attendee_list (ECalComponent *comp,
 /**
  * e_cal_component_set_attendee_list:
  * @comp: A calendar component object.
- * @attendee_list: Values for attendee properties
+ * @attendee_list: (element-type ECalComponentAttendee): Values for attendee
+ * properties
  *
  * Sets the attendees of a calendar component object
  **/
@@ -4963,7 +4980,7 @@ e_cal_component_set_location (ECalComponent *comp,
 
 /**
  * e_cal_component_free_categories_list:
- * @categ_list: List of category strings.
+ * @categ_list: (element-type utf8): List of category strings
  *
  * Frees a list of category strings.
  **/
@@ -5012,7 +5029,8 @@ e_cal_component_free_range (ECalComponentRange *range)
 
 /**
  * e_cal_component_free_exdate_list:
- * @exdate_list: List of #ECalComponentDateTime structures.
+ * @exdate_list: (element-type ECalComponentDateTime): List of
+ * #ECalComponentDateTime structures
  *
  * Frees a list of #ECalComponentDateTime structures as returned by the
  * e_cal_component_get_exdate_list() function.
@@ -5100,7 +5118,8 @@ e_cal_component_free_priority (gint *priority)
 
 /**
  * e_cal_component_free_period_list:
- * @period_list: List of #ECalComponentPeriod structures.
+ * @period_list: (element-type ECalComponentPeriod): List of
+ * #ECalComponentPeriod structures
  *
  * Frees a list of #ECalComponentPeriod structures.
  **/
@@ -5113,7 +5132,8 @@ e_cal_component_free_period_list (GSList *period_list)
 
 /**
  * e_cal_component_free_recur_list:
- * @recur_list: List of struct #icalrecurrencetype structures.
+ * @recur_list: (element-type icalrecurrencetype): List of struct
+ * #icalrecurrencetype structures.
  *
  * Frees a list of struct #icalrecurrencetype structures.
  **/
@@ -5164,7 +5184,8 @@ e_cal_component_free_id (ECalComponentId *id)
 
 /**
  * e_cal_component_free_text_list:
- * @text_list: List of #ECalComponentText structures.
+ * @text_list: (element-type ECalComponentText): List of #ECalComponentText
+ * structures.
  *
  * Frees a list of #ECalComponentText structures.  This function should only be
  * used to free lists of text values as returned by the other getter functions
@@ -5179,7 +5200,7 @@ e_cal_component_free_text_list (GSList *text_list)
 
 /**
  * e_cal_component_free_attendee_list:
- * @attendee_list:  List of attendees.
+ * @attendee_list: (element-type ECalComponentAttendee): List of attendees
  *
  * Frees a list of #ECalComponentAttendee structures.
  *
@@ -5410,8 +5431,8 @@ make_alarm (icalcomponent *subcomp)
  * Builds a list of the unique identifiers of the alarm subcomponents inside a
  * calendar component.
  *
- * Returns: List of unique identifiers for alarms.  This should be freed
- * using cal_obj_uid_list_free().
+ * Returns: (element-type utf8) (transfer full): List of unique identifiers for
+ * alarms.  This should be freed using cal_obj_uid_list_free().
  **/
 GList *
 e_cal_component_get_alarm_uids (ECalComponent *comp)
@@ -6071,7 +6092,7 @@ e_cal_component_alarm_set_trigger (ECalComponentAlarm *alarm,
 /**
  * e_cal_component_alarm_get_attendee_list:
  * @alarm: An alarm.
- * @attendee_list: Return value for the list of attendees.
+ * @attendee_list: (out) (transfer full) (element-type ECalComponentAttendee): Return value for the list of attendees.
  *
  * Gets the list of attendees associated with an alarm.
  */
@@ -6087,7 +6108,7 @@ e_cal_component_alarm_get_attendee_list (ECalComponentAlarm *alarm,
 /**
  * e_cal_component_alarm_set_attendee_list:
  * @alarm: An alarm.
- * @attendee_list: List of attendees.
+ * @attendee_list: (element-type ECalComponentAttendee): List of attendees.
  *
  * Sets the list of attendees for an alarm.
  */
@@ -6121,7 +6142,7 @@ e_cal_component_alarm_has_attendees (ECalComponentAlarm *alarm)
 }
 
 /**
- * e_cal_component_alarm_get_icalcomponent
+ * e_cal_component_alarm_get_icalcomponent:
  * @alarm: An alarm.
  *
  * Get the icalcomponent associated with the given #ECalComponentAlarm.
diff --git a/calendar/libecal/e-cal-recur.c b/calendar/libecal/e-cal-recur.c
index d214b00..ec7baf3 100644
--- a/calendar/libecal/e-cal-recur.c
+++ b/calendar/libecal/e-cal-recur.c
@@ -595,15 +595,15 @@ static ECalRecurVTable cal_obj_secondly_vtable = {
 
 /**
  * e_cal_recur_generate_instances:
- * @comp: A calendar component object.
- * @start: Range start time.
- * @end: Range end time.
- * @cb: Callback function.
- * @cb_data: Closure data for the callback function.
- * @tz_cb: Callback for retrieving timezones.
- * @tz_cb_data: Closure data for the timezone callback.
+ * @comp: A calendar component object
+ * @start: Range start time
+ * @end: Range end time
+ * @cb: (closure cb_data) (scope call): Callback function
+ * @cb_data: (closure): Closure data for the callback function
+ * @tz_cb: (closure tz_cb_data) (scope call): Callback for retrieving timezones
+ * @tz_cb_data: (closure): Closure data for the timezone callback
  * @default_timezone: Default timezone to use when a timezone cannot be
- * found.
+ * found
  *
  * Calls the given callback function for each occurrence of the event that
  * intersects the range between the given @start and @end times (the end time is
@@ -902,8 +902,8 @@ array_to_list (gshort *array,
 	return g_list_reverse (l);
 }
 
-/** 
- * e_cal_recur_get_enddate
+/**
+ * e_cal_recur_get_enddate:
  * @ir: RRULE or EXRULE recurrence 
  * @prop: An RRULE or EXRULE #icalproperty. 
  * @zone: The DTSTART timezone, used for converting the UNTIL property if it
@@ -3776,6 +3776,11 @@ cal_obj_time_to_string (CalObjTime *cotime)
 
 /**
  * e_cal_recur_ensure_end_dates:
+ * @comp: an #ECalComponent
+ * @refresh: %TRUE to recalculate all end dates
+ * @tz_cb: (closure tz_cb_data) (scope call): function to call to resolve
+ * timezones
+ * @tz_cb_data: (closure): data to pass to @tz_cb
  *
  * This recalculates the end dates for recurrence & exception rules which use
  * the COUNT property. If @refresh is %TRUE it will recalculate all enddates
@@ -3785,6 +3790,8 @@ cal_obj_time_to_string (CalObjTime *cotime)
  * We store the enddate in the "X-EVOLUTION-ENDDATE" parameter of the RRULE
  * or EXRULE.
  *
+ * Returns: %TRUE if the component was changed, %FALSE otherwise
+ *
  * Since: 2.32
  **/
 gboolean
diff --git a/calendar/libecal/e-cal-util.c b/calendar/libecal/e-cal-util.c
index 8ccec1b..8a8746b 100644
--- a/calendar/libecal/e-cal-util.c
+++ b/calendar/libecal/e-cal-util.c
@@ -556,23 +556,24 @@ compare_alarm_instance (gconstpointer a,
 }
 
 /**
- * e_cal_util_generate_alarms_for_comp
- * @comp: The #ECalComponent to generate alarms from.
- * @start: Start time.
- * @end: End time.
+ * e_cal_util_generate_alarms_for_comp:
+ * @comp: The #ECalComponent to generate alarms from
+ * @start: Start time
+ * @end: End time
  * @omit: Alarm types to omit
- * @resolve_tzid: Callback for resolving timezones
- * @user_data: Data to be passed to the resolve_tzid callback
+ * @resolve_tzid: (closure user_data) (scope call): Callback for resolving
+ * timezones
+ * @user_data: (closure): Data to be passed to the resolve_tzid callback
  * @default_timezone: The timezone used to resolve DATE and floating DATE-TIME
  * values.
  *
  * Generates alarm instances for a calendar component.  Returns the instances
- * structure, or NULL if no alarm instances occurred in the specified time
+ * structure, or %NULL if no alarm instances occurred in the specified time
  * range.
  *
- * Returns: a list of all the alarms found for the given component on
- * the given time tange. The list of alarms should be freed by using the
- * #e_cal_component_free_alarm_list function.
+ * Returns: (allow-none) (transfer full): a list of all the alarms found for the
+ * given component in the given time range. The list of alarms should be freed
+ * by using e_cal_component_free_alarm_list().
  */
 ECalComponentAlarms *
 e_cal_util_generate_alarms_for_comp (ECalComponent *comp,
@@ -625,21 +626,23 @@ e_cal_util_generate_alarms_for_comp (ECalComponent *comp,
 }
 
 /**
- * e_cal_util_generate_alarms_for_list
- * @comps: List of #ECalComponent's.
- * @start: Start time.
- * @end: End time.
+ * e_cal_util_generate_alarms_for_list:
+ * @comps: (element-type ECalComponent): List of #ECalComponent<!-- -->s
+ * @start: Start time
+ * @end: End time
  * @omit: Alarm types to omit
- * @comp_alarms: List to be returned
- * @resolve_tzid: Callback for resolving timezones
- * @user_data: Data to be passed to the resolve_tzid callback
+ * @comp_alarms: (out) (transfer full) (element-type ECalComponentAlarms): List
+ * to be returned
+ * @resolve_tzid: (closure user_data) (scope call): Callback for resolving
+ * timezones
+ * @user_data: (closure): Data to be passed to the resolve_tzid callback
  * @default_timezone: The timezone used to resolve DATE and floating DATE-TIME
  * values.
  *
  * Iterates through all the components in the @comps list and generates alarm
  * instances for them; putting them in the @comp_alarms list.
  *
- * Returns: the number of elements it added to the list.
+ * Returns: the number of elements it added to the list
  */
 gint
 e_cal_util_generate_alarms_for_list (GList *comps,
@@ -1213,6 +1216,13 @@ componenttime_to_utc_timet (const ECalComponentDateTime *dt_time,
 
 /**
  * e_cal_util_get_component_occur_times:
+ * @comp: an #ECalComponent
+ * @start: (out):
+ * @end: (out):
+ * @tz_cb: (closure tz_cb_data) (scope call):
+ * @tz_cb_data: (closure):
+ * @default_timezone:
+ * @kind:
  *
  * Find out when the component starts and stops, being careful about
  * recurrences.
diff --git a/calendar/libecal/e-cal-view.c b/calendar/libecal/e-cal-view.c
index fef6179..fdcd323 100644
--- a/calendar/libecal/e-cal-view.c
+++ b/calendar/libecal/e-cal-view.c
@@ -409,12 +409,12 @@ _e_cal_view_new (ECal *ecal,
 }
 
 /**
- * e_cal_view_get_client
+ * e_cal_view_get_client: (skip)
  * @view: A #ECalView object.
  *
  * Get the #ECal associated with this view.
  *
- * Returns: the associated client.
+ * Returns: (transfer none): the associated client.
  *
  * Since: 2.22
  *
diff --git a/calendar/libecal/e-cal.c b/calendar/libecal/e-cal.c
index 3c82039..f011154 100644
--- a/calendar/libecal/e-cal.c
+++ b/calendar/libecal/e-cal.c
@@ -199,7 +199,7 @@ e_calendar_error_quark (void)
 	return q;
 }
 
-/**
+/*
  * If the GError is a remote error, extract the EBookStatus embedded inside.
  * Otherwise return CORBA_EXCEPTION (I know this is DBus...).
  */
@@ -268,7 +268,7 @@ get_status_from_error (const GError *error)
 	}
 }
 
-/**
+/*
  * If the specified GError is a remote error, then create a new error
  * representing the remote error.  If the error is anything else, then leave it
  * alone.
@@ -1071,7 +1071,7 @@ open_calendar (ECal *ecal,
 }
 
 /**
- * e_cal_open
+ * e_cal_open:
  * @ecal: A calendar client.
  * @only_if_exists: FALSE if the calendar should be opened even if there
  * was no storage for it, i.e. to create a new calendar or load an existing
@@ -1269,7 +1269,7 @@ build_uri_list (GNOME_Evolution_Calendar_StringSeq *seq)
 #endif
 
 /**
- * e_cal_uri_list:
+ * e_cal_uri_list: (skip)
  * @ecal: A calendar client.
  * @mode: Mode of the URIs to get.
  *
@@ -1371,7 +1371,7 @@ e_cal_get_load_state (ECal *ecal)
 }
 
 /**
- * e_cal_get_source:
+ * e_cal_get_source: (skip)
  * @ecal: A calendar client.
  *
  * Queries the source that is open in a calendar client.
@@ -1394,7 +1394,7 @@ e_cal_get_source (ECal *ecal)
 }
 
 /**
- * e_cal_get_local_attachment_store
+ * e_cal_get_local_attachment_store:
  * @ecal: A calendar client.
  *
  * Queries the URL where the calendar attachments are
@@ -1752,7 +1752,7 @@ e_cal_get_refresh_supported (ECal *ecal)
 }
 
 /**
- * e_cal_set_mode:
+ * e_cal_set_mode: (skip)
  * @ecal: A calendar client.
  * @mode: Mode to switch to.
  *
@@ -1793,7 +1793,7 @@ struct _ECalGetTimezonesData {
 };
 
 /**
- * e_cal_get_default_object:
+ * e_cal_get_default_object: (skip)
  * @ecal: A calendar client.
  * @icalcomp: Return value for the default object.
  * @error: Placeholder for error information.
@@ -1845,7 +1845,7 @@ e_cal_get_default_object (ECal *ecal,
 }
 
 /**
- * e_cal_get_attachments_for_comp:
+ * e_cal_get_attachments_for_comp: (skip)
  * @ecal: A calendar client.
  * @uid: Unique identifier for a calendar component.
  * @rid: Recurrence identifier.
@@ -1905,7 +1905,7 @@ e_cal_get_attachments_for_comp (ECal *ecal,
 }
 
 /**
- * e_cal_get_object:
+ * e_cal_get_object: (skip)
  * @ecal: A calendar client.
  * @uid: Unique identifier for a calendar component.
  * @rid: Recurrence identifier.
@@ -1995,7 +1995,7 @@ e_cal_get_object (ECal *ecal,
 }
 
 /**
- * e_cal_get_objects_for_uid:
+ * e_cal_get_objects_for_uid: (skip)
  * @ecal: A calendar client.
  * @uid: Unique identifier for a calendar component.
  * @objects: Return value for the list of objects obtained from the backend.
@@ -2094,7 +2094,7 @@ e_cal_get_objects_for_uid (ECal *ecal,
 }
 
 /**
- * e_cal_resolve_tzid_cb:
+ * e_cal_resolve_tzid_cb: (skip)
  * @tzid: ID of the timezone to resolve.
  * @data: Closure data for the callback.
  *
@@ -2124,7 +2124,7 @@ e_cal_resolve_tzid_cb (const gchar *tzid,
 }
 
 /**
- * e_cal_get_changes:
+ * e_cal_get_changes: (skip)
  * @ecal: A calendar client.
  * @change_id: ID to use for comparing changes.
  * @changes: Return value for the list of changes.
@@ -2134,7 +2134,7 @@ e_cal_resolve_tzid_cb (const gchar *tzid,
  * is identified by the @change_id argument, which is used by the backend to
  * compute the changes done.
  *
- * Returns: TRUE if the call was successful, FALSE otherwise.
+ * Returns: %TRUE if the call was successful, %FALSE otherwise.
  *
  * Deprecated: 3.2: This function has been dropped completely.
  */
@@ -2157,10 +2157,10 @@ e_cal_get_changes (ECal *ecal,
 }
 
 /**
- * e_cal_free_change_list:
+ * e_cal_free_change_list: (skip)
  * @list: List of changes to be freed.
  *
- * Free a list of changes as returned by #e_cal_get_changes.
+ * Free a list of changes as returned by e_cal_get_changes().
  *
  * Deprecated: 3.2: Use () instead.
  */
@@ -2245,7 +2245,7 @@ e_cal_get_object_list (ECal *ecal,
 }
 
 /**
- * e_cal_get_object_list_as_comp:
+ * e_cal_get_object_list_as_comp: (skip)
  * @ecal: A calendar client.
  * @query: Query string.
  * @objects: Return value for list of objects.
@@ -2291,7 +2291,7 @@ e_cal_get_object_list_as_comp (ECal *ecal,
 }
 
 /**
- * e_cal_free_object_list:
+ * e_cal_free_object_list: (skip)
  * @objects: List of objects to be freed.
  *
  * Frees a list of objects as returned by #e_cal_get_object_list.
@@ -2310,7 +2310,7 @@ e_cal_free_object_list (GList *objects)
 }
 
 /**
- * e_cal_get_free_busy
+ * e_cal_get_free_busy: (skip)
  * @ecal: A calendar client.
  * @users: List of users to retrieve free/busy information for.
  * @start: Start time for query.
@@ -2769,7 +2769,7 @@ try_again:
 }
 
 /**
- * e_cal_generate_instances:
+ * e_cal_generate_instances: (skip)
  * @ecal: A calendar client.
  * @start: Start time for query.
  * @end: End time for query.
@@ -2808,7 +2808,7 @@ e_cal_generate_instances (ECal *ecal,
 }
 
 /**
- * e_cal_generate_instances_for_object:
+ * e_cal_generate_instances_for_object: (skip)
  * @ecal: A calendar client.
  * @icalcomp: Object to generate instances from.
  * @start: Start time for query.
@@ -2949,7 +2949,7 @@ build_component_alarms_list (ECal *ecal,
 }
 
 /**
- * e_cal_get_alarms_in_range:
+ * e_cal_get_alarms_in_range: (skip)
  * @ecal: A calendar client.
  * @start: Start time for query.
  * @end: End time for query.
@@ -3015,7 +3015,7 @@ e_cal_get_alarms_in_range (ECal *ecal,
 }
 
 /**
- * e_cal_free_alarms:
+ * e_cal_free_alarms: (skip)
  * @comp_alarms: A list of #ECalComponentAlarms structures.
  *
  * Frees a list of #ECalComponentAlarms structures as returned by
@@ -3102,7 +3102,7 @@ e_cal_get_alarms_for_object (ECal *ecal,
 }
 
 /**
- * e_cal_discard_alarm
+ * e_cal_discard_alarm:
  * @ecal: A calendar ecal.
  * @comp: The component to discard the alarm from.
  * @auid: Unique identifier of the alarm to be discarded.
@@ -3297,7 +3297,7 @@ e_cal_get_component_as_string_internal (ECal *ecal,
 }
 
 /**
- * e_cal_get_component_as_string:
+ * e_cal_get_component_as_string: (skip)
  * @ecal: A calendar client.
  * @icalcomp: A calendar component object.
  *
@@ -3317,7 +3317,7 @@ e_cal_get_component_as_string (ECal *ecal,
 }
 
 /**
- * e_cal_create_object:
+ * e_cal_create_object: (skip)
  * @ecal: A calendar client.
  * @icalcomp: The component to create.
  * @uid: Return value for the UID assigned to the new component by the calendar backend.
@@ -3381,7 +3381,7 @@ e_cal_create_object (ECal *ecal,
 }
 
 /**
- * e_cal_modify_object:
+ * e_cal_modify_object: (skip)
  * @ecal: A calendar client.
  * @icalcomp: Component to modify.
  * @mod: Type of modification.
@@ -3445,7 +3445,7 @@ e_cal_modify_object (ECal *ecal,
 }
 
 /**
- * e_cal_remove_object_with_mod:
+ * e_cal_remove_object_with_mod: (skip)
  * @ecal: A calendar client.
  * @uid: UID of the object to remove.
  * @rid: Recurrence ID of the specific recurrence to remove.
@@ -3564,7 +3564,7 @@ e_cal_remove_object (ECal *ecal,
 }
 
 /**
- * e_cal_receive_objects:
+ * e_cal_receive_objects: (skip)
  * @ecal:  A calendar client.
  * @icalcomp: An icalcomponent.
  * @error: Placeholder for error information.
@@ -3610,7 +3610,7 @@ e_cal_receive_objects (ECal *ecal,
 }
 
 /**
- * e_cal_send_objects:
+ * e_cal_send_objects: (skip)
  * @ecal: A calendar client.
  * @icalcomp: An icalcomponent.
  * @users: List of users to send the objects to.
@@ -3688,7 +3688,7 @@ e_cal_send_objects (ECal *ecal,
 }
 
 /**
- * e_cal_get_timezone:
+ * e_cal_get_timezone: (skip)
  * @ecal: A calendar client.
  * @tzid: ID of the timezone to retrieve.
  * @zone: Return value for the timezone.
@@ -3815,7 +3815,7 @@ e_cal_get_timezone (ECal *ecal,
 }
 
 /**
- * e_cal_add_timezone
+ * e_cal_add_timezone: (skip)
  * @ecal: A calendar client.
  * @izone: The timezone to add.
  * @error: Placeholder for error information.
@@ -3939,7 +3939,7 @@ e_cal_get_query (ECal *ecal,
 }
 
 /**
- * e_cal_set_default_timezone:
+ * e_cal_set_default_timezone: (skip)
  * @ecal: A calendar client.
  * @zone: A timezone object.
  * @error: Placeholder for error information.
@@ -3978,7 +3978,7 @@ e_cal_set_default_timezone (ECal *ecal,
 }
 
 /**
- * e_cal_get_error_message
+ * e_cal_get_error_message:
  * @status: A status code.
  *
  * Gets an error message for the given status code.
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]