[libgdata/libgdata-0-6] introspection: Add (element-type) annotations

From: Philip Withnall <pwithnall src gnome org>
To: commits-list gnome org
Cc:
Subject: [libgdata/libgdata-0-6] introspection: Add (element-type) annotations
Date: Wed, 29 Sep 2010 12:18:03 +0000 (UTC)
commit 3edc4ffd8b47de7bfdc4ad158903d1e70b127ffd
Author: Philip Withnall <philip tecnocode co uk>
Date:   Fri Jul 16 10:09:34 2010 +0100

    introspection: Add (element-type) annotations

 gdata/gd/gdata-gd-when.c                         |    2 +-
 gdata/gdata-entry.c                              |    5 +++--
 gdata/gdata-feed.c                               |    8 ++++----
 gdata/media/gdata-media-group.c                  |    4 ++--
 gdata/services/calendar/gdata-calendar-event.c   |    6 +++---
 gdata/services/contacts/gdata-contacts-contact.c |    8 ++++----
 gdata/services/documents/gdata-documents-query.c |    6 ++++--
 gdata/services/picasaweb/gdata-picasaweb-album.c |    4 ++--
 gdata/services/picasaweb/gdata-picasaweb-file.c  |    4 ++--
 gdata/services/youtube/gdata-youtube-video.c     |    2 +-
 10 files changed, 26 insertions(+), 23 deletions(-)
---
diff --git a/gdata/gd/gdata-gd-when.c b/gdata/gd/gdata-gd-when.c
index a3088d2..d38845e 100644
--- a/gdata/gd/gdata-gd-when.c
+++ b/gdata/gd/gdata-gd-when.c
@@ -584,7 +584,7 @@ gdata_gd_when_set_value_string (GDataGDWhen *self, const gchar *value_string)
  *
  * Returns a list of the #GDataGDReminder<!-- -->s which are associated with this #GDataGDWhen.
  *
- * Return value: a #GList of #GDataGDReminder<!-- -->s, or %NULL
+ * Return value: (element-type GData.GDReminder) (transfer none): a #GList of #GDataGDReminder<!-- -->s, or %NULL
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/gdata-entry.c b/gdata/gdata-entry.c
index caff87e..74486d8 100644
--- a/gdata/gdata-entry.c
+++ b/gdata/gdata-entry.c
@@ -702,7 +702,7 @@ gdata_entry_add_category (GDataEntry *self, GDataCategory *category)
  *
  * Gets a list of the #GDataCategory<!-- -->s containing this entry.
  *
- * Return value: a #GList of #GDataCategory<!-- -->s
+ * Return value: (element-type GData.Category) (transfer none): a #GList of #GDataCategory<!-- -->s
  *
  * Since: 0.2.0
  **/
@@ -809,7 +809,8 @@ gdata_entry_look_up_link (GDataEntry *self, const gchar *rel)
  *
  * If you will only use the first link found, consider calling gdata_entry_look_up_link() instead.
  *
