[libgdata/libgdata-0-6] introspection: Add (out) annotations to GTimeVal parameters

From: Philip Withnall <pwithnall src gnome org>
To: commits-list gnome org
Cc:
Subject: [libgdata/libgdata-0-6] introspection: Add (out) annotations to GTimeVal parameters
Date: Wed, 29 Sep 2010 12:18:23 +0000 (UTC)
commit da9ca2f42a86429376f9cc8a2270728ace236fb1
Author: Philip Withnall <philip tecnocode co uk>
Date:   Mon Aug 2 22:29:50 2010 +0100

    introspection: Add (out) annotations to GTimeVal parameters

 gdata/exif/gdata-exif-tags.c                      |    2 +-
 gdata/gd/gdata-gd-reminder.c                      |    2 +-
 gdata/gd/gdata-gd-when.c                          |    4 ++--
 gdata/gdata-entry.c                               |    4 ++--
 gdata/gdata-feed.c                                |    2 +-
 gdata/gdata-query.c                               |    8 ++++----
 gdata/services/calendar/gdata-calendar-calendar.c |    2 +-
 gdata/services/calendar/gdata-calendar-event.c    |    6 +++---
 gdata/services/calendar/gdata-calendar-query.c    |    8 ++++----
 gdata/services/contacts/gdata-contacts-contact.c  |    2 +-
 gdata/services/documents/gdata-documents-entry.c  |    4 ++--
 gdata/services/picasaweb/gdata-picasaweb-album.c  |    4 ++--
 gdata/services/picasaweb/gdata-picasaweb-file.c   |    4 ++--
 gdata/services/youtube/gdata-youtube-group.c      |    2 +-
 gdata/services/youtube/gdata-youtube-video.c      |    4 ++--
 15 files changed, 29 insertions(+), 29 deletions(-)
---
diff --git a/gdata/exif/gdata-exif-tags.c b/gdata/exif/gdata-exif-tags.c
index d4b7758..e0578bc 100644
--- a/gdata/exif/gdata-exif-tags.c
+++ b/gdata/exif/gdata-exif-tags.c
@@ -336,7 +336,7 @@ gdata_exif_tags_get_model (GDataExifTags *self)
 /**
  * gdata_exif_tags_get_time:
  * @self: a #GDataExifTags
- * @_time: a #GTimeVal
+ * @_time: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataExifTags:time property and puts it in @_time. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/gd/gdata-gd-reminder.c b/gdata/gd/gdata-gd-reminder.c
index bf01da1..fb61f9b 100644
--- a/gdata/gd/gdata-gd-reminder.c
+++ b/gdata/gd/gdata-gd-reminder.c
@@ -388,7 +388,7 @@ gdata_gd_reminder_set_method (GDataGDReminder *self, const gchar *method)
 /**
  * gdata_gd_reminder_get_absolute_time:
  * @self: a #GDataGDReminder
- * @absolute_time: return location for the absolute time
+ * @absolute_time: (out caller-allocates): return location for the absolute time
  *
  * Gets the #GDataGDReminder:absolute-time property and returns it in @absolute_time. If the
  * property is unset, both fields of @start_time are set to <code class="literal">0</code>.
diff --git a/gdata/gd/gdata-gd-when.c b/gdata/gd/gdata-gd-when.c
index d38845e..8aa543b 100644
--- a/gdata/gd/gdata-gd-when.c
+++ b/gdata/gd/gdata-gd-when.c
@@ -429,7 +429,7 @@ gdata_gd_when_compare (const GDataGDWhen *a, const GDataGDWhen *b)
 /**
  * gdata_gd_when_get_start_time:
  * @self: a #GDataGDWhen
- * @start_time: return location for the start time
+ * @start_time: (out caller-allocates): return location for the start time
  *
  * Gets the #GDataGDWhen:start-time property and returns it in @start_time.
  *
@@ -465,7 +465,7 @@ gdata_gd_when_set_start_time (GDataGDWhen *self, GTimeVal *start_time)
 /**
  * gdata_gd_when_get_end_time:
  * @self: a #GDataGDWhen
- * @end_time: return location for the end time
+ * @end_time: (out caller-allocates): return location for the end time
  *
  * Gets the #GDataGDWhen:end-time property and returns it in @end_time.
  *
diff --git a/gdata/gdata-entry.c b/gdata/gdata-entry.c
index 74486d8..1d2873e 100644
--- a/gdata/gdata-entry.c
+++ b/gdata/gdata-entry.c
@@ -650,7 +650,7 @@ gdata_entry_get_etag (GDataEntry *self)
 /**
  * gdata_entry_get_updated:
  * @self: a #GDataEntry
- * @updated: a #GTimeVal
+ * @updated: (out caller-allocates): a #GTimeVal
  *
  * Puts the time the entry was last updated into @updated.
  **/
