GNOME.org
 

[libgdata/libgdata-0-6] introspection: Add missing (transfer full) annotations

commit fef70a6351aa8197ff553588cac9339481f7b21f
Author: Philip Withnall <philip tecnocode co uk>
Date:   Wed Sep 29 15:23:07 2010 +0100

    introspection: Add missing (transfer full) annotations

 gdata/gdata-access-handler.c                       |    6 +++---
 gdata/gdata-service.c                              |   12 ++++++------
 gdata/media/gdata-media-content.c                  |    2 +-
 gdata/media/gdata-media-thumbnail.c                |    2 +-
 gdata/services/calendar/gdata-calendar-service.c   |    8 ++++----
 gdata/services/contacts/gdata-contacts-contact.c   |   12 ++++++------
 gdata/services/contacts/gdata-contacts-service.c   |    6 +++---
 .../documents/gdata-documents-presentation.c       |    2 +-
 gdata/services/documents/gdata-documents-service.c |   12 ++++++------
 .../documents/gdata-documents-spreadsheet.c        |    2 +-
 gdata/services/documents/gdata-documents-text.c    |    2 +-
 gdata/services/picasaweb/gdata-picasaweb-service.c |   14 +++++++-------
 gdata/services/youtube/gdata-youtube-service.c     |   12 ++++++------
 13 files changed, 46 insertions(+), 46 deletions(-)
---
diff --git a/gdata/gdata-access-handler.c b/gdata/gdata-access-handler.c
index a9773b5..d7c206c 100644
--- a/gdata/gdata-access-handler.c
+++ b/gdata/gdata-access-handler.c
@@ -76,7 +76,7 @@ gdata_access_handler_get_type (void)
  * For each rule in the response feed, @progress_callback will be called in the main thread. If there was an error parsing the XML response,
  * a #GDataParserError will be returned.
  *
- * Return value: a #GDataFeed of access control rules, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of access control rules, or %NULL; unref with g_object_unref()
  *
  * Since: 0.3.0
  **/