- * Return value: a #GList of #GDataLink<!-- -->s, or %NULL if none were found; free the list with g_list_free()
+ * Return value: (element-type GData.Link) (transfer container): a #GList of #GDataLink<!-- -->s, or %NULL if none were found; free the list with
+ * g_list_free()
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/gdata-feed.c b/gdata/gdata-feed.c
index 4db5430..1697e5d 100644
--- a/gdata/gdata-feed.c
+++ b/gdata/gdata-feed.c
@@ -605,7 +605,7 @@ _gdata_feed_new_from_xml (GType feed_type, const gchar *xml, gint length, GType
  *
  * Returns a list of the entries contained in this feed.
  *
- * Return value: a #GList of #GDataEntry<!-- -->s
+ * Return value: (element-type GData.Entry) (transfer none): a #GList of #GDataEntry<!-- -->s
  **/
 GList *
 gdata_feed_get_entries (GDataFeed *self)
@@ -651,7 +651,7 @@ gdata_feed_look_up_entry (GDataFeed *self, const gchar *id)
  *
  * Returns a list of the categories listed in this feed.
  *
- * Return value: a #GList of #GDataCategory<!-- -->s
+ * Return value: (element-type GData.Category) (transfer none): a #GList of #GDataCategory<!-- -->s
  **/
 GList *
 gdata_feed_get_categories (GDataFeed *self)
@@ -666,7 +666,7 @@ gdata_feed_get_categories (GDataFeed *self)
  *
  * Returns a list of the links listed in this feed.
  *
- * Return value: a #GList of #GDataLink<!-- -->s
+ * Return value: (element-type GData.Link) (transfer none): a #GList of #GDataLink<!-- -->s
  **/
 GList *
 gdata_feed_get_links (GDataFeed *self)
@@ -712,7 +712,7 @@ gdata_feed_look_up_link (GDataFeed *self, const gchar *rel)
  *
  * Returns a list of the authors listed in this feed.
  *
- * Return value: a #GList of #GDataAuthor<!-- -->s
+ * Return value: (element-type GData.Author) (transfer none): a #GList of #GDataAuthor<!-- -->s
  **/
 GList *
 gdata_feed_get_authors (GDataFeed *self)
diff --git a/gdata/media/gdata-media-group.c b/gdata/media/gdata-media-group.c
index 2778584..3ca2dc3 100644
--- a/gdata/media/gdata-media-group.c
+++ b/gdata/media/gdata-media-group.c
@@ -455,7 +455,7 @@ gdata_media_group_look_up_content (GDataMediaGroup *self, const gchar *type)
  *
  * Returns a list of #GDataMediaContent<!-- -->s, giving the content enclosed by the group.
  *
- * Return value: a #GList of #GDataMediaContent<!-- -->s,  or %NULL
+ * Return value: (element-type GData.MediaContent) (transfer none): a #GList of #GDataMediaContent<!-- -->s,  or %NULL
  **/
 GList *
 gdata_media_group_get_contents (GDataMediaGroup *self)
@@ -534,7 +534,7 @@ gdata_media_group_is_restricted_in_country (GDataMediaGroup *self, const gchar *
  *
  * Gets a list of the thumbnails available for the group.
  *
- * Return value: a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
+ * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
  **/
 GList *
 gdata_media_group_get_thumbnails (GDataMediaGroup *self)
diff --git a/gdata/services/calendar/gdata-calendar-event.c b/gdata/services/calendar/gdata-calendar-event.c
index 725f3e4..479997c 100644
--- a/gdata/services/calendar/gdata-calendar-event.c
+++ b/gdata/services/calendar/gdata-calendar-event.c
@@ -1007,7 +1007,7 @@ gdata_calendar_event_add_person (GDataCalendarEvent *self, GDataGDWho *who)
  *
  * Gets a list of the people attending the event.
  *
- * Return value: a #GList of #GDataGDWho<!-- -->s, or %NULL
+ * Return value: (element-type GData.GDWho) (transfer none): a #GList of #GDataGDWho<!-- -->s, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -1043,7 +1043,7 @@ gdata_calendar_event_add_place (GDataCalendarEvent *self, GDataGDWhere *where)
  *
  * Gets a list of the locations associated with the event.
  *
- * Return value: a #GList of #GDataGDWhere<!-- -->s, or %NULL
+ * Return value: (element-type GData.GDWhere) (transfer none): a #GList of #GDataGDWhere<!-- -->s, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -1081,7 +1081,7 @@ gdata_calendar_event_add_time (GDataCalendarEvent *self, GDataGDWhen *when)
  *
  * Gets a list of the time periods associated with the event.
  *
- * Return value: a #GList of #GDataGDWhen<!-- -->s, or %NULL
+ * Return value: (element-type GData.GDWhen) (transfer none): a #GList of #GDataGDWhen<!-- -->s, or %NULL
  *
  * Since: 0.2.0
  **/
diff --git a/gdata/services/contacts/gdata-contacts-contact.c b/gdata/services/contacts/gdata-contacts-contact.c
index 4467c01..f3fa295 100644
--- a/gdata/services/contacts/gdata-contacts-contact.c
+++ b/gdata/services/contacts/gdata-contacts-contact.c
@@ -672,7 +672,7 @@ gdata_contacts_contact_add_im_address (GDataContactsContact *self, GDataGDIMAddr
  *
  * Gets a list of the IM addresses owned by the contact.
  *
- * Return value: a #GList of #GDataGDIMAddress<!-- -->es, or %NULL
+ * Return value: (element-type GData.GDIMAddress) (transfer none): a #GList of #GDataGDIMAddress<!-- -->es, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -761,7 +761,7 @@ gdata_contacts_contact_add_phone_number (GDataContactsContact *self, GDataGDPhon
  *
  * Gets a list of the phone numbers owned by the contact.
  *
- * Return value: a #GList of #GDataGDPhoneNumber<!-- -->s, or %NULL
+ * Return value: (element-type GData.GDPhoneNumber) (transfer none): a #GList of #GDataGDPhoneNumber<!-- -->s, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -850,7 +850,7 @@ gdata_contacts_contact_add_postal_address (GDataContactsContact *self, GDataGDPo
  *
  * Gets a list of the postal addresses owned by the contact.
  *
- * Return value: a #GList of #GDataGDPostalAddress<!-- -->es, or %NULL
+ * Return value: (element-type GData.GDPostalAddress) (transfer none): a #GList of #GDataGDPostalAddress<!-- -->es, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -1146,7 +1146,7 @@ get_groups_cb (const gchar *href, gpointer deleted, GList **groups)
  *
  * Gets a list of the groups to which the contact belongs.
  *
- * Return value: a #GList of constant group ID URIs, or %NULL; free with g_list_free()
+ * Return value: (element-type utf8) (transfer container): a #GList of constant group ID URIs, or %NULL; free with g_list_free()
  *
  * Since: 0.2.0
  **/
diff --git a/gdata/services/documents/gdata-documents-query.c b/gdata/services/documents/gdata-documents-query.c
index 9df9e3f..338ba21 100644
--- a/gdata/services/documents/gdata-documents-query.c
+++ b/gdata/services/documents/gdata-documents-query.c
@@ -517,7 +517,8 @@ gdata_documents_query_set_title (GDataDocumentsQuery *self, const gchar *title,
  *
  * Gets a list of #GDataGDEmailAddress<!-- -->es of the document collaborators whose documents will be queried.
  *
- * Return value: a list of #GDataGDEmailAddress<!-- -->es of the collaborators concerned by the query, or %NULL
+ * Return value: (element-type GData.GDEmailAddress) (transfer none): a list of #GDataGDEmailAddress<!-- -->es of the collaborators concerned by the
+ * query, or %NULL
  *
  * Since: 0.4.0
  **/
@@ -534,7 +535,8 @@ gdata_documents_query_get_collaborator_addresses (GDataDocumentsQuery *self)
  *
  * Gets a list of #GDataGDEmailAddress<!-- -->es of the document readers whose documents will be queried.
  *
- * Return value: a list of #GDataGDEmailAddress<!-- -->es of the readers concerned by the query, or %NULL
+ * Return value: (element-type GData.GDEmailAddress) (transfer none): a list of #GDataGDEmailAddress<!-- -->es of the readers concerned by the query,
+ * or %NULL
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/picasaweb/gdata-picasaweb-album.c b/gdata/services/picasaweb/gdata-picasaweb-album.c
index 3072f39..70b2f7b 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-album.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-album.c
@@ -1159,7 +1159,7 @@ gdata_picasaweb_album_set_tags (GDataPicasaWebAlbum *self, const gchar *tags)
  *
  * Returns a list of media content, such as the cover image for the album.
  *
- * Return value: a #GList of #GDataMediaContent items
+ * Return value: (element-type GData.MediaContent) (transfer none): a #GList of #GDataMediaContent items
  *
  * Since: 0.4.0
  **/
@@ -1176,7 +1176,7 @@ gdata_picasaweb_album_get_contents (GDataPicasaWebAlbum *self)
  *
  * Returns a list of thumbnails, often at different sizes, for this album.
  *
- * Return value: a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
+ * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/picasaweb/gdata-picasaweb-file.c b/gdata/services/picasaweb/gdata-picasaweb-file.c
index 4528be8..9c7a520 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-file.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-file.c
@@ -1578,7 +1578,7 @@ gdata_picasaweb_file_set_caption (GDataPicasaWebFile *self, const gchar *caption
  *
  * Returns a list of media content, e.g. the actual photo or video.
  *
- * Return value: a #GList of #GDataMediaContent items
+ * Return value: (element-type GData.MediaContent) (transfer none): a #GList of #GDataMediaContent items
  *
  * Since: 0.4.0
  **/
@@ -1599,7 +1599,7 @@ gdata_picasaweb_file_get_contents (GDataPicasaWebFile *self)
  * not be larger than the actual image, so thumbnails may be smaller
  * than the widths listed above.
  *
- * Return value: a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
+ * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
  *
  * Since: 0.4.0
  **/
diff --git a/gdata/services/youtube/gdata-youtube-video.c b/gdata/services/youtube/gdata-youtube-video.c
index e98c5b8..f94e3f0 100644
--- a/gdata/services/youtube/gdata-youtube-video.c
+++ b/gdata/services/youtube/gdata-youtube-video.c
@@ -1145,7 +1145,7 @@ gdata_youtube_video_look_up_content (GDataYouTubeVideo *self, const gchar *type)
  *
  * Gets a list of the thumbnails available for the video.
  *
- * Return value: a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
+ * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL
  **/
 GList *
 gdata_youtube_video_get_thumbnails (GDataYouTubeVideo *self)
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]