@@ -665,7 +665,7 @@ gdata_entry_get_updated (GDataEntry *self, GTimeVal *updated)
 /**
  * gdata_entry_get_published:
  * @self: a #GDataEntry
- * @published: a #GTimeVal
+ * @published: (out caller-allocates): a #GTimeVal
  *
  * Puts the time the entry was originally published into @published.
  **/
diff --git a/gdata/gdata-feed.c b/gdata/gdata-feed.c
index 1697e5d..0bb4bfa 100644
--- a/gdata/gdata-feed.c
+++ b/gdata/gdata-feed.c
@@ -786,7 +786,7 @@ gdata_feed_get_etag (GDataFeed *self)
 /**
  * gdata_feed_get_updated:
  * @self: a #GDataFeed
- * @updated: a #GTimeVal
+ * @updated: (out caller-allocates): a #GTimeVal
  *
  * Puts the time the feed was last updated into @updated.
  **/
diff --git a/gdata/gdata-query.c b/gdata/gdata-query.c
index 72aaa07..7c7de9f 100644
--- a/gdata/gdata-query.c
+++ b/gdata/gdata-query.c
@@ -740,7 +740,7 @@ gdata_query_set_author (GDataQuery *self, const gchar *author)
 /**
  * gdata_query_get_updated_min:
  * @self: a #GDataQuery
- * @updated_min: a #GTimeVal
+ * @updated_min: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataQuery:updated-min property and puts it in @updated_min. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -785,7 +785,7 @@ gdata_query_set_updated_min (GDataQuery *self, GTimeVal *updated_min)
 /**
  * gdata_query_get_updated_max:
  * @self: a #GDataQuery
- * @updated_max: a #GTimeVal
+ * @updated_max: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataQuery:updated-max property and puts it in @updated_max. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -830,7 +830,7 @@ gdata_query_set_updated_max (GDataQuery *self, GTimeVal *updated_max)
 /**
  * gdata_query_get_published_min:
  * @self: a #GDataQuery
- * @published_min: a #GTimeVal
+ * @published_min: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataQuery:published-min property and puts it in @published_min. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -875,7 +875,7 @@ gdata_query_set_published_min (GDataQuery *self, GTimeVal *published_min)
 /**
  * gdata_query_get_published_max:
  * @self: a #GDataQuery
- * @published_max: a #GTimeVal
+ * @published_max: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataQuery:published-max property and puts it in @published_max. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/calendar/gdata-calendar-calendar.c b/gdata/services/calendar/gdata-calendar-calendar.c
index d1037a3..5ebd99a 100644
--- a/gdata/services/calendar/gdata-calendar-calendar.c
+++ b/gdata/services/calendar/gdata-calendar-calendar.c
@@ -567,7 +567,7 @@ gdata_calendar_calendar_get_access_level (GDataCalendarCalendar *self)
 /**
  * gdata_calendar_calendar_get_edited:
  * @self: a #GDataCalendarCalendar
- * @edited: a #GTimeVal
+ * @edited: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataCalendarCalendar:edited property and puts it in @edited. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/calendar/gdata-calendar-event.c b/gdata/services/calendar/gdata-calendar-event.c
index 479997c..1d8882b 100644
--- a/gdata/services/calendar/gdata-calendar-event.c
+++ b/gdata/services/calendar/gdata-calendar-event.c
@@ -678,7 +678,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces)
 /**
  * gdata_calendar_event_get_edited:
  * @self: a #GDataCalendarEvent
- * @edited: a #GTimeVal
+ * @edited: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataCalendarEvent:edited property and puts it in @edited. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -1095,8 +1095,8 @@ gdata_calendar_event_get_times (GDataCalendarEvent *self)
 /**
  * gdata_calendar_event_get_primary_time:
  * @self: a #GDataCalendarEvent
- * @start_time: a #GTimeVal for the start time, or %NULL
- * @end_time: a #GTimeVal for the end time, or %NULL
+ * @start_time: (out caller-allocates): a #GTimeVal for the start time, or %NULL
+ * @end_time: (out caller-allocates): a #GTimeVal for the end time, or %NULL
  * @when: a #GDataGDWhen for the primary time structure, or %NULL
  *
  * Gets the first time period associated with the event, conveniently returning just its start and
diff --git a/gdata/services/calendar/gdata-calendar-query.c b/gdata/services/calendar/gdata-calendar-query.c
index 13e6aca..8bc6e2a 100644
--- a/gdata/services/calendar/gdata-calendar-query.c
+++ b/gdata/services/calendar/gdata-calendar-query.c
@@ -488,7 +488,7 @@ gdata_calendar_query_set_order_by (GDataCalendarQuery *self, const gchar *order_
 /**
  * gdata_calendar_query_get_recurrence_expansion_start:
  * @self: a #GDataCalendarQuery
- * @start: a #GTimeVal
+ * @start: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataCalendarQuery:recurrence-expansion-start property and puts it
  * in @start. If the property is unset, both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -532,7 +532,7 @@ gdata_calendar_query_set_recurrence_expansion_start (GDataCalendarQuery *self, G
 /**
  * gdata_calendar_query_get_recurrence_expansion_end:
  * @self: a #GDataCalendarQuery
- * @end: a #GTimeVal
+ * @end: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataCalendarQuery:recurrence-expansion-end property and puts it
  * in @end. If the property is unset, both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -646,7 +646,7 @@ gdata_calendar_query_set_sort_order (GDataCalendarQuery *self, const gchar *sort
 /**
  * gdata_calendar_query_get_start_min:
  * @self: a #GDataCalendarQuery
- * @start_min: a #GTimeVal
+ * @start_min: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataCalendarQuery:start-min property and puts it
  * in @start_min. If the property is unset, both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -690,7 +690,7 @@ gdata_calendar_query_set_start_min (GDataCalendarQuery *self, GTimeVal *start_mi
 /**
  * gdata_calendar_query_get_start_max:
  * @self: a #GDataCalendarQuery
- * @start_max: a #GTimeVal
+ * @start_max: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataCalendarQuery:start-max property and puts it
  * in @start_max. If the property is unset, both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/contacts/gdata-contacts-contact.c b/gdata/services/contacts/gdata-contacts-contact.c
index f3fa295..c710778 100644
--- a/gdata/services/contacts/gdata-contacts-contact.c
+++ b/gdata/services/contacts/gdata-contacts-contact.c
@@ -494,7 +494,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces)
 /**
  * gdata_contacts_contact_get_edited:
  * @self: a #GDataContactsContact
- * @edited: a #GTimeVal
+ * @edited: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataContactsContact:edited property and puts it in @edited. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/documents/gdata-documents-entry.c b/gdata/services/documents/gdata-documents-entry.c
index 0c78d3c..a59966f 100644
--- a/gdata/services/documents/gdata-documents-entry.c
+++ b/gdata/services/documents/gdata-documents-entry.c
@@ -381,7 +381,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces)
 /**
  * gdata_documents_entry_get_edited:
  * @self: a #GDataDocumentsEntry
- * @edited: a #GTimeVal
+ * @edited: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataDocumentsEntry:edited property and puts it in @edited. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -399,7 +399,7 @@ gdata_documents_entry_get_edited (GDataDocumentsEntry *self, GTimeVal *edited)
 /**
  * gdata_documents_entry_get_last_viewed:
  * @self: a #GDataDocumentsEntry
- * @last_viewed: a #GTimeVal
+ * @last_viewed: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataDocumentsEntry:last-viewed property and puts it in @last_viewed. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/picasaweb/gdata-picasaweb-album.c b/gdata/services/picasaweb/gdata-picasaweb-album.c
index 70b2f7b..4b78c2e 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-album.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-album.c
@@ -885,7 +885,7 @@ gdata_picasaweb_album_get_nickname (GDataPicasaWebAlbum *self)
 /**
  * gdata_picasaweb_album_get_edited:
  * @self: a #GDataPicasaWebAlbum
- * @edited: a #GTimeVal
+ * @edited: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataPicasaWebAlbum:edited property and puts it in @edited. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -976,7 +976,7 @@ gdata_picasaweb_album_set_visibility (GDataPicasaWebAlbum *self, GDataPicasaWebV
 /**
  * gdata_picasaweb_album_get_timestamp:
  * @self: a #GDataPicasaWebAlbum
- * @timestamp: a #GTimeVal
+ * @timestamp: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataPicasaWebAlbum:timestamp property and puts it in @timestamp. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/picasaweb/gdata-picasaweb-file.c b/gdata/services/picasaweb/gdata-picasaweb-file.c
index 9c7a520..7daee23 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-file.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-file.c
@@ -1096,7 +1096,7 @@ gdata_picasaweb_file_get_id (GDataPicasaWebFile *self)
 /**
  * gdata_picasaweb_file_get_edited:
  * @self: a #GDataPicasaWebFile
- * @edited: a #GTimeVal
+ * @edited: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataPicasaWebFile:edited property and puts it in @edited. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -1329,7 +1329,7 @@ gdata_picasaweb_file_set_checksum (GDataPicasaWebFile *self, const gchar *checks
 /**
  * gdata_picasaweb_file_get_timestamp:
  * @self: a #GDataPicasaWebFile
- * @timestamp: a #GTimeVal
+ * @timestamp: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataPicasaWebFile:timestamp property and puts it in @timestamp. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/youtube/gdata-youtube-group.c b/gdata/services/youtube/gdata-youtube-group.c
index 1084625..a29da57 100644
--- a/gdata/services/youtube/gdata-youtube-group.c
+++ b/gdata/services/youtube/gdata-youtube-group.c
@@ -239,7 +239,7 @@ gdata_youtube_group_set_is_private (GDataYouTubeGroup *self, gboolean is_private
 /**
  * gdata_youtube_group_get_uploaded:
  * @self: a #GDataYouTubeGroup
- * @uploaded: a #GTimeVal
+ * @uploaded: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataYouTubeGroup:uploaded property and puts it in @uploaded. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
diff --git a/gdata/services/youtube/gdata-youtube-video.c b/gdata/services/youtube/gdata-youtube-video.c
index f94e3f0..946b4d9 100644
--- a/gdata/services/youtube/gdata-youtube-video.c
+++ b/gdata/services/youtube/gdata-youtube-video.c
@@ -1202,7 +1202,7 @@ gdata_youtube_video_set_is_private (GDataYouTubeVideo *self, gboolean is_private
 /**
  * gdata_youtube_video_get_uploaded:
  * @self: a #GDataYouTubeVideo
- * @uploaded: a #GTimeVal
+ * @uploaded: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataYouTubeVideo:uploaded property and puts it in @uploaded. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
@@ -1280,7 +1280,7 @@ gdata_youtube_video_get_state (GDataYouTubeVideo *self)
 /**
  * gdata_youtube_video_get_recorded:
  * @self: a #GDataYouTubeVideo
- * @recorded: a #GTimeVal
+ * @recorded: (out caller-allocates): a #GTimeVal
  *
  * Gets the #GDataYouTubeVideo:recorded property and puts it in @recorded. If the property is unset,
  * both fields in the #GTimeVal will be set to <code class="literal">0</code>.
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]