@@ -155,7 +155,7 @@ gdata_access_handler_get_rules (GDataAccessHandler *self, GDataService *service,
  *
  * If there is an error inserting the rule, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.
  *
- * Return value: an updated #GDataAccessRule, or %NULL
+ * Return value: (transfer full): an updated #GDataAccessRule, or %NULL; unref with g_object_unref()
  *
  * Since: 0.3.0
  **/
@@ -277,7 +277,7 @@ get_soup_message (GDataAccessHandler *access_handler, GDataAccessRule *rule, con
  *
  * If there is an error updating the rule, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.
  *
- * Return value: an updated #GDataAccessRule, or %NULL
+ * Return value: (transfer full): an updated #GDataAccessRule, or %NULL; unref with g_object_unref()
  *
  * Since: 0.3.0
  **/
diff --git a/gdata/gdata-service.c b/gdata/gdata-service.c
index 4dfbd95..3e85775 100644
--- a/gdata/gdata-service.c
+++ b/gdata/gdata-service.c
@@ -956,7 +956,7 @@ gdata_service_query_async (GDataService *self, const gchar *feed_uri, GDataQuery
  *
  * Finishes an asynchronous query operation started with gdata_service_query_async().
  *
- * Return value: a #GDataFeed of query results, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results, or %NULL; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_service_query_finish (GDataService *self, GAsyncResult *async_result, GError **error)
@@ -1058,7 +1058,7 @@ _gdata_service_query (GDataService *self, const gchar *feed_uri, GDataQuery *que
  * If the #GDataQuery's ETag is set and it finds a match on the server, %NULL will be returned, but @error will remain unset. Otherwise,
  * @query's ETag will be updated with the ETag from the returned feed, if available.
  *
- * Return value: a #GDataFeed of query results, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results, or %NULL; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_service_query (GDataService *self, const gchar *feed_uri, GDataQuery *query, GType entry_type,
@@ -1194,7 +1194,7 @@ gdata_service_insert_entry_async (GDataService *self, const gchar *upload_uri, G
  *
  * Finishes an asynchronous entry insertion operation started with gdata_service_insert_entry_async().
  *
- * Return value: an updated #GDataEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.3.0
  **/
@@ -1242,7 +1242,7 @@ gdata_service_insert_entry_finish (GDataService *self, GAsyncResult *async_resul
  * If there is an error inserting the entry, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned. Currently, subclasses
  * <emphasis>cannot</emphasis> cannot override this or provide more specific errors.
  *
- * Return value: an updated #GDataEntry, or %NULL
+ * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref()
  **/
 GDataEntry *
 gdata_service_insert_entry (GDataService *self, const gchar *upload_uri, GDataEntry *entry, GCancellable *cancellable, GError **error)
@@ -1372,7 +1372,7 @@ gdata_service_update_entry_async (GDataService *self, GDataEntry *entry, GCancel
  *
  * Finishes an asynchronous entry update operation started with gdata_service_update_entry_async().
  *
- * Return value: an updated #GDataEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.3.0
  **/
@@ -1416,7 +1416,7 @@ gdata_service_update_entry_finish (GDataService *self, GAsyncResult *async_resul
  * If there is an error updating the entry, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned. Currently, subclasses
  * <emphasis>cannot</emphasis> cannot override this or provide more specific errors.
  *
- * Return value: an updated #GDataEntry, or %NULL
+ * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.2.0
  **/
diff --git a/gdata/media/gdata-media-content.c b/gdata/media/gdata-media-content.c
index dc0f6ef..38cb6b3 100644
--- a/gdata/media/gdata-media-content.c
+++ b/gdata/media/gdata-media-content.c
@@ -560,7 +560,7 @@ gdata_media_content_get_width (GDataMediaContent *self)
  * downloaded into this directory with the default filename specified
  * in @default_filename.
  *
- * Return value: the content's data, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): the content's data, or %NULL; unref with g_object_unref()
  *
  * Since: 0.6.0
  **/
diff --git a/gdata/media/gdata-media-thumbnail.c b/gdata/media/gdata-media-thumbnail.c
index 7f2c6a5..96b9b96 100644
--- a/gdata/media/gdata-media-thumbnail.c
+++ b/gdata/media/gdata-media-thumbnail.c
@@ -378,7 +378,7 @@ gdata_media_thumbnail_get_time (GDataMediaThumbnail *self)
  * downloaded into this directory with the default filename specified
  * in @default_filename.
  *
- * Return value: the thumbnail's data, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): the thumbnail's data, or %NULL; unref with g_object_unref()
  *
  * Since: 0.6.0
  **/
diff --git a/gdata/services/calendar/gdata-calendar-service.c b/gdata/services/calendar/gdata-calendar-service.c
index e7a85fe..19f2b1e 100644
--- a/gdata/services/calendar/gdata-calendar-service.c
+++ b/gdata/services/calendar/gdata-calendar-service.c
@@ -94,7 +94,7 @@ gdata_calendar_service_new (const gchar *client_id)
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_calendar_service_query_all_calendars (GDataCalendarService *self, GDataQuery *query, GCancellable *cancellable,
@@ -171,7 +171,7 @@ gdata_calendar_service_query_all_calendars_async (GDataCalendarService *self, GD
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_calendar_service_query_own_calendars (GDataCalendarService *self, GDataQuery *query, GCancellable *cancellable,
@@ -247,7 +247,7 @@ gdata_calendar_service_query_own_calendars_async (GDataCalendarService *self, GD
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_calendar_service_query_events (GDataCalendarService *self, GDataCalendarCalendar *calendar, GDataQuery *query, GCancellable *cancellable,
@@ -288,7 +288,7 @@ gdata_calendar_service_query_events (GDataCalendarService *self, GDataCalendarCa
  *
  * For more details, see gdata_service_insert_entry().
  *
- * Return value: an updated #GDataCalendarEvent, or %NULL
+ * Return value: (transfer full): an updated #GDataCalendarEvent, or %NULL; unref with g_object_unref()
  *
  * Since: 0.2.0
  **/
diff --git a/gdata/services/contacts/gdata-contacts-contact.c b/gdata/services/contacts/gdata-contacts-contact.c
index 1009792..08a1fee 100644
--- a/gdata/services/contacts/gdata-contacts-contact.c
+++ b/gdata/services/contacts/gdata-contacts-contact.c
@@ -591,7 +591,7 @@ gdata_contacts_contact_add_email_address (GDataContactsContact *self, GDataGDEma
  *
  * Gets a list of the e-mail addresses owned by the contact.
  *
- * Return value: a #GList of #GDataGDEmailAddress<!-- -->es, or %NULL
+ * Return value: (element-type GData.GDEmailAddress) (transfer none): a #GList of #GDataGDEmailAddress<!-- -->es, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -608,7 +608,7 @@ gdata_contacts_contact_get_email_addresses (GDataContactsContact *self)
  *
  * Gets the contact's primary e-mail address, if one exists.
  *
- * Return value: a #GDataGDEmailAddress, or %NULL
+ * Return value: (transfer none): a #GDataGDEmailAddress, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -697,7 +697,7 @@ gdata_contacts_contact_get_im_addresses (GDataContactsContact *self)
  *
  * Gets the contact's primary IM address, if one exists.
  *
- * Return value: a #GDataGDIMAddress, or %NULL
+ * Return value: (transfer none): a #GDataGDIMAddress, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -875,7 +875,7 @@ gdata_contacts_contact_get_postal_addresses (GDataContactsContact *self)
  *
  * Gets the contact's primary postal address, if one exists.
  *
- * Return value: a #GDataGDPostalAddress, or %NULL
+ * Return value: (transfer none): a #GDataGDPostalAddress, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -947,7 +947,7 @@ gdata_contacts_contact_add_organization (GDataContactsContact *self, GDataGDOrga
  *
  * Gets a list of the organizations to which the contact belongs.
  *
- * Return value: a #GList of #GDataGDOrganization<!-- -->s, or %NULL
+ * Return value: (element-type GData.GDOrganization) (transfer none): a #GList of #GDataGDOrganization<!-- -->s, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -964,7 +964,7 @@ gdata_contacts_contact_get_organizations (GDataContactsContact *self)
  *
  * Gets the contact's primary organization, if one exists.
  *
- * Return value: a #GDataGDOrganization, or %NULL
+ * Return value: (transfer none): a #GDataGDOrganization, or %NULL
  *
  * Since: 0.2.0
  **/
diff --git a/gdata/services/contacts/gdata-contacts-service.c b/gdata/services/contacts/gdata-contacts-service.c
index 65fddb2..44dc717 100644
--- a/gdata/services/contacts/gdata-contacts-service.c
+++ b/gdata/services/contacts/gdata-contacts-service.c
@@ -93,7 +93,7 @@ gdata_contacts_service_new (const gchar *client_id)
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  *
  * Since: 0.2.0
  **/
@@ -169,7 +169,7 @@ gdata_contacts_service_query_contacts_async (GDataContactsService *self, GDataQu
  *
  * For more details, see gdata_service_insert_entry().
  *
- * Return value: an updated #GDataContactsContact, or %NULL
+ * Return value: (transfer full): an updated #GDataContactsContact, or %NULL; unref with g_object_unref()
  *
  * Since: 0.2.0
  **/
@@ -203,7 +203,7 @@ gdata_contacts_service_insert_contact (GDataContactsService *self, GDataContacts
  *
  * For more details, see gdata_service_update_entry().
  *
- * Return value: an updated #GDataContactsContact, or %NULL
+ * Return value: (transfer full): an updated #GDataContactsContact, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/documents/gdata-documents-presentation.c b/gdata/services/documents/gdata-documents-presentation.c
index f4bfae8..d96d895 100644
--- a/gdata/services/documents/gdata-documents-presentation.c
+++ b/gdata/services/documents/gdata-documents-presentation.c
@@ -121,7 +121,7 @@ gdata_documents_presentation_new (const gchar *id)
  * If @destination_file is a directory, then the file will be downloaded in this directory with the #GDataEntry:title with 
  * the apropriate extension as name.
  *
- * Return value: the document's data, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): the document's data, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/documents/gdata-documents-service.c b/gdata/services/documents/gdata-documents-service.c
index 36d74c3..f2673fb 100644
--- a/gdata/services/documents/gdata-documents-service.c
+++ b/gdata/services/documents/gdata-documents-service.c
@@ -176,7 +176,7 @@ gdata_documents_service_get_property (GObject *object, guint property_id, GValue
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataDocumentsFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataDocumentsFeed of query results; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -225,7 +225,7 @@ gdata_documents_service_query_documents (GDataDocumentsService *self, GDataDocum
  *
  * Parameters and errors are as for gdata_service_query().
  *
- * Return value: a #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.5.0
  **/
@@ -463,7 +463,7 @@ upload_update_document (GDataDocumentsService *self, GDataDocumentsEntry *docume
  * If there is a problem reading @document_file, an error from g_file_load_contents() or g_file_query_info() will be returned. Other errors from
  * #GDataServiceError can be returned for other exceptional conditions, as determined by the server.
  *
- * Return value: an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -522,7 +522,7 @@ gdata_documents_service_upload_document (GDataDocumentsService *self, GDataDocum
  *
  * For more details, see gdata_service_insert_entry().
  *
- * Return value: an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -565,7 +565,7 @@ gdata_documents_service_update_document (GDataDocumentsService *self, GDataDocum
  *
  * Errors from #GDataServiceError can be returned for other exceptional conditions, as determined by the server.
  *
- * Return value: an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -662,7 +662,7 @@ gdata_documents_service_move_document_to_folder (GDataDocumentsService *self, GD
  *
  * Errors from #GDataServiceError can be returned for other exceptional conditions, as determined by the server.
  *
- * Return value: an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/documents/gdata-documents-spreadsheet.c b/gdata/services/documents/gdata-documents-spreadsheet.c
index 421637d..949be74 100644
--- a/gdata/services/documents/gdata-documents-spreadsheet.c
+++ b/gdata/services/documents/gdata-documents-spreadsheet.c
@@ -126,7 +126,7 @@ gdata_documents_spreadsheet_new (const gchar *id)
  *
  * If there is an error getting the document, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.
  *
- * Return value: the document's data, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): the document's data, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/documents/gdata-documents-text.c b/gdata/services/documents/gdata-documents-text.c
index edda605..dcd9362 100644
--- a/gdata/services/documents/gdata-documents-text.c
+++ b/gdata/services/documents/gdata-documents-text.c
@@ -123,7 +123,7 @@ gdata_documents_text_new (const gchar *id)
  *
  * If there is an error getting the document, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.
  *
- * Return value: the document's data, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): the document's data, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.c b/gdata/services/picasaweb/gdata-picasaweb-service.c
index 4ebcadb..f48913f 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-service.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-service.c
@@ -109,7 +109,7 @@ gdata_picasaweb_service_new (const gchar *client_id)
 }
 
 /**
- * gdata_picasaweb_service_get_user
+ * gdata_picasaweb_service_get_user:
  * @self: a #GDataPicasaWebService
  * @username: (allow-none): the username of the user whose information you wish to retrieve, or %NULL for the currently authenticated user.
  * @cancellable: optional #GCancellable object, or %NULL
@@ -117,7 +117,7 @@ gdata_picasaweb_service_new (const gchar *client_id)
  *
  * Queries the service to return the user specified by @username.
  *
- * Return value: a #GDataPicasaWebUser; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataPicasaWebUser; unref with g_object_unref()
  *
  * Since: 0.6.0
  **/
@@ -168,7 +168,7 @@ gdata_picasaweb_service_get_user (GDataPicasaWebService *self, const gchar *user
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -272,7 +272,7 @@ gdata_picasaweb_service_query_all_albums_async (GDataPicasaWebService *self, GDa
  *
  * For more details, see gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -371,7 +371,7 @@ parse_spliced_stream (GOutputStream *output_stream, GError **error)
  * If there is a problem reading @file_data, an error from g_output_stream_splice() or g_file_query_info() will be returned. Other errors from
  * #GDataServiceError can be returned for other exceptional conditions, as determined by the server.
  *
- * Return value: the inserted #GDataPicasaWebFile with updated properties from @file_entry; unref with g_object_unref()
+ * Return value: (transfer full): the inserted #GDataPicasaWebFile with updated properties from @file_entry; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -450,7 +450,7 @@ gdata_picasaweb_service_upload_file (GDataPicasaWebService *self, GDataPicasaWeb
  * no user is authenticated with the service when trying to upload it,
  * %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be set.
  *
- * Return value: the inserted #GDataPicasaWebFile; unref with
+ * Return value: (transfer full): the inserted #GDataPicasaWebFile; unref with
  * g_object_unref()
  *
  * Since: 0.6.0
@@ -601,7 +601,7 @@ gdata_picasaweb_service_upload_file_async (GDataPicasaWebService *self, GDataPic
  * Inserts a new album described by @album. A user must be
  * authenticated to use this function.
  *
- * Return value: the inserted #GDataPicasaWebAlbum; unref with
+ * Return value: (transfer full): the inserted #GDataPicasaWebAlbum; unref with
  * g_object_unref()
  *
  * Since: 0.6.0
diff --git a/gdata/services/youtube/gdata-youtube-service.c b/gdata/services/youtube/gdata-youtube-service.c
index 02c5f9d..e763977 100644
--- a/gdata/services/youtube/gdata-youtube-service.c
+++ b/gdata/services/youtube/gdata-youtube-service.c
@@ -420,7 +420,7 @@ standard_feed_type_to_feed_uri (GDataYouTubeStandardFeedType feed_type)
  *
  * Parameters and errors are as for gdata_service_query().
  *
- * Return value: a #GDataFeed of query results, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results, or %NULL; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_youtube_service_query_standard_feed (GDataYouTubeService *self, GDataYouTubeStandardFeedType feed_type, GDataQuery *query,
@@ -474,7 +474,7 @@ gdata_youtube_service_query_standard_feed_async (GDataYouTubeService *self, GDat
  *
  * Parameters and errors are as for gdata_service_query().
  *
- * Return value: a #GDataFeed of query results, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results, or %NULL; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_youtube_service_query_videos (GDataYouTubeService *self, GDataQuery *query,
@@ -525,7 +525,7 @@ gdata_youtube_service_query_videos_async (GDataYouTubeService *self, GDataQuery
  *
  * Parameters and errors are as for gdata_service_query().
  *
- * Return value: a #GDataYouTubeVideo, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataYouTubeVideo, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -646,7 +646,7 @@ gdata_youtube_service_query_single_video_async (GDataYouTubeService *self, GData
  *
  * Finishes an asynchronous query operation for a single video, as started with gdata_youtube_service_query_single_video_async().
  *
- * Return value: a #GDataYouTubeVideo, or %NULL; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataYouTubeVideo, or %NULL; unref with g_object_unref()
  *
  * Since: 0.4.0
  **/
@@ -686,7 +686,7 @@ gdata_youtube_service_query_single_video_finish (GDataYouTubeService *self, GAsy
  * If @video does not have a link with rel value <literal>http://gdata.youtube.com/schemas/2007#video.related</literal>, a
  * %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be thrown. Parameters and other errors are as for gdata_service_query().
  *
- * Return value: a #GDataFeed of query results; unref with g_object_unref()
+ * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref()
  **/
 GDataFeed *
 gdata_youtube_service_query_related (GDataYouTubeService *self, GDataYouTubeVideo *video, GDataQuery *query,
@@ -765,7 +765,7 @@ gdata_youtube_service_query_related_async (GDataYouTubeService *self, GDataYouTu
  * If there is a problem reading @video_file, an error from g_file_load_contents() or g_file_query_info() will be returned. Other errors from
  * #GDataServiceError can be returned for other exceptional conditions, as determined by the server.
  *
- * Return value: the inserted #GDataYouTubeVideo with updated properties from @video; unref with g_object_unref()
+ * Return value: (transfer full): the inserted #GDataYouTubeVideo with updated properties from @video; unref with g_object_unref()
  **/
 GDataYouTubeVideo *
 gdata_youtube_service_upload_video (GDataYouTubeService *self, GDataYouTubeVideo *video, GFile *video_file, GCancellable *cancellable, GError **error)
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]