GNOME.org
 

[libgdata] [introspection] Add (out) annotations to GTimeVal parameters

commit d66dd4ec51f8cf275a9bb76e6b4ea706aabdeda2
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-access-rule.c                         |    2 +-
 gdata/gdata-entry.c                               |    4 ++--
 gdata/gdata-feed.c                                |    2 +-
 gdata/gdata-parser.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 ++--
 17 files changed, 31 insertions(+), 31 deletions(-)
---
diff --git a/gdata/exif/gdata-exif-tags.c b/gdata/exif/gdata-exif-tags.c
index 92d7947..177b3d2 100644
--- a/gdata/exif/gdata-exif-tags.c
+++ b/gdata/exif/gdata-exif-tags.c
@@ -327,7 +327,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 ecb2bac..cc2ebae 100644
--- a/gdata/gd/gdata-gd-reminder.c
+++ b/gdata/gd/gdata-gd-reminder.c
@@ -374,7 +374,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 bf3babb..38a74da 100644
--- a/gdata/gd/gdata-gd-when.c
+++ b/gdata/gd/gdata-gd-when.c
@@ -407,7 +407,7 @@ gdata_gd_when_new (const GTimeVal *start_time, const GTimeVal *end_time, gboolea
 /**
  * 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.
  *
@@ -443,7 +443,7 @@ gdata_gd_when_set_start_time (GDataGDWhen *self, const 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-access-rule.c b/gdata/gdata-access-rule.c
index f415002..6ae83d2 100644
--- a/gdata/gdata-access-rule.c
+++ b/gdata/gdata-access-rule.c
@@ -431,7 +431,7 @@ gdata_access_rule_get_scope (GDataAccessRule *self, const gchar **type, const gc
 /**
  * gdata_access_rule_get_edited:
  * @self: a #GDataAccessRule
- * @edited: return location for the edited time
+ * @edited: (out caller-allocates): return location for the edited time
  *
  * Gets the #GDataAccessRule: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/gdata-entry.c b/gdata/gdata-entry.c
index 29a4eae..6c01df8 100644
--- a/gdata/gdata-entry.c
+++ b/gdata/gdata-entry.c
@@ -669,7 +669,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.
  **/
@@ -702,7 +702,7 @@ _gdata_entry_set_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 d2c86c2..d876e84 100644
--- a/gdata/gdata-feed.c
+++ b/gdata/gdata-feed.c
@@ -830,7 +830,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-parser.c b/gdata/gdata-parser.c
index 9bc0ff9..96b1b07 100644
--- a/gdata/gdata-parser.c
+++ b/gdata/gdata-parser.c
@@ -364,7 +364,7 @@ gdata_parser_string_from_element (xmlNode *element, const gchar *element_name, G
  * @element: the element to check against
  * @element_name: the name of the element to parse
  * @options: a bitwise combination of parsing options from #GDataParserOptions, or %P_NONE
- * @output: the return location for the parsed time value
+ * @output: (out caller-allocates): the return location for the parsed time value
  * @success: the return location for a value which is %TRUE if the time val was parsed successfully, %FALSE if an error was encountered,
  * and undefined if @element didn't match @element_name
  * @error: a #GError, or %NULL
diff --git a/gdata/gdata-query.c b/gdata/gdata-query.c
index 5d8ee83..9705bad 100644
--- a/gdata/gdata-query.c
+++ b/gdata/gdata-query.c
@@ -659,7 +659,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>.
@@ -702,7 +702,7 @@ gdata_query_set_updated_min (GDataQuery *self, const 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>.
@@ -745,7 +745,7 @@ gdata_query_set_updated_max (GDataQuery *self, const 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>.
@@ -788,7 +788,7 @@ gdata_query_set_published_min (GDataQuery *self, const 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 8ad60d9..6b3272a 100644
--- a/gdata/services/calendar/gdata-calendar-calendar.c
+++ b/gdata/services/calendar/gdata-calendar-calendar.c
@@ -570,7 +570,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 d360fab..2d47503 100644
--- a/gdata/services/calendar/gdata-calendar-event.c
+++ b/gdata/services/calendar/gdata-calendar-event.c
@@ -662,7 +662,7 @@ gdata_calendar_event_new (const gchar *id)
 /**
  * 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>.
@@ -1079,8 +1079,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 a576a3a..c641658 100644
--- a/gdata/services/calendar/gdata-calendar-query.c
+++ b/gdata/services/calendar/gdata-calendar-query.c
@@ -487,7 +487,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>.
@@ -531,7 +531,7 @@ gdata_calendar_query_set_recurrence_expansion_start (GDataCalendarQuery *self, c
 /**
  * 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>.
@@ -645,7 +645,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>.
@@ -689,7 +689,7 @@ gdata_calendar_query_set_start_min (GDataCalendarQuery *self, const GTimeVal *st
 /**
  * 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 f81f73e..358287b 100644
--- a/gdata/services/contacts/gdata-contacts-contact.c
+++ b/gdata/services/contacts/gdata-contacts-contact.c
@@ -1053,7 +1053,7 @@ gdata_contacts_contact_new (const gchar *id)
 /**
  * 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 d371ee4..3b89730 100644
--- a/gdata/services/documents/gdata-documents-entry.c
+++ b/gdata/services/documents/gdata-documents-entry.c
@@ -372,7 +372,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>.
@@ -390,7 +390,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 c2530b4..eaae712 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-album.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-album.c
@@ -900,7 +900,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>.
@@ -991,7 +991,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. This value usually holds either the date that best
diff --git a/gdata/services/picasaweb/gdata-picasaweb-file.c b/gdata/services/picasaweb/gdata-picasaweb-file.c
index 81f5e31..39f3182 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-file.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-file.c
@@ -1127,7 +1127,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>.
@@ -1360,7 +1360,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 5dc468f..c4feeb8 100644
--- a/gdata/services/youtube/gdata-youtube-group.c
+++ b/gdata/services/youtube/gdata-youtube-group.c
@@ -194,7 +194,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 3d5a861..42415a0 100644
--- a/gdata/services/youtube/gdata-youtube-video.c
+++ b/gdata/services/youtube/gdata-youtube-video.c
@@ -1262,7 +1262,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>.
@@ -1341,7 +1341,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]