diff options
Diffstat (limited to 'gdata/services')
74 files changed, 764 insertions, 764 deletions
diff --git a/gdata/services/calendar/gdata-calendar-calendar.c b/gdata/services/calendar/gdata-calendar-calendar.c index da756046..c7815588 100644 --- a/gdata/services/calendar/gdata-calendar-calendar.c +++ b/gdata/services/calendar/gdata-calendar-calendar.c @@ -72,7 +72,7 @@ * g_object_unref (feed); * </programlisting> * </example> - **/ + */ #include <config.h> #include <glib.h> @@ -142,7 +142,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * * The timezone in which the calendar's times are given. This is a timezone name in tz database notation: <ulink type="http" * url="http://en.wikipedia.org/wiki/Tz_database#Names_of_time_zones">reference</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMEZONE, g_param_spec_string ("timezone", "Timezone", "The timezone in which the calendar's times are given.", @@ -157,7 +157,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * Deprecated: 0.17.2: Unsupported by the online API any more. There * is no replacement; this will always return * <code class="literal">0</code>. - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMES_CLEANED, g_param_spec_uint ("times-cleaned", "Times cleaned", "The number of times the calendar has been cleared of events.", @@ -172,7 +172,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * Indicates whether the calendar is visible. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_HIDDEN, g_param_spec_boolean ("is-hidden", "Hidden?", "Indicates whether the calendar is visible.", @@ -185,7 +185,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * The background color used to highlight the calendar in the user’s * browser. This used to be restricted to a limited set of colours, but * since 0.17.2 may be any RGB colour. - **/ + */ g_object_class_install_property (gobject_class, PROP_COLOR, g_param_spec_boxed ("color", "Color", "The background color used to highlight the calendar in the user's browser.", @@ -198,7 +198,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * Indicates whether the calendar is selected. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_SELECTED, g_param_spec_boolean ("is-selected", "Selected?", "Indicates whether the calendar is selected.", @@ -211,7 +211,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * Indicates the access level the current user has to the calendar. For example: %GDATA_CALENDAR_ACCESS_ROLE_READ or * %GDATA_CALENDAR_ACCESS_ROLE_FREE_BUSY. The "current user" is the one authenticated against the service's #GDataService:authorizer, * or the guest user. - **/ + */ g_object_class_install_property (gobject_class, PROP_ACCESS_LEVEL, g_param_spec_string ("access-level", "Access level", "Indicates the access level the current user has to the calendar.", @@ -228,7 +228,7 @@ gdata_calendar_calendar_class_init (GDataCalendarCalendarClass *klass) * * Deprecated: 0.17.2: Unsupported by the online API any more. There * is no replacement; this will always return -1. - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The last time the calendar was edited.", @@ -614,7 +614,7 @@ get_content_type (void) * Creates a new #GDataCalendarCalendar with the given ID and default properties. * * Return value: a new #GDataCalendarCalendar; unref with g_object_unref() - **/ + */ GDataCalendarCalendar * gdata_calendar_calendar_new (const gchar *id) { @@ -628,7 +628,7 @@ gdata_calendar_calendar_new (const gchar *id) * Gets the #GDataCalendarCalendar:timezone property. * * Return value: the calendar's timezone, or %NULL - **/ + */ const gchar * gdata_calendar_calendar_get_timezone (GDataCalendarCalendar *self) { @@ -644,7 +644,7 @@ gdata_calendar_calendar_get_timezone (GDataCalendarCalendar *self) * Sets the #GDataCalendarCalendar:timezone property to the new timezone, @_timezone. * * Set @_timezone to %NULL to unset the property in the calendar. - **/ + */ void gdata_calendar_calendar_set_timezone (GDataCalendarCalendar *self, const gchar *_timezone) { @@ -665,7 +665,7 @@ gdata_calendar_calendar_set_timezone (GDataCalendarCalendar *self, const gchar * * Return value: the number of times the calendar has been totally emptied * Deprecated: 0.17.2: Unsupported by the online API any more. There is no * replacement; this will always return <code class="literal">0</code>. - **/ + */ guint gdata_calendar_calendar_get_times_cleaned (GDataCalendarCalendar *self) { @@ -682,7 +682,7 @@ gdata_calendar_calendar_get_times_cleaned (GDataCalendarCalendar *self) * Return value: %TRUE if the calendar is hidden, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_calendar_calendar_is_hidden (GDataCalendarCalendar *self) { @@ -698,7 +698,7 @@ gdata_calendar_calendar_is_hidden (GDataCalendarCalendar *self) * Sets the #GDataCalendarCalendar:is-hidden property to @is_hidden. * * Since: 0.2.0 - **/ + */ void gdata_calendar_calendar_set_is_hidden (GDataCalendarCalendar *self, gboolean is_hidden) { @@ -713,7 +713,7 @@ gdata_calendar_calendar_set_is_hidden (GDataCalendarCalendar *self, gboolean is_ * @color: (out caller-allocates): a #GDataColor * * Gets the #GDataCalendarCalendar:color property and puts it in @color. - **/ + */ void gdata_calendar_calendar_get_color (GDataCalendarCalendar *self, GDataColor *color) { @@ -728,7 +728,7 @@ gdata_calendar_calendar_get_color (GDataCalendarCalendar *self, GDataColor *colo * @color: a new #GDataColor * * Sets the #GDataCalendarCalendar:color property to @color. - **/ + */ void gdata_calendar_calendar_set_color (GDataCalendarCalendar *self, const GDataColor *color) { @@ -747,7 +747,7 @@ gdata_calendar_calendar_set_color (GDataCalendarCalendar *self, const GDataColor * Return value: %TRUE if the calendar is selected, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_calendar_calendar_is_selected (GDataCalendarCalendar *self) { @@ -763,7 +763,7 @@ gdata_calendar_calendar_is_selected (GDataCalendarCalendar *self) * Sets the #GDataCalendarCalendar:is-selected property to @is_selected. * * Since: 0.2.0 - **/ + */ void gdata_calendar_calendar_set_is_selected (GDataCalendarCalendar *self, gboolean is_selected) { @@ -779,7 +779,7 @@ gdata_calendar_calendar_set_is_selected (GDataCalendarCalendar *self, gboolean i * Gets the #GDataCalendarCalendar:access-level property. * * Return value: the authenticated user's access level to the calendar, or %NULL - **/ + */ const gchar * gdata_calendar_calendar_get_access_level (GDataCalendarCalendar *self) { @@ -796,7 +796,7 @@ gdata_calendar_calendar_get_access_level (GDataCalendarCalendar *self) * Return value: the UNIX timestamp for the time the calendar was last edited, or <code class="literal">-1</code> * Deprecated: 0.17.2: Unsupported by the online API any more. There is no * replacement; this will always return <code class="literal">-1</code>. - **/ + */ gint64 gdata_calendar_calendar_get_edited (GDataCalendarCalendar *self) { diff --git a/gdata/services/calendar/gdata-calendar-calendar.h b/gdata/services/calendar/gdata-calendar-calendar.h index 01106e2d..ecb61d48 100644 --- a/gdata/services/calendar/gdata-calendar-calendar.h +++ b/gdata/services/calendar/gdata-calendar-calendar.h @@ -41,7 +41,7 @@ typedef struct _GDataCalendarCalendarPrivate GDataCalendarCalendarPrivate; * GDataCalendarCalendar: * * All the fields in the #GDataCalendarCalendar structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataEntry parent; GDataCalendarCalendarPrivate *priv; @@ -51,7 +51,7 @@ typedef struct { * GDataCalendarCalendarClass: * * All the fields in the #GDataCalendarCalendarClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/calendar/gdata-calendar-event.c b/gdata/services/calendar/gdata-calendar-event.c index 80ae225c..8ed3ec7d 100644 --- a/gdata/services/calendar/gdata-calendar-event.c +++ b/gdata/services/calendar/gdata-calendar-event.c @@ -80,7 +80,7 @@ * g_object_unref (new_event); * </programlisting> * </example> - **/ + */ #include <config.h> #include <glib.h> @@ -181,7 +181,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * For more information, see the <ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"> * Atom Publishing Protocol specification</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The last time the event was edited.", @@ -197,7 +197,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * GData specification</ulink>. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_STATUS, g_param_spec_string ("status", "Status", "The scheduling status of the event.", @@ -211,7 +211,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * For more information, see the <ulink type="http" url="http://code.google.com/apis/gdata/elements.html#gdVisibility"> * GData specification</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_VISIBILITY, g_param_spec_string ("visibility", "Visibility", "The event's visibility to calendar users.", @@ -226,7 +226,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * For more information, see the <ulink type="http" url="http://code.google.com/apis/gdata/elements.html#gdTransparency"> * GData specification</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_TRANSPARENCY, g_param_spec_string ("transparency", "Transparency", "How the event is marked as consuming time on a calendar.", @@ -238,7 +238,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * The globally unique identifier (UID) of the event as defined in Section 4.8.4.7 of <ulink type="http" * url="http://www.ietf.org/rfc/rfc2445.txt">RFC 2445</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_UID, g_param_spec_string ("uid", "UID", "The globally unique identifier (UID) of the event.", @@ -250,7 +250,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * The revision sequence number of the event as defined in Section 4.8.7.4 of <ulink type="http" * url="http://www.ietf.org/rfc/rfc2445.txt">RFC 2445</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_SEQUENCE, g_param_spec_uint ("sequence", "Sequence", "The revision sequence number of the event.", @@ -266,7 +266,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * For more information, see the * <ulink type="http" url="https://developers.google.com/google-apps/calendar/v3/reference/events#guestsCanInviteOthers"> * GData specification</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_GUESTS_CAN_MODIFY, g_param_spec_boolean ("guests-can-modify", "Guests can modify", "Indicates whether attendees may modify the original event.", @@ -280,7 +280,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/google-apps/calendar/v3/reference/events#guestsCanInviteOthers">GData specification</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_GUESTS_CAN_INVITE_OTHERS, g_param_spec_boolean ("guests-can-invite-others", "Guests can invite others", "Indicates whether attendees may invite others.", @@ -295,7 +295,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * For more information, see the * <ulink type="http" url="https://developers.google.com/google-apps/calendar/v3/reference/events#guestsCanSeeOtherGuests"> * GData specification</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_GUESTS_CAN_SEE_GUESTS, g_param_spec_boolean ("guests-can-see-guests", "Guests can see guests", "Indicates whether attendees can see other people invited.", @@ -306,7 +306,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * GDataCalendarEvent:anyone-can-add-self: * * Indicates whether anyone can invite themselves to the event, by adding themselves to the attendee list. - **/ + */ g_object_class_install_property (gobject_class, PROP_ANYONE_CAN_ADD_SELF, g_param_spec_boolean ("anyone-can-add-self", "Anyone can add self", "Indicates whether anyone can invite themselves to the event.", @@ -325,7 +325,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * exclusive. See the documentation for gdata_calendar_event_add_time() for details. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RECURRENCE, g_param_spec_string ("recurrence", "Recurrence", "Represents the dates and times when a recurring event takes place.", @@ -338,7 +338,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * The event ID for the original event, if this event is an exception to a recurring event. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ORIGINAL_EVENT_ID, g_param_spec_string ("original-event-id", "Original event ID", "The event ID for the original event.", @@ -351,7 +351,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * The event URI for the original event, if this event is an exception to a recurring event. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ORIGINAL_EVENT_URI, g_param_spec_string ("original-event-uri", "Original event URI", "The event URI for the original event.", @@ -1278,7 +1278,7 @@ get_content_type (void) * Creates a new #GDataCalendarEvent with the given ID and default properties. * * Return value: a new #GDataCalendarEvent; unref with g_object_unref() - **/ + */ GDataCalendarEvent * gdata_calendar_event_new (const gchar *id) { @@ -1292,7 +1292,7 @@ gdata_calendar_event_new (const gchar *id) * Gets the #GDataCalendarEvent:edited property. If the property is unset, <code class="literal">-1</code> will be returned. * * Return value: the UNIX timestamp for the time the event was last edited, or <code class="literal">-1</code> - **/ + */ gint64 gdata_calendar_event_get_edited (GDataCalendarEvent *self) { @@ -1309,7 +1309,7 @@ gdata_calendar_event_get_edited (GDataCalendarEvent *self) * Return value: the event status, or %NULL * * Since: 0.2.0 - **/ + */ const gchar * gdata_calendar_event_get_status (GDataCalendarEvent *self) { @@ -1327,7 +1327,7 @@ gdata_calendar_event_get_status (GDataCalendarEvent *self) * Set @status to %NULL to unset the property in the event. * * Since: 0.2.0 - **/ + */ void gdata_calendar_event_set_status (GDataCalendarEvent *self, const gchar *status) { @@ -1345,7 +1345,7 @@ gdata_calendar_event_set_status (GDataCalendarEvent *self, const gchar *status) * Gets the #GDataCalendarEvent:visibility property. * * Return value: the event visibility, or %NULL - **/ + */ const gchar * gdata_calendar_event_get_visibility (GDataCalendarEvent *self) { @@ -1361,7 +1361,7 @@ gdata_calendar_event_get_visibility (GDataCalendarEvent *self) * Sets the #GDataCalendarEvent:visibility property to the new visibility, @visibility. * * Set @visibility to %NULL to unset the property in the event. - **/ + */ void gdata_calendar_event_set_visibility (GDataCalendarEvent *self, const gchar *visibility) { @@ -1379,7 +1379,7 @@ gdata_calendar_event_set_visibility (GDataCalendarEvent *self, const gchar *visi * Gets the #GDataCalendarEvent:transparency property. * * Return value: the event transparency, or %NULL - **/ + */ const gchar * gdata_calendar_event_get_transparency (GDataCalendarEvent *self) { @@ -1395,7 +1395,7 @@ gdata_calendar_event_get_transparency (GDataCalendarEvent *self) * Sets the #GDataCalendarEvent:transparency property to the new transparency, @transparency. * * Set @transparency to %NULL to unset the property in the event. - **/ + */ void gdata_calendar_event_set_transparency (GDataCalendarEvent *self, const gchar *transparency) { @@ -1413,7 +1413,7 @@ gdata_calendar_event_set_transparency (GDataCalendarEvent *self, const gchar *tr * Gets the #GDataCalendarEvent:uid property. * * Return value: the event's UID, or %NULL - **/ + */ const gchar * gdata_calendar_event_get_uid (GDataCalendarEvent *self) { @@ -1429,7 +1429,7 @@ gdata_calendar_event_get_uid (GDataCalendarEvent *self) * Sets the #GDataCalendarEvent:uid property to the new UID, @uid. * * Set @uid to %NULL to unset the property in the event. - **/ + */ void gdata_calendar_event_set_uid (GDataCalendarEvent *self, const gchar *uid) { @@ -1448,7 +1448,7 @@ gdata_calendar_event_set_uid (GDataCalendarEvent *self, const gchar *uid) * Gets the #GDataCalendarEvent:sequence property. * * Return value: the event's sequence number - **/ + */ guint gdata_calendar_event_get_sequence (GDataCalendarEvent *self) { @@ -1462,7 +1462,7 @@ gdata_calendar_event_get_sequence (GDataCalendarEvent *self) * @sequence: a new sequence number, or <code class="literal">0</code> * * Sets the #GDataCalendarEvent:sequence property to the new sequence number, @sequence. - **/ + */ void gdata_calendar_event_set_sequence (GDataCalendarEvent *self, guint sequence) { @@ -1478,7 +1478,7 @@ gdata_calendar_event_set_sequence (GDataCalendarEvent *self, guint sequence) * Gets the #GDataCalendarEvent:guests-can-modify property. * * Return value: %TRUE if attendees can modify the original event, %FALSE otherwise - **/ + */ gboolean gdata_calendar_event_get_guests_can_modify (GDataCalendarEvent *self) { @@ -1492,7 +1492,7 @@ gdata_calendar_event_get_guests_can_modify (GDataCalendarEvent *self) * @guests_can_modify: %TRUE if attendees can modify the original event, %FALSE otherwise * * Sets the #GDataCalendarEvent:guests-can-modify property to @guests_can_modify. - **/ + */ void gdata_calendar_event_set_guests_can_modify (GDataCalendarEvent *self, gboolean guests_can_modify) { @@ -1508,7 +1508,7 @@ gdata_calendar_event_set_guests_can_modify (GDataCalendarEvent *self, gboolean g * Gets the #GDataCalendarEvent:guests-can-invite-others property. * * Return value: %TRUE if attendees can invite others to the event, %FALSE otherwise - **/ + */ gboolean gdata_calendar_event_get_guests_can_invite_others (GDataCalendarEvent *self) { @@ -1522,7 +1522,7 @@ gdata_calendar_event_get_guests_can_invite_others (GDataCalendarEvent *self) * @guests_can_invite_others: %TRUE if attendees can invite others to the event, %FALSE otherwise * * Sets the #GDataCalendarEvent:guests-can-invite-others property to @guests_can_invite_others. - **/ + */ void gdata_calendar_event_set_guests_can_invite_others (GDataCalendarEvent *self, gboolean guests_can_invite_others) { @@ -1538,7 +1538,7 @@ gdata_calendar_event_set_guests_can_invite_others (GDataCalendarEvent *self, gbo * Gets the #GDataCalendarEvent:guests-can-see-guests property. * * Return value: %TRUE if attendees can see who's attending the event, %FALSE otherwise - **/ + */ gboolean gdata_calendar_event_get_guests_can_see_guests (GDataCalendarEvent *self) { @@ -1552,7 +1552,7 @@ gdata_calendar_event_get_guests_can_see_guests (GDataCalendarEvent *self) * @guests_can_see_guests: %TRUE if attendees can see who's attending the event, %FALSE otherwise * * Sets the #GDataCalendarEvent:guests-can-see-guests property to @guests_can_see_guests. - **/ + */ void gdata_calendar_event_set_guests_can_see_guests (GDataCalendarEvent *self, gboolean guests_can_see_guests) { @@ -1568,7 +1568,7 @@ gdata_calendar_event_set_guests_can_see_guests (GDataCalendarEvent *self, gboole * Gets the #GDataCalendarEvent:anyone-can-add-self property. * * Return value: %TRUE if anyone can add themselves as an attendee to the event, %FALSE otherwise - **/ + */ gboolean gdata_calendar_event_get_anyone_can_add_self (GDataCalendarEvent *self) { @@ -1582,7 +1582,7 @@ gdata_calendar_event_get_anyone_can_add_self (GDataCalendarEvent *self) * @anyone_can_add_self: %TRUE if anyone can add themselves as an attendee to the event, %FALSE otherwise * * Sets the #GDataCalendarEvent:anyone-can-add-self property to @anyone_can_add_self. - **/ + */ void gdata_calendar_event_set_anyone_can_add_self (GDataCalendarEvent *self, gboolean anyone_can_add_self) { @@ -1599,7 +1599,7 @@ gdata_calendar_event_set_anyone_can_add_self (GDataCalendarEvent *self, gboolean * Adds the person @who to the event as a guest (attendee, organiser, performer, etc.), and increments its reference count. * * Duplicate people will not be added to the list. - **/ + */ void gdata_calendar_event_add_person (GDataCalendarEvent *self, GDataGDWho *who) { @@ -1619,7 +1619,7 @@ gdata_calendar_event_add_person (GDataCalendarEvent *self, GDataGDWho *who) * Return value: (element-type GData.GDWho) (transfer none): a #GList of #GDataGDWho<!-- -->s, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_calendar_event_get_people (GDataCalendarEvent *self) { @@ -1635,7 +1635,7 @@ gdata_calendar_event_get_people (GDataCalendarEvent *self) * Adds the place @where to the event as a location and increments its reference count. * * Duplicate places will not be added to the list. - **/ + */ void gdata_calendar_event_add_place (GDataCalendarEvent *self, GDataGDWhere *where) { @@ -1655,7 +1655,7 @@ gdata_calendar_event_add_place (GDataCalendarEvent *self, GDataGDWhere *where) * Return value: (element-type GData.GDWhere) (transfer none): a #GList of #GDataGDWhere<!-- -->s, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_calendar_event_get_places (GDataCalendarEvent *self) { @@ -1681,7 +1681,7 @@ gdata_calendar_event_get_places (GDataCalendarEvent *self) * inserted using gdata_service_insert_entry(). * * Since: 0.2.0 - **/ + */ void gdata_calendar_event_add_time (GDataCalendarEvent *self, GDataGDWhen *when) { @@ -1701,7 +1701,7 @@ gdata_calendar_event_add_time (GDataCalendarEvent *self, GDataGDWhen *when) * Return value: (element-type GData.GDWhen) (transfer none): a #GList of #GDataGDWhen<!-- -->s, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_calendar_event_get_times (GDataCalendarEvent *self) { @@ -1725,7 +1725,7 @@ gdata_calendar_event_get_times (GDataCalendarEvent *self) * Return value: %TRUE if there is only one time period associated with the event, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_calendar_event_get_primary_time (GDataCalendarEvent *self, gint64 *start_time, gint64 *end_time, GDataGDWhen **when) { @@ -1756,7 +1756,7 @@ gdata_calendar_event_get_primary_time (GDataCalendarEvent *self, gint64 *start_t * Return value: the event recurrence patterns, or %NULL * * Since: 0.3.0 - **/ + */ const gchar * gdata_calendar_event_get_recurrence (GDataCalendarEvent *self) { @@ -1777,7 +1777,7 @@ gdata_calendar_event_get_recurrence (GDataCalendarEvent *self) * exclusive. See the documentation for gdata_calendar_event_add_time() for details. * * Since: 0.3.0 - **/ + */ void gdata_calendar_event_set_recurrence (GDataCalendarEvent *self, const gchar *recurrence) { @@ -1805,7 +1805,7 @@ gdata_calendar_event_set_recurrence (GDataCalendarEvent *self, const gchar *recu * freed with g_free(). * * Since: 0.3.0 - **/ + */ void gdata_calendar_event_get_original_event_details (GDataCalendarEvent *self, gchar **event_id, gchar **event_uri) { @@ -1827,7 +1827,7 @@ gdata_calendar_event_get_original_event_details (GDataCalendarEvent *self, gchar * Return value: %TRUE if the event is an exception, %FALSE otherwise * * Since: 0.3.0 - **/ + */ gboolean gdata_calendar_event_is_exception (GDataCalendarEvent *self) { diff --git a/gdata/services/calendar/gdata-calendar-event.h b/gdata/services/calendar/gdata-calendar-event.h index 0dc3e65e..c19ff509 100644 --- a/gdata/services/calendar/gdata-calendar-event.h +++ b/gdata/services/calendar/gdata-calendar-event.h @@ -44,7 +44,7 @@ typedef struct _GDataCalendarEventPrivate GDataCalendarEventPrivate; * GDataCalendarEvent: * * All the fields in the #GDataCalendarEvent structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataEntry parent; GDataCalendarEventPrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * GDataCalendarEventClass: * * All the fields in the #GDataCalendarEventClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/calendar/gdata-calendar-feed.c b/gdata/services/calendar/gdata-calendar-feed.c index 62ff054f..1a8ece3a 100644 --- a/gdata/services/calendar/gdata-calendar-feed.c +++ b/gdata/services/calendar/gdata-calendar-feed.c @@ -25,7 +25,7 @@ * * #GDataCalendarFeed is a subclass of #GDataFeed to represent a results feed from Google Calendar. It adds a couple of * properties which are specific to the Google Calendar API. - **/ + */ #include <glib.h> #include <libxml/parser.h> @@ -59,7 +59,7 @@ gdata_calendar_feed_class_init (GDataCalendarFeedClass *klass) * Since: 0.3.0 * Deprecated: 0.17.2: Unsupported by the online API any more. There * is no replacement; this will always return %NULL. - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMEZONE, g_param_spec_string ("timezone", "Timezone", "The timezone in which the feed's times are given.", @@ -76,7 +76,7 @@ gdata_calendar_feed_class_init (GDataCalendarFeedClass *klass) * Since: 0.3.0 * Deprecated: 0.17.2: Unsupported by the online API any more. There * is no replacement; this will always return 0. - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMES_CLEANED, g_param_spec_uint ("times-cleaned", "Times cleaned", "The number of times the feed has been completely cleared of entries.", @@ -128,7 +128,7 @@ gdata_calendar_feed_get_property (GObject *object, guint property_id, GValue *va * Since: 0.3.0 * Deprecated: 0.17.2: Unsupported by the online API any more. There is no * replacement; this will always return %NULL. - **/ + */ const gchar * gdata_calendar_feed_get_timezone (GDataCalendarFeed *self) { @@ -148,7 +148,7 @@ gdata_calendar_feed_get_timezone (GDataCalendarFeed *self) * Since: 0.3.0 * Deprecated: 0.17.2: Unsupported by the online API any more. There is no * replacement; this will always return %NULL. - **/ + */ guint gdata_calendar_feed_get_times_cleaned (GDataCalendarFeed *self) { diff --git a/gdata/services/calendar/gdata-calendar-feed.h b/gdata/services/calendar/gdata-calendar-feed.h index f9b2bc15..43b64522 100644 --- a/gdata/services/calendar/gdata-calendar-feed.h +++ b/gdata/services/calendar/gdata-calendar-feed.h @@ -43,7 +43,7 @@ typedef struct _GDataCalendarFeedPrivate GDataCalendarFeedPrivate; * All the fields in the #GDataCalendarFeed structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { GDataFeed parent; GDataCalendarFeedPrivate *priv; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataCalendarFeedClass structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { /*< private >*/ GDataFeedClass parent; diff --git a/gdata/services/calendar/gdata-calendar-query.c b/gdata/services/calendar/gdata-calendar-query.c index 1d4c3918..89597ae0 100644 --- a/gdata/services/calendar/gdata-calendar-query.c +++ b/gdata/services/calendar/gdata-calendar-query.c @@ -75,7 +75,7 @@ * g_object_unref (feed); * </programlisting> * </example> - **/ + */ #include <config.h> #include <glib.h> @@ -141,7 +141,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * A shortcut to request all events scheduled for the future. Overrides the * #GDataCalendarQuery:recurrence-expansion-start, #GDataCalendarQuery:recurrence-expansion-end, * #GDataCalendarQuery:start-min and #GDataCalendarQuery:start-max properties. - **/ + */ g_object_class_install_property (gobject_class, PROP_FUTURE_EVENTS, g_param_spec_boolean ("future-events", "Future events?", "A shortcut to request all events scheduled for the future.", @@ -153,7 +153,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * * Specifies order of entries in a feed. Supported values are <literal>lastmodified</literal> and * <literal>starttime</literal>. - **/ + */ g_object_class_install_property (gobject_class, PROP_ORDER_BY, g_param_spec_string ("order-by", "Order by", "Specifies order of entries in a feed.", @@ -164,7 +164,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * GDataCalendarQuery:recurrence-expansion-start: * * Specifies the beginning of the time period to expand recurring events for, inclusive. - **/ + */ g_object_class_install_property (gobject_class, PROP_RECURRENCE_EXPANSION_START, g_param_spec_int64 ("recurrence-expansion-start", "Recurrence expansion start", "Specifies start of period to expand recurrences for.", @@ -175,7 +175,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * GDataCalendarQuery:recurrence-expansion-end: * * Specifies the end of the time period to expand recurring events for, exclusive. - **/ + */ g_object_class_install_property (gobject_class, PROP_RECURRENCE_EXPANSION_END, g_param_spec_int64 ("recurrence-expansion-end", "Recurrence expansion end", "Specifies end of period to expand recurrences for.", @@ -186,7 +186,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * GDataCalendarQuery:single-events: * * Indicates whether recurring events should be expanded or represented as a single event. - **/ + */ g_object_class_install_property (gobject_class, PROP_SINGLE_EVENTS, g_param_spec_boolean ("single-events", "Single events?", "Indicates whether recurring events should be expanded.", @@ -198,7 +198,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * * Specifies direction of sorting. Supported values are <literal>ascending</literal> and * <literal>descending</literal>. - **/ + */ g_object_class_install_property (gobject_class, PROP_SORT_ORDER, g_param_spec_string ("sort-order", "Sort order", "Specifies direction of sorting.", @@ -214,7 +214,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * included. * * If not specified, the default #GDataCalendarQuery:start-min is <literal>1970-01-01</literal>. - **/ + */ g_object_class_install_property (gobject_class, PROP_START_MIN, g_param_spec_int64 ("start-min", "Start min", "A timespan such that only events within the timespan are returned.", @@ -230,7 +230,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * included. * * If not specified, the default #GDataCalendarQuery:start-max is <literal>2031-01-01</literal>. - **/ + */ g_object_class_install_property (gobject_class, PROP_START_MAX, g_param_spec_int64 ("start-max", "Start max", "A timespan such that only events within the timespan are returned.", @@ -243,7 +243,7 @@ gdata_calendar_query_class_init (GDataCalendarQueryClass *klass) * The current timezone. If this is not specified, all times are returned in UTC. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMEZONE, g_param_spec_string ("timezone", "Timezone", "The current timezone.", @@ -494,7 +494,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Creates a new #GDataCalendarQuery with its #GDataQuery:q property set to @q. * * Return value: a new #GDataCalendarQuery - **/ + */ GDataCalendarQuery * gdata_calendar_query_new (const gchar *q) { @@ -511,7 +511,7 @@ gdata_calendar_query_new (const gchar *q) * applied. * * Return value: a new #GDataCalendarQuery - **/ + */ GDataCalendarQuery * gdata_calendar_query_new_with_limits (const gchar *q, gint64 start_min, gint64 start_max) { @@ -529,7 +529,7 @@ gdata_calendar_query_new_with_limits (const gchar *q, gint64 start_min, gint64 s * Gets the #GDataCalendarQuery:future-events property. * * Return value: the future events property - **/ + */ gboolean gdata_calendar_query_get_future_events (GDataCalendarQuery *self) { @@ -543,7 +543,7 @@ gdata_calendar_query_get_future_events (GDataCalendarQuery *self) * @future_events: %TRUE to unconditionally show future events, %FALSE otherwise * * Sets the #GDataCalendarQuery:future-events property of the #GDataCalendarQuery to @future_events. - **/ + */ void gdata_calendar_query_set_future_events (GDataCalendarQuery *self, gboolean future_events) { @@ -562,7 +562,7 @@ gdata_calendar_query_set_future_events (GDataCalendarQuery *self, gboolean futur * Gets the #GDataCalendarQuery:order-by property. * * Return value: the order by property, or %NULL if it is unset - **/ + */ const gchar * gdata_calendar_query_get_order_by (GDataCalendarQuery *self) { @@ -578,7 +578,7 @@ gdata_calendar_query_get_order_by (GDataCalendarQuery *self) * Sets the #GDataCalendarQuery:order-by property of the #GDataCalendarQuery to the new order by string, @order_by. * * Set @order_by to %NULL to unset the property in the query URI. - **/ + */ void gdata_calendar_query_set_order_by (GDataCalendarQuery *self, const gchar *order_by) { @@ -599,7 +599,7 @@ gdata_calendar_query_set_order_by (GDataCalendarQuery *self, const gchar *order_ * Gets the #GDataCalendarQuery:recurrence-expansion-start property. If the property is unset, <code class="literal">-1</code> will be returned. * * Return value: the UNIX timestamp for the recurrence-expansion-start property, or <code class="literal">-1</code> - **/ + */ gint64 gdata_calendar_query_get_recurrence_expansion_start (GDataCalendarQuery *self) { @@ -616,7 +616,7 @@ gdata_calendar_query_get_recurrence_expansion_start (GDataCalendarQuery *self) * to the new time/date, @start. * * Set @start to <code class="literal">-1</code> to unset the property in the query URI. - **/ + */ void gdata_calendar_query_set_recurrence_expansion_start (GDataCalendarQuery *self, gint64 start) { @@ -637,7 +637,7 @@ gdata_calendar_query_set_recurrence_expansion_start (GDataCalendarQuery *self, g * Gets the #GDataCalendarQuery:recurrence-expansion-end property. If the property is unset, <code class="literal">-1</code> will be returned. * * Return value: the UNIX timestamp for the recurrence-expansion-end property, or <code class="literal">-1</code> - **/ + */ gint64 gdata_calendar_query_get_recurrence_expansion_end (GDataCalendarQuery *self) { @@ -654,7 +654,7 @@ gdata_calendar_query_get_recurrence_expansion_end (GDataCalendarQuery *self) * to the new time/date, @end. * * Set @end to <code class="literal">-1</code> to unset the property in the query URI. - **/ + */ void gdata_calendar_query_set_recurrence_expansion_end (GDataCalendarQuery *self, gint64 end) { @@ -675,7 +675,7 @@ gdata_calendar_query_set_recurrence_expansion_end (GDataCalendarQuery *self, gin * Gets the #GDataCalendarQuery:single-events property. * * Return value: the single events property - **/ + */ gboolean gdata_calendar_query_get_single_events (GDataCalendarQuery *self) { @@ -689,7 +689,7 @@ gdata_calendar_query_get_single_events (GDataCalendarQuery *self) * @single_events: %TRUE to show recurring events as single events, %FALSE otherwise * * Sets the #GDataCalendarQuery:single-events property of the #GDataCalendarQuery to @single_events. - **/ + */ void gdata_calendar_query_set_single_events (GDataCalendarQuery *self, gboolean single_events) { @@ -708,7 +708,7 @@ gdata_calendar_query_set_single_events (GDataCalendarQuery *self, gboolean singl * Gets the #GDataCalendarQuery:sort-order property. * * Return value: the sort order property, or %NULL if it is unset - **/ + */ const gchar * gdata_calendar_query_get_sort_order (GDataCalendarQuery *self) { @@ -724,7 +724,7 @@ gdata_calendar_query_get_sort_order (GDataCalendarQuery *self) * Sets the #GDataCalendarQuery:sort-order property of the #GDataCalendarQuery to the new sort order string, @sort_order. * * Set @sort_order to %NULL to unset the property in the query URI. - **/ + */ void gdata_calendar_query_set_sort_order (GDataCalendarQuery *self, const gchar *sort_order) { @@ -745,7 +745,7 @@ gdata_calendar_query_set_sort_order (GDataCalendarQuery *self, const gchar *sort * Gets the #GDataCalendarQuery:start-min property. If the property is unset, <code class="literal">-1</code> will be returned. * * Return value: the UNIX timestamp for the start-min property, or <code class="literal">-1</code> - **/ + */ gint64 gdata_calendar_query_get_start_min (GDataCalendarQuery *self) { @@ -762,7 +762,7 @@ gdata_calendar_query_get_start_min (GDataCalendarQuery *self) * to the new time/date, @start_min. * * Set @start_min to <code class="literal">-1</code> to unset the property in the query URI. - **/ + */ void gdata_calendar_query_set_start_min (GDataCalendarQuery *self, gint64 start_min) { @@ -783,7 +783,7 @@ gdata_calendar_query_set_start_min (GDataCalendarQuery *self, gint64 start_min) * Gets the #GDataCalendarQuery:start-max property. If the property is unset, <code class="literal">-1</code> will be returned. * * Return value: the UNIX timestamp for the start-max property, or <code class="literal">-1</code> - **/ + */ gint64 gdata_calendar_query_get_start_max (GDataCalendarQuery *self) { @@ -800,7 +800,7 @@ gdata_calendar_query_get_start_max (GDataCalendarQuery *self) * to the new time/date, @start_max. * * Set @start_max to <code class="literal">-1</code> to unset the property in the query URI. - **/ + */ void gdata_calendar_query_set_start_max (GDataCalendarQuery *self, gint64 start_max) { @@ -823,7 +823,7 @@ gdata_calendar_query_set_start_max (GDataCalendarQuery *self, gint64 start_max) * Return value: the timezone property, or %NULL if it is unset * * Since: 0.2.0 - **/ + */ const gchar * gdata_calendar_query_get_timezone (GDataCalendarQuery *self) { @@ -841,7 +841,7 @@ gdata_calendar_query_get_timezone (GDataCalendarQuery *self) * Set @timezone to %NULL to unset the property in the query URI. * * Since: 0.2.0 - **/ + */ void gdata_calendar_query_set_timezone (GDataCalendarQuery *self, const gchar *_timezone) { diff --git a/gdata/services/calendar/gdata-calendar-query.h b/gdata/services/calendar/gdata-calendar-query.h index 293721d6..8c89d7c8 100644 --- a/gdata/services/calendar/gdata-calendar-query.h +++ b/gdata/services/calendar/gdata-calendar-query.h @@ -41,7 +41,7 @@ typedef struct _GDataCalendarQueryPrivate GDataCalendarQueryPrivate; * GDataCalendarQuery: * * All the fields in the #GDataCalendarQuery structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataQuery parent; GDataCalendarQueryPrivate *priv; @@ -51,7 +51,7 @@ typedef struct { * GDataCalendarQueryClass: * * All the fields in the #GDataCalendarQueryClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataQueryClass parent; diff --git a/gdata/services/calendar/gdata-calendar-service.c b/gdata/services/calendar/gdata-calendar-service.c index 09df9774..63bcdb32 100644 --- a/gdata/services/calendar/gdata-calendar-service.c +++ b/gdata/services/calendar/gdata-calendar-service.c @@ -132,7 +132,7 @@ * Before version 0.17.2, the Calendar service could be manipulated using * batch operations. That is no longer supported, and any batch operations * created on the calendar will fail. - **/ + */ #include <config.h> #include <glib.h> @@ -445,7 +445,7 @@ gdata_calendar_service_get_primary_authorization_domain (void) * For more details, see gdata_service_query(). * * 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, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -494,7 +494,7 @@ gdata_calendar_service_query_all_calendars (GDataCalendarService *self, GDataQue * this function, and gdata_service_query_async(), which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_calendar_service_query_all_calendars_async (GDataCalendarService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -542,7 +542,7 @@ gdata_calendar_service_query_all_calendars_async (GDataCalendarService *self, GD * For more details, see gdata_service_query(). * * 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, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -591,7 +591,7 @@ gdata_calendar_service_query_own_calendars (GDataCalendarService *self, GDataQue * this function, and gdata_service_query_async(), which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_calendar_service_query_own_calendars_async (GDataCalendarService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -654,7 +654,7 @@ build_events_uri (GDataCalendarCalendar *calendar) * For more details, see gdata_service_query(). * * 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, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -711,7 +711,7 @@ gdata_calendar_service_query_events (GDataCalendarService *self, GDataCalendarCa * which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_calendar_service_query_events_async (GDataCalendarService *self, GDataCalendarCalendar *calendar, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -767,7 +767,7 @@ gdata_calendar_service_query_events_async (GDataCalendarService *self, GDataCale * Deprecated: 0.17.2: Use gdata_calendar_service_insert_calendar_event() * instead to be able to specify the calendar to add the event to; otherwise * the default calendar will be used. - **/ + */ GDataCalendarEvent * gdata_calendar_service_insert_event (GDataCalendarService *self, GDataCalendarEvent *event, GCancellable *cancellable, GError **error) { @@ -852,7 +852,7 @@ gdata_calendar_service_insert_calendar_event (GDataCalendarService *self, * gdata_calendar_service_insert_calendar_event_async() instead to be able to * specify the calendar to add the event to; otherwise the default calendar * will be used. - **/ + */ void gdata_calendar_service_insert_event_async (GDataCalendarService *self, GDataCalendarEvent *event, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) diff --git a/gdata/services/calendar/gdata-calendar-service.h b/gdata/services/calendar/gdata-calendar-service.h index 47f245d9..4776c6d3 100644 --- a/gdata/services/calendar/gdata-calendar-service.h +++ b/gdata/services/calendar/gdata-calendar-service.h @@ -42,7 +42,7 @@ typedef struct _GDataCalendarServicePrivate GDataCalendarServicePrivate; * GDataCalendarService: * * All the fields in the #GDataCalendarService structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataService parent; } GDataCalendarService; @@ -51,7 +51,7 @@ typedef struct { * GDataCalendarServiceClass: * * All the fields in the #GDataCalendarServiceClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataServiceClass parent; diff --git a/gdata/services/contacts/gdata-contacts-contact.c b/gdata/services/contacts/gdata-contacts-contact.c index 8031d886..83a2888a 100644 --- a/gdata/services/contacts/gdata-contacts-contact.c +++ b/gdata/services/contacts/gdata-contacts-contact.c @@ -144,7 +144,7 @@ * </example> * * Since: 0.2.0 - **/ + */ #include <config.h> #include <glib.h> @@ -267,7 +267,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Atom Publishing Protocol specification</ulink>. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The last time the contact was edited.", @@ -280,7 +280,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Whether the entry has been deleted. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DELETED, g_param_spec_boolean ("deleted", "Deleted", "Whether the entry has been deleted.", @@ -293,7 +293,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The ETag of the contact's photo, if the contact has a photo; %NULL otherwise. * * Since: 0.9.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_PHOTO_ETAG, g_param_spec_string ("photo-etag", "Photo ETag", "The ETag of the contact's photo.", @@ -306,7 +306,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's name in a structured representation. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_object ("name", "Name", "The contact's name in a structured representation.", @@ -319,7 +319,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's chosen nickname. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NICKNAME, g_param_spec_string ("nickname", "Nickname", "The contact's chosen nickname.", @@ -345,7 +345,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's birthday. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_BIRTHDAY, g_param_spec_boxed ("birthday", "Birthday", "The contact's birthday.", @@ -358,7 +358,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Whether the contact's birthday includes their year of birth. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_BIRTHDAY_HAS_YEAR, g_param_spec_boolean ("birthday-has-year", "Birthday has year?", "Whether the contact's birthday includes their year of birth.", @@ -371,7 +371,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Billing information for the contact, such as their billing name and address. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_BILLING_INFORMATION, g_param_spec_string ("billing-information", "Billing information", "Billing information for the contact.", @@ -384,7 +384,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The name or address of a directory server associated with the contact. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DIRECTORY_SERVER, g_param_spec_string ("directory-server", "Directory server", "The name or address of an associated directory server.", @@ -397,7 +397,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The gender of the contact. For example: %GDATA_CONTACTS_GENDER_MALE or %GDATA_CONTACTS_GENDER_FEMALE. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_GENDER, g_param_spec_string ("gender", "Gender", "The gender of the contact.", @@ -410,7 +410,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The initials of the contact. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_INITIALS, g_param_spec_string ("initials", "Initials", "The initials of the contact.", @@ -423,7 +423,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The maiden name of the contact. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MAIDEN_NAME, g_param_spec_string ("maiden-name", "Maiden name", "The maiden name of the contact.", @@ -436,7 +436,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * A mileage associated with the contact, such as one for reimbursement purposes. It can be in any format. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MILEAGE, g_param_spec_string ("mileage", "Mileage", "A mileage associated with the contact.", @@ -449,7 +449,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's occupation. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_OCCUPATION, g_param_spec_string ("occupation", "Occupation", "The contact's occupation.", @@ -462,7 +462,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's importance. For example: %GDATA_CONTACTS_PRIORITY_NORMAL or %GDATA_CONTACTS_PRIORITY_HIGH. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_PRIORITY, g_param_spec_string ("priority", "Priority", "The contact's importance.", @@ -475,7 +475,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The sensitivity of the contact's data. For example: %GDATA_CONTACTS_SENSITIVITY_NORMAL or %GDATA_CONTACTS_SENSITIVITY_PRIVATE. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SENSITIVITY, g_param_spec_string ("sensitivity", "Sensitivity", "The sensitivity of the contact's data.", @@ -489,7 +489,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * whereas #GDataContactsContact:nickname should be used for nicknames. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SHORT_NAME, g_param_spec_string ("short-name", "Short name", "A short name for the contact.", @@ -502,7 +502,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The subject of the contact. (i.e. The contact's relevance to the address book.) * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SUBJECT, g_param_spec_string ("subject", "Subject", "The subject of the contact.", @@ -1262,7 +1262,7 @@ get_entry_uri (const gchar *id) * Return value: a new #GDataContactsContact; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataContactsContact * gdata_contacts_contact_new (const gchar *id) { @@ -1278,7 +1278,7 @@ gdata_contacts_contact_new (const gchar *id) * Return value: the UNIX timestamp for the time the contact was last edited, or <code class="literal">-1</code> * * Since: 0.2.0 - **/ + */ gint64 gdata_contacts_contact_get_edited (GDataContactsContact *self) { @@ -1295,7 +1295,7 @@ gdata_contacts_contact_get_edited (GDataContactsContact *self) * Return value: (transfer none): the contact's name, or %NULL * * Since: 0.5.0 - **/ + */ GDataGDName * gdata_contacts_contact_get_name (GDataContactsContact *self) { @@ -1313,7 +1313,7 @@ gdata_contacts_contact_get_name (GDataContactsContact *self) * @name must not be %NULL, though all its properties may be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_name (GDataContactsContact *self, GDataGDName *name) { @@ -1338,7 +1338,7 @@ gdata_contacts_contact_set_name (GDataContactsContact *self, GDataGDName *name) * Return value: the contact's nickname, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_nickname (GDataContactsContact *self) { @@ -1356,7 +1356,7 @@ gdata_contacts_contact_get_nickname (GDataContactsContact *self) * If @nickname is %NULL, the contact's nickname will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_nickname (GDataContactsContact *self, const gchar *nickname) { @@ -1394,7 +1394,7 @@ gdata_contacts_contact_get_file_as (GDataContactsContact *self) * If @file_as is %NULL, the contact will be filed under their full name. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_file_as (GDataContactsContact *self, const gchar *file_as) { @@ -1418,7 +1418,7 @@ gdata_contacts_contact_set_file_as (GDataContactsContact *self, const gchar *fil * Return value: whether the contact's birthday has the year set * * Since: 0.7.0 - **/ + */ gboolean gdata_contacts_contact_get_birthday (GDataContactsContact *self, GDate *birthday) { @@ -1441,7 +1441,7 @@ gdata_contacts_contact_get_birthday (GDataContactsContact *self, GDate *birthday * If @birthday is %NULL, the contact's birthday will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_birthday (GDataContactsContact *self, GDate *birthday, gboolean birthday_has_year) { @@ -1470,7 +1470,7 @@ gdata_contacts_contact_set_birthday (GDataContactsContact *self, GDate *birthday * Return value: the contact's billing information, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_billing_information (GDataContactsContact *self) { @@ -1488,7 +1488,7 @@ gdata_contacts_contact_get_billing_information (GDataContactsContact *self) * If @billing_information is %NULL, the contact's billing information will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_billing_information (GDataContactsContact *self, const gchar *billing_information) { @@ -1509,7 +1509,7 @@ gdata_contacts_contact_set_billing_information (GDataContactsContact *self, cons * Return value: the name or address of a directory server associated with the contact, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_directory_server (GDataContactsContact *self) { @@ -1527,7 +1527,7 @@ gdata_contacts_contact_get_directory_server (GDataContactsContact *self) * If @directory_server is %NULL, the contact's directory server will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_directory_server (GDataContactsContact *self, const gchar *directory_server) { @@ -1548,7 +1548,7 @@ gdata_contacts_contact_set_directory_server (GDataContactsContact *self, const g * Return value: the gender of the contact, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_gender (GDataContactsContact *self) { @@ -1566,7 +1566,7 @@ gdata_contacts_contact_get_gender (GDataContactsContact *self) * If @gender is %NULL, the contact's gender will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_gender (GDataContactsContact *self, const gchar *gender) { @@ -1587,7 +1587,7 @@ gdata_contacts_contact_set_gender (GDataContactsContact *self, const gchar *gend * Return value: the initials of the contact, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_initials (GDataContactsContact *self) { @@ -1605,7 +1605,7 @@ gdata_contacts_contact_get_initials (GDataContactsContact *self) * If @initials is %NULL, the contact's initials will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_initials (GDataContactsContact *self, const gchar *initials) { @@ -1625,7 +1625,7 @@ gdata_contacts_contact_set_initials (GDataContactsContact *self, const gchar *in * Return value: the maiden name of the contact, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_maiden_name (GDataContactsContact *self) { @@ -1643,7 +1643,7 @@ gdata_contacts_contact_get_maiden_name (GDataContactsContact *self) * If @maiden_name is %NULL, the contact's maiden name will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_maiden_name (GDataContactsContact *self, const gchar *maiden_name) { @@ -1663,7 +1663,7 @@ gdata_contacts_contact_set_maiden_name (GDataContactsContact *self, const gchar * Return value: a mileage associated with the contact, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_mileage (GDataContactsContact *self) { @@ -1681,7 +1681,7 @@ gdata_contacts_contact_get_mileage (GDataContactsContact *self) * If @mileage is %NULL, the contact's mileage will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_mileage (GDataContactsContact *self, const gchar *mileage) { @@ -1701,7 +1701,7 @@ gdata_contacts_contact_set_mileage (GDataContactsContact *self, const gchar *mil * Return value: the contact's occupation, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_occupation (GDataContactsContact *self) { @@ -1719,7 +1719,7 @@ gdata_contacts_contact_get_occupation (GDataContactsContact *self) * If @occupation is %NULL, the contact's occupation will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_occupation (GDataContactsContact *self, const gchar *occupation) { @@ -1739,7 +1739,7 @@ gdata_contacts_contact_set_occupation (GDataContactsContact *self, const gchar * * Return value: the contact's priority, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_priority (GDataContactsContact *self) { @@ -1757,7 +1757,7 @@ gdata_contacts_contact_get_priority (GDataContactsContact *self) * If @priority is %NULL, the contact's priority will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_priority (GDataContactsContact *self, const gchar *priority) { @@ -1778,7 +1778,7 @@ gdata_contacts_contact_set_priority (GDataContactsContact *self, const gchar *pr * Return value: the contact's sensitivity, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_sensitivity (GDataContactsContact *self) { @@ -1796,7 +1796,7 @@ gdata_contacts_contact_get_sensitivity (GDataContactsContact *self) * If @sensitivity is %NULL, the contact's sensitivity will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_sensitivity (GDataContactsContact *self, const gchar *sensitivity) { @@ -1817,7 +1817,7 @@ gdata_contacts_contact_set_sensitivity (GDataContactsContact *self, const gchar * Return value: the contact's short name, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_short_name (GDataContactsContact *self) { @@ -1835,7 +1835,7 @@ gdata_contacts_contact_get_short_name (GDataContactsContact *self) * If @short_name is %NULL, the contact's short name will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_short_name (GDataContactsContact *self, const gchar *short_name) { @@ -1855,7 +1855,7 @@ gdata_contacts_contact_set_short_name (GDataContactsContact *self, const gchar * * Return value: the contact's subject, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_subject (GDataContactsContact *self) { @@ -1873,7 +1873,7 @@ gdata_contacts_contact_get_subject (GDataContactsContact *self) * If @subject is %NULL, the contact's subject will be removed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_subject (GDataContactsContact *self, const gchar *subject) { @@ -1898,7 +1898,7 @@ gdata_contacts_contact_set_subject (GDataContactsContact *self, const gchar *sub * Duplicate e-mail addresses will not be added to the list. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_add_email_address (GDataContactsContact *self, GDataGDEmailAddress *email_address) { @@ -1918,7 +1918,7 @@ gdata_contacts_contact_add_email_address (GDataContactsContact *self, GDataGDEma * Return value: (element-type GData.GDEmailAddress) (transfer none): a #GList of #GDataGDEmailAddress<!-- -->es, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_contacts_contact_get_email_addresses (GDataContactsContact *self) { @@ -1935,7 +1935,7 @@ gdata_contacts_contact_get_email_addresses (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDEmailAddress, or %NULL * * Since: 0.2.0 - **/ + */ GDataGDEmailAddress * gdata_contacts_contact_get_primary_email_address (GDataContactsContact *self) { @@ -1958,7 +1958,7 @@ gdata_contacts_contact_get_primary_email_address (GDataContactsContact *self) * Removes all e-mail addresses from the contact. * * Since: 0.4.0 - **/ + */ void gdata_contacts_contact_remove_all_email_addresses (GDataContactsContact *self) { @@ -1987,7 +1987,7 @@ gdata_contacts_contact_remove_all_email_addresses (GDataContactsContact *self) * Duplicate IM addresses will not be added to the list. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_add_im_address (GDataContactsContact *self, GDataGDIMAddress *im_address) { @@ -2007,7 +2007,7 @@ gdata_contacts_contact_add_im_address (GDataContactsContact *self, GDataGDIMAddr * Return value: (element-type GData.GDIMAddress) (transfer none): a #GList of #GDataGDIMAddress<!-- -->es, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_contacts_contact_get_im_addresses (GDataContactsContact *self) { @@ -2024,7 +2024,7 @@ gdata_contacts_contact_get_im_addresses (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDIMAddress, or %NULL * * Since: 0.2.0 - **/ + */ GDataGDIMAddress * gdata_contacts_contact_get_primary_im_address (GDataContactsContact *self) { @@ -2047,7 +2047,7 @@ gdata_contacts_contact_get_primary_im_address (GDataContactsContact *self) * Removes all IM addresses from the contact. * * Since: 0.4.0 - **/ + */ void gdata_contacts_contact_remove_all_im_addresses (GDataContactsContact *self) { @@ -2076,7 +2076,7 @@ gdata_contacts_contact_remove_all_im_addresses (GDataContactsContact *self) * Duplicate phone numbers will not be added to the list. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_add_phone_number (GDataContactsContact *self, GDataGDPhoneNumber *phone_number) { @@ -2096,7 +2096,7 @@ gdata_contacts_contact_add_phone_number (GDataContactsContact *self, GDataGDPhon * Return value: (element-type GData.GDPhoneNumber) (transfer none): a #GList of #GDataGDPhoneNumber<!-- -->s, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_contacts_contact_get_phone_numbers (GDataContactsContact *self) { @@ -2113,7 +2113,7 @@ gdata_contacts_contact_get_phone_numbers (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDPhoneNumber, or %NULL * * Since: 0.2.0 - **/ + */ GDataGDPhoneNumber * gdata_contacts_contact_get_primary_phone_number (GDataContactsContact *self) { @@ -2136,7 +2136,7 @@ gdata_contacts_contact_get_primary_phone_number (GDataContactsContact *self) * Removes all phone numbers from the contact. * * Since: 0.4.0 - **/ + */ void gdata_contacts_contact_remove_all_phone_numbers (GDataContactsContact *self) { @@ -2165,7 +2165,7 @@ gdata_contacts_contact_remove_all_phone_numbers (GDataContactsContact *self) * Duplicate postal addresses will not be added to the list. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_add_postal_address (GDataContactsContact *self, GDataGDPostalAddress *postal_address) { @@ -2185,7 +2185,7 @@ gdata_contacts_contact_add_postal_address (GDataContactsContact *self, GDataGDPo * Return value: (element-type GData.GDPostalAddress) (transfer none): a #GList of #GDataGDPostalAddress<!-- -->es, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_contacts_contact_get_postal_addresses (GDataContactsContact *self) { @@ -2202,7 +2202,7 @@ gdata_contacts_contact_get_postal_addresses (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDPostalAddress, or %NULL * * Since: 0.2.0 - **/ + */ GDataGDPostalAddress * gdata_contacts_contact_get_primary_postal_address (GDataContactsContact *self) { @@ -2225,7 +2225,7 @@ gdata_contacts_contact_get_primary_postal_address (GDataContactsContact *self) * Removes all postal addresses from the contact. * * Since: 0.4.0 - **/ + */ void gdata_contacts_contact_remove_all_postal_addresses (GDataContactsContact *self) { @@ -2254,7 +2254,7 @@ gdata_contacts_contact_remove_all_postal_addresses (GDataContactsContact *self) * Duplicate organizations will not be added to the list. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_add_organization (GDataContactsContact *self, GDataGDOrganization *organization) { @@ -2274,7 +2274,7 @@ gdata_contacts_contact_add_organization (GDataContactsContact *self, GDataGDOrga * Return value: (element-type GData.GDOrganization) (transfer none): a #GList of #GDataGDOrganization<!-- -->s, or %NULL * * Since: 0.2.0 - **/ + */ GList * gdata_contacts_contact_get_organizations (GDataContactsContact *self) { @@ -2291,7 +2291,7 @@ gdata_contacts_contact_get_organizations (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDOrganization, or %NULL * * Since: 0.2.0 - **/ + */ GDataGDOrganization * gdata_contacts_contact_get_primary_organization (GDataContactsContact *self) { @@ -2314,7 +2314,7 @@ gdata_contacts_contact_get_primary_organization (GDataContactsContact *self) * Removes all organizations from the contact. * * Since: 0.4.0 - **/ + */ void gdata_contacts_contact_remove_all_organizations (GDataContactsContact *self) { @@ -2339,7 +2339,7 @@ gdata_contacts_contact_remove_all_organizations (GDataContactsContact *self) * Duplicate jots will be added to the list, and multiple jots with the same relation type can be added to a single contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_jot (GDataContactsContact *self, GDataGContactJot *jot) { @@ -2358,7 +2358,7 @@ gdata_contacts_contact_add_jot (GDataContactsContact *self, GDataGContactJot *jo * Return value: (element-type GData.GContactJot) (transfer none): a #GList of #GDataGContactJot<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_jots (GDataContactsContact *self) { @@ -2373,7 +2373,7 @@ gdata_contacts_contact_get_jots (GDataContactsContact *self) * Removes all jots from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_jots (GDataContactsContact *self) { @@ -2399,7 +2399,7 @@ gdata_contacts_contact_remove_all_jots (GDataContactsContact *self) * Though it may not make sense for some relation types to be repeated, adding them is allowed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_relation (GDataContactsContact *self, GDataGContactRelation *relation) { @@ -2418,7 +2418,7 @@ gdata_contacts_contact_add_relation (GDataContactsContact *self, GDataGContactRe * Return value: (element-type GData.GContactRelation) (transfer none): a #GList of #GDataGContactRelation<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_relations (GDataContactsContact *self) { @@ -2433,7 +2433,7 @@ gdata_contacts_contact_get_relations (GDataContactsContact *self) * Removes all relations from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_relations (GDataContactsContact *self) { @@ -2459,7 +2459,7 @@ gdata_contacts_contact_remove_all_relations (GDataContactsContact *self) * relation types or labels. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_website (GDataContactsContact *self, GDataGContactWebsite *website) { @@ -2479,7 +2479,7 @@ gdata_contacts_contact_add_website (GDataContactsContact *self, GDataGContactWeb * Return value: (element-type GData.GContactWebsite) (transfer none): a #GList of #GDataGContactWebsite<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_websites (GDataContactsContact *self) { @@ -2496,7 +2496,7 @@ gdata_contacts_contact_get_websites (GDataContactsContact *self) * Return value: (transfer none): a #GDataGContactWebsite, or %NULL * * Since: 0.7.0 - **/ + */ GDataGContactWebsite * gdata_contacts_contact_get_primary_website (GDataContactsContact *self) { @@ -2519,7 +2519,7 @@ gdata_contacts_contact_get_primary_website (GDataContactsContact *self) * Removes all websites from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_websites (GDataContactsContact *self) { @@ -2545,7 +2545,7 @@ gdata_contacts_contact_remove_all_websites (GDataContactsContact *self) * Though it may not make sense for some event types to be repeated, adding them is allowed. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_event (GDataContactsContact *self, GDataGContactEvent *event) { @@ -2564,7 +2564,7 @@ gdata_contacts_contact_add_event (GDataContactsContact *self, GDataGContactEvent * Return value: (element-type GData.GContactEvent) (transfer none): a #GList of #GDataGContactEvent<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_events (GDataContactsContact *self) { @@ -2579,7 +2579,7 @@ gdata_contacts_contact_get_events (GDataContactsContact *self) * Removes all events from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_events (GDataContactsContact *self) { @@ -2605,7 +2605,7 @@ gdata_contacts_contact_remove_all_events (GDataContactsContact *self) * relation types or labels. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_calendar (GDataContactsContact *self, GDataGContactCalendar *calendar) { @@ -2625,7 +2625,7 @@ gdata_contacts_contact_add_calendar (GDataContactsContact *self, GDataGContactCa * Return value: (element-type GData.GContactCalendar) (transfer none): a #GList of #GDataGContactCalendar<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_calendars (GDataContactsContact *self) { @@ -2642,7 +2642,7 @@ gdata_contacts_contact_get_calendars (GDataContactsContact *self) * Return value: (transfer none): a #GDataGContactCalendar, or %NULL * * Since: 0.7.0 - **/ + */ GDataGContactCalendar * gdata_contacts_contact_get_primary_calendar (GDataContactsContact *self) { @@ -2665,7 +2665,7 @@ gdata_contacts_contact_get_primary_calendar (GDataContactsContact *self) * Removes all calendars from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_calendars (GDataContactsContact *self) { @@ -2690,7 +2690,7 @@ gdata_contacts_contact_remove_all_calendars (GDataContactsContact *self) * Duplicate IDs will not be added to the list. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_external_id (GDataContactsContact *self, GDataGContactExternalID *external_id) { @@ -2710,7 +2710,7 @@ gdata_contacts_contact_add_external_id (GDataContactsContact *self, GDataGContac * Return value: (element-type GData.GContactExternalID) (transfer none): a #GList of #GDataGContactExternalID<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_external_ids (GDataContactsContact *self) { @@ -2725,7 +2725,7 @@ gdata_contacts_contact_get_external_ids (GDataContactsContact *self) * Removes all external IDs from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_external_ids (GDataContactsContact *self) { @@ -2750,7 +2750,7 @@ gdata_contacts_contact_remove_all_external_ids (GDataContactsContact *self) * Duplicate hobbies will not be added to the list. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_hobby (GDataContactsContact *self, const gchar *hobby) { @@ -2770,7 +2770,7 @@ gdata_contacts_contact_add_hobby (GDataContactsContact *self, const gchar *hobby * Return value: (element-type utf8) (transfer none): a #GList of hobby strings, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_hobbies (GDataContactsContact *self) { @@ -2785,7 +2785,7 @@ gdata_contacts_contact_get_hobbies (GDataContactsContact *self) * Removes all hobbies from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_hobbies (GDataContactsContact *self) { @@ -2810,7 +2810,7 @@ gdata_contacts_contact_remove_all_hobbies (GDataContactsContact *self) * Duplicate languages will not be added to the list. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_add_language (GDataContactsContact *self, GDataGContactLanguage *language) { @@ -2830,7 +2830,7 @@ gdata_contacts_contact_add_language (GDataContactsContact *self, GDataGContactLa * Return value: (element-type GData.GContactLanguage) (transfer none): a #GList of #GDataGContactLanguage<!-- -->s, or %NULL * * Since: 0.7.0 - **/ + */ GList * gdata_contacts_contact_get_languages (GDataContactsContact *self) { @@ -2845,7 +2845,7 @@ gdata_contacts_contact_get_languages (GDataContactsContact *self) * Removes all languages from the contact. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_remove_all_languages (GDataContactsContact *self) { @@ -2871,7 +2871,7 @@ gdata_contacts_contact_remove_all_languages (GDataContactsContact *self) * Return value: the property's value, or %NULL * * Since: 0.2.0 - **/ + */ const gchar * gdata_contacts_contact_get_extended_property (GDataContactsContact *self, const gchar *name) { @@ -2889,7 +2889,7 @@ gdata_contacts_contact_get_extended_property (GDataContactsContact *self, const * Return value: (transfer none): a #GHashTable of extended properties * * Since: 0.4.0 - **/ + */ GHashTable * gdata_contacts_contact_get_extended_properties (GDataContactsContact *self) { @@ -2916,7 +2916,7 @@ gdata_contacts_contact_get_extended_properties (GDataContactsContact *self) * Return value: %TRUE if the property was updated or deleted successfully, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_contacts_contact_set_extended_property (GDataContactsContact *self, const gchar *name, const gchar *value) { @@ -2955,7 +2955,7 @@ gdata_contacts_contact_set_extended_property (GDataContactsContact *self, const * Return value: the field's value, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_contact_get_user_defined_field (GDataContactsContact *self, const gchar *name) { @@ -2973,7 +2973,7 @@ gdata_contacts_contact_get_user_defined_field (GDataContactsContact *self, const * Return value: (transfer none): a #GHashTable of user-defined fields * * Since: 0.7.0 - **/ + */ GHashTable * gdata_contacts_contact_get_user_defined_fields (GDataContactsContact *self) { @@ -2995,7 +2995,7 @@ gdata_contacts_contact_get_user_defined_fields (GDataContactsContact *self) * To unset a field, set @value to %NULL. * * Since: 0.7.0 - **/ + */ void gdata_contacts_contact_set_user_defined_field (GDataContactsContact *self, const gchar *name, const gchar *value) { @@ -3019,7 +3019,7 @@ gdata_contacts_contact_set_user_defined_field (GDataContactsContact *self, const * Adds the contact to the given group. @href should be a URI. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_add_group (GDataContactsContact *self, const gchar *href) { @@ -3036,7 +3036,7 @@ gdata_contacts_contact_add_group (GDataContactsContact *self, const gchar *href) * Removes the contact from the given group. @href should be a URI. * * Since: 0.2.0 - **/ + */ void gdata_contacts_contact_remove_group (GDataContactsContact *self, const gchar *href) { @@ -3060,7 +3060,7 @@ gdata_contacts_contact_remove_group (GDataContactsContact *self, const gchar *hr * Return value: %TRUE if the contact has recently been removed from the group, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_contacts_contact_is_group_deleted (GDataContactsContact *self, const gchar *href) { @@ -3078,7 +3078,7 @@ gdata_contacts_contact_is_group_deleted (GDataContactsContact *self, const gchar * 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 - **/ + */ GList * gdata_contacts_contact_get_groups (GDataContactsContact *self) { @@ -3116,7 +3116,7 @@ gdata_contacts_contact_get_groups (GDataContactsContact *self) * Return value: %TRUE if the contact has been deleted, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_contacts_contact_is_deleted (GDataContactsContact *self) { @@ -3135,7 +3135,7 @@ gdata_contacts_contact_is_deleted (GDataContactsContact *self) * Return value: the contact's photo's ETag if it exists, %NULL otherwise * * Since: 0.9.0 - **/ + */ const gchar * gdata_contacts_contact_get_photo_etag (GDataContactsContact *self) { @@ -3164,7 +3164,7 @@ gdata_contacts_contact_get_photo_etag (GDataContactsContact *self) * Return value: (transfer full) (array length=length): the image data, or %NULL; free with g_free() * * Since: 0.8.0 - **/ + */ guint8 * gdata_contacts_contact_get_photo (GDataContactsContact *self, GDataContactsService *service, gsize *length, gchar **content_type, GCancellable *cancellable, GError **error) @@ -3286,7 +3286,7 @@ get_photo_thread (GSimpleAsyncResult *result, GDataContactsContact *contact, GCa * If there is an error getting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned by gdata_contacts_contact_get_photo_finish(). * * Since: 0.8.0 - **/ + */ void gdata_contacts_contact_get_photo_async (GDataContactsContact *self, GDataContactsService *service, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -3321,7 +3321,7 @@ gdata_contacts_contact_get_photo_async (GDataContactsContact *self, GDataContact * Return value: (transfer full) (array length=length): the image data, or %NULL; free with g_free() * * Since: 0.8.0 - **/ + */ guint8 * gdata_contacts_contact_get_photo_finish (GDataContactsContact *self, GAsyncResult *async_result, gsize *length, gchar **content_type, GError **error) { @@ -3380,7 +3380,7 @@ gdata_contacts_contact_get_photo_finish (GDataContactsContact *self, GAsyncResul * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.8.0 - **/ + */ gboolean gdata_contacts_contact_set_photo (GDataContactsContact *self, GDataContactsService *service, const guint8 *data, gsize length, const gchar *content_type, GCancellable *cancellable, GError **error) @@ -3492,7 +3492,7 @@ set_photo_thread (GSimpleAsyncResult *result, GDataContactsContact *contact, GCa * If there is an error setting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned by gdata_contacts_contact_set_photo_finish(). * * Since: 0.8.0 - **/ + */ void gdata_contacts_contact_set_photo_async (GDataContactsContact *self, GDataContactsService *service, const guint8 *data, gsize length, const gchar *content_type, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -3531,7 +3531,7 @@ gdata_contacts_contact_set_photo_async (GDataContactsContact *self, GDataContact * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.8.0 - **/ + */ gboolean gdata_contacts_contact_set_photo_finish (GDataContactsContact *self, GAsyncResult *async_result, GError **error) { diff --git a/gdata/services/contacts/gdata-contacts-contact.h b/gdata/services/contacts/gdata-contacts-contact.h index ebc73d3d..b84daa73 100644 --- a/gdata/services/contacts/gdata-contacts-contact.h +++ b/gdata/services/contacts/gdata-contacts-contact.h @@ -46,7 +46,7 @@ G_BEGIN_DECLS * The contact is male. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_GENDER_MALE "male" /** @@ -55,7 +55,7 @@ G_BEGIN_DECLS * The contact is female. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_GENDER_FEMALE "female" /** @@ -64,7 +64,7 @@ G_BEGIN_DECLS * The contact is of low importance. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_PRIORITY_LOW "low" /** @@ -73,7 +73,7 @@ G_BEGIN_DECLS * The contact is of normal importance. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_PRIORITY_NORMAL "normal" /** @@ -82,7 +82,7 @@ G_BEGIN_DECLS * The contact is of high importance. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_PRIORITY_HIGH "high" /** @@ -91,7 +91,7 @@ G_BEGIN_DECLS * The contact's data is confidential. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_SENSITIVITY_CONFIDENTIAL "confidential" /** @@ -100,7 +100,7 @@ G_BEGIN_DECLS * The contact's data is of normal sensitivity. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_SENSITIVITY_NORMAL "normal" /** @@ -109,7 +109,7 @@ G_BEGIN_DECLS * The contact's data is personal. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_SENSITIVITY_PERSONAL "personal" /** @@ -118,7 +118,7 @@ G_BEGIN_DECLS * The contact's data is private. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_SENSITIVITY_PRIVATE "private" #define GDATA_TYPE_CONTACTS_CONTACT (gdata_contacts_contact_get_type ()) @@ -136,7 +136,7 @@ typedef struct _GDataContactsContactPrivate GDataContactsContactPrivate; * All the fields in the #GDataContactsContact structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataEntry parent; GDataContactsContactPrivate *priv; @@ -148,7 +148,7 @@ typedef struct { * All the fields in the #GDataContactsContactClass structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/contacts/gdata-contacts-group.c b/gdata/services/contacts/gdata-contacts-group.c index 90522033..d8ab4a46 100644 --- a/gdata/services/contacts/gdata-contacts-group.c +++ b/gdata/services/contacts/gdata-contacts-group.c @@ -90,7 +90,7 @@ * </example> * * Since: 0.7.0 - **/ + */ #include <config.h> #include <glib.h> @@ -161,7 +161,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * Atom Publishing Protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The last time the group was edited.", @@ -174,7 +174,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * Whether the entry has been deleted. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DELETED, g_param_spec_boolean ("deleted", "Deleted", "Whether the entry has been deleted.", @@ -194,7 +194,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * group ID. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SYSTEM_GROUP_ID, g_param_spec_string ("system-group-id", "System group ID", "The system group ID for this group, if it's a system group.", @@ -458,7 +458,7 @@ get_entry_uri (const gchar *id) * Return value: a new #GDataContactsGroup; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataContactsGroup * gdata_contacts_group_new (const gchar *id) { @@ -474,7 +474,7 @@ gdata_contacts_group_new (const gchar *id) * Return value: the UNIX timestamp for the time the file was last edited, or <code class="literal">-1</code> * * Since: 0.7.0 - **/ + */ gint64 gdata_contacts_group_get_edited (GDataContactsGroup *self) { @@ -491,7 +491,7 @@ gdata_contacts_group_get_edited (GDataContactsGroup *self) * Return value: the group's system group ID, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_group_get_system_group_id (GDataContactsGroup *self) { @@ -510,7 +510,7 @@ gdata_contacts_group_get_system_group_id (GDataContactsGroup *self) * Return value: the property's value, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_contacts_group_get_extended_property (GDataContactsGroup *self, const gchar *name) { @@ -528,7 +528,7 @@ gdata_contacts_group_get_extended_property (GDataContactsGroup *self, const gcha * Return value: (transfer none): a #GHashTable of extended properties * * Since: 0.7.0 - **/ + */ GHashTable * gdata_contacts_group_get_extended_properties (GDataContactsGroup *self) { @@ -554,7 +554,7 @@ gdata_contacts_group_get_extended_properties (GDataContactsGroup *self) * Return value: %TRUE if the property was updated or deleted successfully, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gboolean gdata_contacts_group_set_extended_property (GDataContactsGroup *self, const gchar *name, const gchar *value) { @@ -592,7 +592,7 @@ gdata_contacts_group_set_extended_property (GDataContactsGroup *self, const gcha * Return value: %TRUE if the group has been deleted, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gboolean gdata_contacts_group_is_deleted (GDataContactsGroup *self) { diff --git a/gdata/services/contacts/gdata-contacts-group.h b/gdata/services/contacts/gdata-contacts-group.h index 7b019edb..b8deaed4 100644 --- a/gdata/services/contacts/gdata-contacts-group.h +++ b/gdata/services/contacts/gdata-contacts-group.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The system group ID for the "My Contacts" system group. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_GROUP_CONTACTS "Contacts" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The system group ID for the "Friends" system group. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_GROUP_FRIENDS "Friends" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The system group ID for the "Family" system group. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_GROUP_FAMILY "Family" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * The system group ID for the "Coworkers" system group. * * Since: 0.7.0 - **/ + */ #define GDATA_CONTACTS_GROUP_COWORKERS "Coworkers" #define GDATA_TYPE_CONTACTS_GROUP (gdata_contacts_group_get_type ()) @@ -78,7 +78,7 @@ typedef struct _GDataContactsGroupPrivate GDataContactsGroupPrivate; * All the fields in the #GDataContactsGroup structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataEntry parent; GDataContactsGroupPrivate *priv; @@ -90,7 +90,7 @@ typedef struct { * All the fields in the #GDataContactsGroupClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/contacts/gdata-contacts-query.c b/gdata/services/contacts/gdata-contacts-query.c index 5156882d..23f40bbf 100644 --- a/gdata/services/contacts/gdata-contacts-query.c +++ b/gdata/services/contacts/gdata-contacts-query.c @@ -75,7 +75,7 @@ * </example> * * Since: 0.2.0 - **/ + */ #include <config.h> #include <glib.h> @@ -126,7 +126,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * Sorting criterion. The only supported value is <literal>lastmodified</literal>. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ORDER_BY, g_param_spec_string ("order-by", "Order by", "Sorting criterion.", @@ -141,7 +141,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * normally appear in query results. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SHOW_DELETED, g_param_spec_boolean ("show-deleted", "Show deleted?", "Whether to include deleted contacts in the query feed.", @@ -154,7 +154,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * Sorting order direction. Can be either <literal>ascending</literal> or <literal>descending</literal>. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SORT_ORDER, g_param_spec_string ("sort-order", "Sort order", "Sorting order direction.", @@ -168,7 +168,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * should be a group ID URI. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_GROUP, g_param_spec_string ("group", "Group", "Constrains the results to only those belonging to the group specified.", @@ -289,7 +289,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Return value: a new #GDataContactsQuery * * Since: 0.2.0 - **/ + */ GDataContactsQuery * gdata_contacts_query_new (const gchar *q) { @@ -308,7 +308,7 @@ gdata_contacts_query_new (const gchar *q) * Return value: a new #GDataContactsQuery * * Since: 0.2.0 - **/ + */ GDataContactsQuery * gdata_contacts_query_new_with_limits (const gchar *q, guint start_index, guint max_results) { @@ -328,7 +328,7 @@ gdata_contacts_query_new_with_limits (const gchar *q, guint start_index, guint m * Return value: the order by property, or %NULL if it is unset * * Since: 0.2.0 - **/ + */ const gchar * gdata_contacts_query_get_order_by (GDataContactsQuery *self) { @@ -346,7 +346,7 @@ gdata_contacts_query_get_order_by (GDataContactsQuery *self) * Set @order_by to %NULL to unset the property in the query URI. * * Since: 0.2.0 - **/ + */ void gdata_contacts_query_set_order_by (GDataContactsQuery *self, const gchar *order_by) { @@ -369,7 +369,7 @@ gdata_contacts_query_set_order_by (GDataContactsQuery *self, const gchar *order_ * Return value: %TRUE if deleted contacts should be shown, %FALSE otherwise * * Since: 0.2.0 - **/ + */ gboolean gdata_contacts_query_show_deleted (GDataContactsQuery *self) { @@ -385,7 +385,7 @@ gdata_contacts_query_show_deleted (GDataContactsQuery *self) * Sets the #GDataContactsQuery:show-deleted property of the #GDataContactsQuery. * * Since: 0.2.0 - **/ + */ void gdata_contacts_query_set_show_deleted (GDataContactsQuery *self, gboolean show_deleted) { @@ -406,7 +406,7 @@ gdata_contacts_query_set_show_deleted (GDataContactsQuery *self, gboolean show_d * Return value: the sort order property, or %NULL if it is unset * * Since: 0.2.0 - **/ + */ const gchar * gdata_contacts_query_get_sort_order (GDataContactsQuery *self) { @@ -424,7 +424,7 @@ gdata_contacts_query_get_sort_order (GDataContactsQuery *self) * Set @sort_order to %NULL to unset the property in the query URI. * * Since: 0.2.0 - **/ + */ void gdata_contacts_query_set_sort_order (GDataContactsQuery *self, const gchar *sort_order) { @@ -447,7 +447,7 @@ gdata_contacts_query_set_sort_order (GDataContactsQuery *self, const gchar *sort * Return value: the group property, or %NULL if it is unset * * Since: 0.2.0 - **/ + */ const gchar * gdata_contacts_query_get_group (GDataContactsQuery *self) { @@ -465,7 +465,7 @@ gdata_contacts_query_get_group (GDataContactsQuery *self) * Set @group to %NULL to unset the property in the query URI. * * Since: 0.2.0 - **/ + */ void gdata_contacts_query_set_group (GDataContactsQuery *self, const gchar *group) { diff --git a/gdata/services/contacts/gdata-contacts-query.h b/gdata/services/contacts/gdata-contacts-query.h index f95d2ff5..f2156458 100644 --- a/gdata/services/contacts/gdata-contacts-query.h +++ b/gdata/services/contacts/gdata-contacts-query.h @@ -42,7 +42,7 @@ typedef struct _GDataContactsQueryPrivate GDataContactsQueryPrivate; * All the fields in the #GDataContactsQuery structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataQuery parent; GDataContactsQueryPrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataContactsQueryClass structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { /*< private >*/ GDataQueryClass parent; diff --git a/gdata/services/contacts/gdata-contacts-service.c b/gdata/services/contacts/gdata-contacts-service.c index 8fe77806..577c4747 100644 --- a/gdata/services/contacts/gdata-contacts-service.c +++ b/gdata/services/contacts/gdata-contacts-service.c @@ -143,7 +143,7 @@ * </example> * * Since: 0.2.0 - **/ + */ #include <config.h> #include <glib.h> @@ -238,7 +238,7 @@ gdata_contacts_service_get_primary_authorization_domain (void) * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataFeed * gdata_contacts_service_query_contacts (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -286,7 +286,7 @@ gdata_contacts_service_query_contacts (GDataContactsService *self, GDataQuery *q * and gdata_service_query_async(), which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_contacts_service_query_contacts_async (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -333,7 +333,7 @@ gdata_contacts_service_query_contacts_async (GDataContactsService *self, GDataQu * Return value: (transfer full): an updated #GDataContactsContact, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataContactsContact * gdata_contacts_service_insert_contact (GDataContactsService *self, GDataContactsContact *contact, GCancellable *cancellable, GError **error) { @@ -371,7 +371,7 @@ gdata_contacts_service_insert_contact (GDataContactsService *self, GDataContacts * and gdata_service_insert_entry_async(), which is the base asynchronous insertion function. * * Since: 0.7.0 - **/ + */ void gdata_contacts_service_insert_contact_async (GDataContactsService *self, GDataContactsContact *contact, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -404,7 +404,7 @@ gdata_contacts_service_insert_contact_async (GDataContactsService *self, GDataCo * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataFeed * gdata_contacts_service_query_groups (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -452,7 +452,7 @@ gdata_contacts_service_query_groups (GDataContactsService *self, GDataQuery *que * which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_contacts_service_query_groups_async (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -497,7 +497,7 @@ gdata_contacts_service_query_groups_async (GDataContactsService *self, GDataQuer * Return value: (transfer full): the inserted #GDataContactsGroup; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataContactsGroup * gdata_contacts_service_insert_group (GDataContactsService *self, GDataContactsGroup *group, GCancellable *cancellable, GError **error) { @@ -548,7 +548,7 @@ gdata_contacts_service_insert_group (GDataContactsService *self, GDataContactsGr * gdata_service_insert_entry_async(), which is the base asynchronous insertion function. * * Since: 0.7.0 - **/ + */ void gdata_contacts_service_insert_group_async (GDataContactsService *self, GDataContactsGroup *group, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) diff --git a/gdata/services/contacts/gdata-contacts-service.h b/gdata/services/contacts/gdata-contacts-service.h index d6f308a4..100e38df 100644 --- a/gdata/services/contacts/gdata-contacts-service.h +++ b/gdata/services/contacts/gdata-contacts-service.h @@ -43,7 +43,7 @@ typedef struct _GDataContactsServicePrivate GDataContactsServicePrivate; * All the fields in the #GDataContactsService structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataService parent; } GDataContactsService; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataContactsServiceClass structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { /*< private >*/ GDataServiceClass parent; diff --git a/gdata/services/documents/gdata-documents-document.c b/gdata/services/documents/gdata-documents-document.c index dbd825e6..b2175795 100644 --- a/gdata/services/documents/gdata-documents-document.c +++ b/gdata/services/documents/gdata-documents-document.c @@ -194,7 +194,7 @@ * </example> * * Since: 0.7.0 - **/ + */ #include <config.h> #include <glib.h> @@ -364,7 +364,7 @@ gdata_documents_document_new (const gchar *id) * Return value: (transfer full): a #GDataDownloadStream to download the document with, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDownloadStream * gdata_documents_document_download (GDataDocumentsDocument *self, GDataDocumentsService *service, const gchar *export_format, GCancellable *cancellable, GError **error) @@ -425,7 +425,7 @@ gdata_documents_document_download (GDataDocumentsDocument *self, GDataDocumentsS * Return value: (nullable): the download URI, or %NULL; free with g_free() * * Since: 0.7.0 - **/ + */ gchar * gdata_documents_document_get_download_uri (GDataDocumentsDocument *self, const gchar *export_format) { diff --git a/gdata/services/documents/gdata-documents-document.h b/gdata/services/documents/gdata-documents-document.h index e0d00657..24c92912 100644 --- a/gdata/services/documents/gdata-documents-document.h +++ b/gdata/services/documents/gdata-documents-document.h @@ -43,7 +43,7 @@ typedef struct _GDataDocumentsDocumentPrivate GDataDocumentsDocumentPrivate; * All the fields in the #GDataDocumentsDocument structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataDocumentsEntry parent; GDataDocumentsDocumentPrivate *priv; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataDocumentsDocumentClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsEntryClass parent; diff --git a/gdata/services/documents/gdata-documents-drawing.c b/gdata/services/documents/gdata-documents-drawing.c index 33c1a9f4..8b224fee 100644 --- a/gdata/services/documents/gdata-documents-drawing.c +++ b/gdata/services/documents/gdata-documents-drawing.c @@ -32,7 +32,7 @@ * <ulink type="http" url="https://developers.google.com/google-apps/documents-list/">online documentation</ulink>. * * Since: 0.13.1 - **/ + */ #include <config.h> #include <glib.h> @@ -80,7 +80,7 @@ gdata_documents_drawing_constructed (GObject *object) * Return value: (transfer full): a new #GDataDocumentsDrawing, or %NULL; unref with g_object_unref() * * Since: 0.13.1 - **/ + */ GDataDocumentsDrawing * gdata_documents_drawing_new (const gchar *id) { diff --git a/gdata/services/documents/gdata-documents-drawing.h b/gdata/services/documents/gdata-documents-drawing.h index e2c13fb6..27441e80 100644 --- a/gdata/services/documents/gdata-documents-drawing.h +++ b/gdata/services/documents/gdata-documents-drawing.h @@ -52,7 +52,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.13.1 - **/ + */ #define GDATA_DOCUMENTS_DRAWING_PDF "pdf" /** @@ -65,7 +65,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.13.1 - **/ + */ #define GDATA_DOCUMENTS_DRAWING_PNG "png" /** @@ -78,7 +78,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.13.1 - **/ + */ #define GDATA_DOCUMENTS_DRAWING_SVG "svg" @@ -97,7 +97,7 @@ typedef struct _GDataDocumentsDrawingPrivate GDataDocumentsDrawingPrivate; * All the fields in the #GDataDocumentsDrawing structure are private and should never be accessed directly. * * Since: 0.13.1 - **/ + */ typedef struct { GDataDocumentsDocument parent; GDataDocumentsDrawingPrivate *priv; @@ -109,7 +109,7 @@ typedef struct { * All the fields in the #GDataDocumentsDrawingClass structure are private and should never be accessed directly. * * Since: 0.13.1 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsDocumentClass parent; diff --git a/gdata/services/documents/gdata-documents-entry.c b/gdata/services/documents/gdata-documents-entry.c index 56a5daaf..16d580c6 100644 --- a/gdata/services/documents/gdata-documents-entry.c +++ b/gdata/services/documents/gdata-documents-entry.c @@ -92,7 +92,7 @@ * </example> * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -179,7 +179,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass) * * Since: 0.4.0 * Deprecated: 0.17.0: This is identical to #GDataEntry:updated. - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The last time the document was edited.", @@ -192,7 +192,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass) * The last time the document was viewed. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LAST_VIEWED, g_param_spec_int64 ("last-viewed", "Last viewed", "The last time the document was viewed.", @@ -205,7 +205,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass) * Indicates whether the document entry writers can invite others to edit the document. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_WRITERS_CAN_INVITE, g_param_spec_boolean ("writers-can-invite", "Writers can invite?", "Indicates whether writers can invite others to edit.", @@ -219,7 +219,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass) * appear in query results if the #GDataDocumentsQuery:show-deleted property is %TRUE. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_DELETED, g_param_spec_boolean ("is-deleted", "Deleted?", "Indicates whether the document entry has been deleted.", @@ -258,7 +258,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass) * * Since: 0.4.0 * Deprecated: 0.11.0: This a substring of the #GDataDocumentsEntry:resource-id, which is more general and should be used instead. - **/ + */ g_object_class_install_property (gobject_class, PROP_DOCUMENT_ID, g_param_spec_string ("document-id", "Document ID", "The document ID of the document.", @@ -271,7 +271,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass) * Indicates the author of the last modification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LAST_MODIFIED_BY, g_param_spec_object ("last-modified-by", "Last modified by", "Indicates the author of the last modification.", @@ -921,7 +921,7 @@ get_entry_uri (const gchar *id) * * Since: 0.4.0 * Deprecated: 0.17.0: Use gdata_entry_get_updated() instead. See #GDataDocumentsEntry:edited. - **/ + */ gint64 gdata_documents_entry_get_edited (GDataDocumentsEntry *self) { @@ -938,7 +938,7 @@ gdata_documents_entry_get_edited (GDataDocumentsEntry *self) * Return value: the UNIX timestamp for the time the document was last viewed, or <code class="literal">-1</code> * * Since: 0.4.0 - **/ + */ gint64 gdata_documents_entry_get_last_viewed (GDataDocumentsEntry *self) { @@ -961,7 +961,7 @@ gdata_documents_entry_get_last_viewed (GDataDocumentsEntry *self) * Return value: the folder hierarchy path containing the document, or %NULL; free with g_free() * * Since: 0.4.0 - **/ + */ gchar * gdata_documents_entry_get_path (GDataDocumentsEntry *self) { @@ -1027,7 +1027,7 @@ gdata_documents_entry_get_path (GDataDocumentsEntry *self) * * Since: 0.4.0 * Deprecated: 0.11.0: Use gdata_documents_entry_get_resource_id() instead. See #GDataDocumentsEntry:document-id. - **/ + */ const gchar * gdata_documents_entry_get_document_id (GDataDocumentsEntry *self ) { @@ -1060,7 +1060,7 @@ gdata_documents_entry_get_resource_id (GDataDocumentsEntry *self) * Sets the #GDataDocumentsEntry:writers-can-invite property to @writers_can_invite. * * Since: 0.4.0 - **/ + */ void gdata_documents_entry_set_writers_can_invite (GDataDocumentsEntry *self, gboolean writers_can_invite) { @@ -1078,7 +1078,7 @@ gdata_documents_entry_set_writers_can_invite (GDataDocumentsEntry *self, gboolea * Return value: %TRUE if writers can invite other people to edit the document, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_documents_entry_writers_can_invite (GDataDocumentsEntry *self) { @@ -1095,7 +1095,7 @@ gdata_documents_entry_writers_can_invite (GDataDocumentsEntry *self) * Return value: (transfer none): the author who last modified the document * * Since: 0.4.0 - **/ + */ GDataAuthor * gdata_documents_entry_get_last_modified_by (GDataDocumentsEntry *self) { @@ -1148,7 +1148,7 @@ gdata_documents_entry_get_file_size (GDataDocumentsEntry *self) * Return value: %TRUE if the document has been deleted, %FALSE otherwise * * Since: 0.5.0 - **/ + */ gboolean gdata_documents_entry_is_deleted (GDataDocumentsEntry *self) { diff --git a/gdata/services/documents/gdata-documents-entry.h b/gdata/services/documents/gdata-documents-entry.h index dfb38df4..c8731e96 100644 --- a/gdata/services/documents/gdata-documents-entry.h +++ b/gdata/services/documents/gdata-documents-entry.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * the document, amongst other things. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_ACCESS_ROLE_OWNER "owner" /** @@ -45,7 +45,7 @@ G_BEGIN_DECLS * The users specified by the #GDataAccessRule have write access to the document. They cannot modify the access rules or delete the document. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_ACCESS_ROLE_WRITER "writer" /** @@ -54,7 +54,7 @@ G_BEGIN_DECLS * The users specified by the #GDataAccessRule have read-only access to the document. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_ACCESS_ROLE_READER "reader" #define GDATA_TYPE_DOCUMENTS_ENTRY (gdata_documents_entry_get_type ()) @@ -72,7 +72,7 @@ typedef struct _GDataDocumentsEntryPrivate GDataDocumentsEntryPrivate; * All the fields in the #GDataDocumentsEntry structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataEntry parent; GDataDocumentsEntryPrivate *priv; @@ -84,7 +84,7 @@ typedef struct { * All the fields in the #GDataDocumentsEntryClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/documents/gdata-documents-feed.c b/gdata/services/documents/gdata-documents-feed.c index 98210c42..91100d51 100644 --- a/gdata/services/documents/gdata-documents-feed.c +++ b/gdata/services/documents/gdata-documents-feed.c @@ -32,7 +32,7 @@ * spreadsheet document or a folder, and the #GDataDocumentsFeed represents a collection of those objects. * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> diff --git a/gdata/services/documents/gdata-documents-feed.h b/gdata/services/documents/gdata-documents-feed.h index df6eceac..134f3752 100644 --- a/gdata/services/documents/gdata-documents-feed.h +++ b/gdata/services/documents/gdata-documents-feed.h @@ -41,7 +41,7 @@ typedef struct _GDataDocumentsFeedPrivate GDataDocumentsFeedPrivate; * All the fields in the #GDataDocumentsFeed structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataFeed parent; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataDocumentsFeedClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataFeedClass parent; diff --git a/gdata/services/documents/gdata-documents-folder.c b/gdata/services/documents/gdata-documents-folder.c index 1ae9bfe1..ed475031 100644 --- a/gdata/services/documents/gdata-documents-folder.c +++ b/gdata/services/documents/gdata-documents-folder.c @@ -76,7 +76,7 @@ * </example> * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -128,7 +128,7 @@ gdata_documents_folder_constructed (GObject *object) * Return value: a new #GDataDocumentsFolder, or %NULL; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataDocumentsFolder * gdata_documents_folder_new (const gchar *id) { diff --git a/gdata/services/documents/gdata-documents-folder.h b/gdata/services/documents/gdata-documents-folder.h index f79e5fd9..9dc782ba 100644 --- a/gdata/services/documents/gdata-documents-folder.h +++ b/gdata/services/documents/gdata-documents-folder.h @@ -43,7 +43,7 @@ typedef struct _GDataDocumentsFolderPrivate GDataDocumentsFolderPrivate; * All the fields in the #GDataDocumentsFolder structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataDocumentsEntry parent; GDataDocumentsFolderPrivate *priv; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataDocumentsFolderClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsEntryClass parent; diff --git a/gdata/services/documents/gdata-documents-pdf.c b/gdata/services/documents/gdata-documents-pdf.c index fd55fc8b..8a7d6734 100644 --- a/gdata/services/documents/gdata-documents-pdf.c +++ b/gdata/services/documents/gdata-documents-pdf.c @@ -32,7 +32,7 @@ * <ulink type="http" url="https://developers.google.com/google-apps/documents-list/">online documentation</ulink>. * * Since: 0.13.3 - **/ + */ #include <config.h> #include <glib.h> @@ -80,7 +80,7 @@ gdata_documents_pdf_constructed (GObject *object) * Return value: (transfer full): a new #GDataDocumentsPdf, or %NULL; unref with g_object_unref() * * Since: 0.13.3 - **/ + */ GDataDocumentsPdf * gdata_documents_pdf_new (const gchar *id) { diff --git a/gdata/services/documents/gdata-documents-pdf.h b/gdata/services/documents/gdata-documents-pdf.h index e92ff7e7..aa43b8da 100644 --- a/gdata/services/documents/gdata-documents-pdf.h +++ b/gdata/services/documents/gdata-documents-pdf.h @@ -44,7 +44,7 @@ typedef struct _GDataDocumentsPdfPrivate GDataDocumentsPdfPrivate; * All the fields in the #GDataDocumentsPdf structure are private and should never be accessed directly. * * Since: 0.13.3 - **/ + */ typedef struct { GDataDocumentsDocument parent; GDataDocumentsPdfPrivate *priv; @@ -56,7 +56,7 @@ typedef struct { * All the fields in the #GDataDocumentsPdfClass structure are private and should never be accessed directly. * * Since: 0.13.3 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsDocumentClass parent; diff --git a/gdata/services/documents/gdata-documents-presentation.c b/gdata/services/documents/gdata-documents-presentation.c index e252d2c6..1121d2d2 100644 --- a/gdata/services/documents/gdata-documents-presentation.c +++ b/gdata/services/documents/gdata-documents-presentation.c @@ -31,7 +31,7 @@ * <ulink type="http" url="https://developers.google.com/google-apps/documents-list/">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -79,7 +79,7 @@ gdata_documents_presentation_constructed (GObject *object) * Return value: (transfer full): a new #GDataDocumentsPresentation, or %NULL; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataDocumentsPresentation * gdata_documents_presentation_new (const gchar *id) { diff --git a/gdata/services/documents/gdata-documents-presentation.h b/gdata/services/documents/gdata-documents-presentation.h index e18607b4..ba7e283f 100644 --- a/gdata/services/documents/gdata-documents-presentation.h +++ b/gdata/services/documents/gdata-documents-presentation.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_PRESENTATION_PDF "pdf" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_PRESENTATION_PNG "png" /** @@ -63,7 +63,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_PRESENTATION_PPT "ppt" /** @@ -78,7 +78,7 @@ G_BEGIN_DECLS * Since: 0.7.0 * Deprecated: SWF export has been deprecated in the protocol due to low demand for it; PDF export (using %GDATA_DOCUMENTS_PRESENTATION_PDF) is * recommended instead. (Since: 0.11.0.) - **/ + */ #ifndef LIBGDATA_DISABLE_DEPRECATED #define GDATA_DOCUMENTS_PRESENTATION_SWF "swf" #endif /* !LIBGDATA_DISABLE_DEPRECATED */ @@ -93,7 +93,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_PRESENTATION_TXT "txt" #define GDATA_TYPE_DOCUMENTS_PRESENTATION (gdata_documents_presentation_get_type ()) @@ -114,7 +114,7 @@ typedef struct _GDataDocumentsPresentationPrivate GDataDocumentsPresentationPriv * All the fields in the #GDataDocumentsPresentation structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataDocumentsDocument parent; GDataDocumentsPresentationPrivate *priv; @@ -126,7 +126,7 @@ typedef struct { * All the fields in the #GDataDocumentsPresentationClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsDocumentClass parent; diff --git a/gdata/services/documents/gdata-documents-query.c b/gdata/services/documents/gdata-documents-query.c index ab04d36a..634e7a2e 100644 --- a/gdata/services/documents/gdata-documents-query.c +++ b/gdata/services/documents/gdata-documents-query.c @@ -79,7 +79,7 @@ * </example> * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -143,7 +143,7 @@ gdata_documents_query_class_init (GDataDocumentsQueryClass *klass) * A shortcut to request all documents that have been deleted. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SHOW_DELETED, g_param_spec_boolean ("show-deleted", "Show deleted?", "A shortcut to request all documents that have been deleted.", @@ -156,7 +156,7 @@ gdata_documents_query_class_init (GDataDocumentsQueryClass *klass) * Specifies if the request also returns folders. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SHOW_FOLDERS, g_param_spec_boolean ("show-folders", "Show folders?", "Specifies if the request also returns folders.", @@ -169,7 +169,7 @@ gdata_documents_query_class_init (GDataDocumentsQueryClass *klass) * Specifies whether the query should search for an exact title match for the #GDataDocumentsQuery:title parameter. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EXACT_TITLE, g_param_spec_boolean ("exact-title", "Exact title?", "Specifies whether the query should search for an exact title match.", @@ -182,7 +182,7 @@ gdata_documents_query_class_init (GDataDocumentsQueryClass *klass) * Specifies the ID of the folder in which to search. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FOLDER_ID, g_param_spec_string ("folder-id", "Folder ID", "Specifies the ID of the folder in which to search.", @@ -196,7 +196,7 @@ gdata_documents_query_class_init (GDataDocumentsQueryClass *klass) * title match will be searched for, otherwise substring matches will also be returned. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TITLE, g_param_spec_string ("title", "Title", "A title (or title fragment) to be searched for.", @@ -411,7 +411,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Return value: a new #GDataDocumentsQuery * * Since: 0.4.0 - **/ + */ GDataDocumentsQuery * gdata_documents_query_new (const gchar *q) { @@ -430,7 +430,7 @@ gdata_documents_query_new (const gchar *q) * Return value: a new #GDataDocumentsQuery * * Since: 0.4.0 - **/ + */ GDataDocumentsQuery * gdata_documents_query_new_with_limits (const gchar *q, guint start_index, guint max_results) { @@ -450,7 +450,7 @@ gdata_documents_query_new_with_limits (const gchar *q, guint start_index, guint * Return value: %TRUE if the request should return deleted entries, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_documents_query_show_deleted (GDataDocumentsQuery *self) { @@ -466,7 +466,7 @@ gdata_documents_query_show_deleted (GDataDocumentsQuery *self) * Sets the #GDataDocumentsQuery:show_deleted property to @show_deleted. * * Since: 0.4.0 - **/ + */ void gdata_documents_query_set_show_deleted (GDataDocumentsQuery *self, gboolean show_deleted) { @@ -487,7 +487,7 @@ gdata_documents_query_set_show_deleted (GDataDocumentsQuery *self, gboolean show * Return value: %TRUE if the request should return folders, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_documents_query_show_folders (GDataDocumentsQuery *self) { @@ -503,7 +503,7 @@ gdata_documents_query_show_folders (GDataDocumentsQuery *self) * Sets the #GDataDocumentsQuery:show-folders property to show_folders. * * Since: 0.4.0 - **/ + */ void gdata_documents_query_set_show_folders (GDataDocumentsQuery *self, gboolean show_folders) { @@ -524,7 +524,7 @@ gdata_documents_query_set_show_folders (GDataDocumentsQuery *self, gboolean show * Return value: the ID of the folder to be queried, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_documents_query_get_folder_id (GDataDocumentsQuery *self) { @@ -542,7 +542,7 @@ gdata_documents_query_get_folder_id (GDataDocumentsQuery *self) * Set @folder_id to %NULL to unset the property in the query URI. * * Since: 0.4.0 - **/ + */ void gdata_documents_query_set_folder_id (GDataDocumentsQuery *self, const gchar *folder_id) { @@ -565,7 +565,7 @@ gdata_documents_query_set_folder_id (GDataDocumentsQuery *self, const gchar *fol * Return value: the title (or title fragment) being queried for, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_documents_query_get_title (GDataDocumentsQuery *self) { @@ -582,7 +582,7 @@ gdata_documents_query_get_title (GDataDocumentsQuery *self) * Return value: %TRUE if the query matches the exact title of documents with #GDataDocumentsQuery:title, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_documents_query_get_exact_title (GDataDocumentsQuery *self) { @@ -601,7 +601,7 @@ gdata_documents_query_get_exact_title (GDataDocumentsQuery *self) * Set @title to %NULL to unset the property in the query URI. * * Since: 0.4.0 - **/ + */ void gdata_documents_query_set_title (GDataDocumentsQuery *self, const gchar *title, gboolean exact_title) { @@ -630,7 +630,7 @@ gdata_documents_query_set_title (GDataDocumentsQuery *self, const gchar *title, * query, or %NULL * * Since: 0.4.0 - **/ + */ GList * gdata_documents_query_get_collaborator_addresses (GDataDocumentsQuery *self) { @@ -648,7 +648,7 @@ gdata_documents_query_get_collaborator_addresses (GDataDocumentsQuery *self) * or %NULL * * Since: 0.4.0 - **/ + */ GList * gdata_documents_query_get_reader_addresses (GDataDocumentsQuery *self) { @@ -664,7 +664,7 @@ gdata_documents_query_get_reader_addresses (GDataDocumentsQuery *self) * Add @email_address as a #GDataGDEmailAddress to the list of readers, the documents readable by whom will be queried. * * Since: 0.4.0 - **/ + */ void gdata_documents_query_add_reader (GDataDocumentsQuery *self, const gchar *email_address) { @@ -688,7 +688,7 @@ gdata_documents_query_add_reader (GDataDocumentsQuery *self, const gchar *email_ * Add @email_address as a #GDataGDEmailAddress to the list of collaborators whose edited documents will be queried. * * Since: 0.4.0 - **/ + */ void gdata_documents_query_add_collaborator (GDataDocumentsQuery *self, const gchar *email_address) { diff --git a/gdata/services/documents/gdata-documents-query.h b/gdata/services/documents/gdata-documents-query.h index 84dbdbad..73e2717b 100644 --- a/gdata/services/documents/gdata-documents-query.h +++ b/gdata/services/documents/gdata-documents-query.h @@ -43,7 +43,7 @@ typedef struct _GDataDocumentsQueryPrivate GDataDocumentsQueryPrivate; * All the fields in the #GDataDocumentsQuery structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataQuery parent; GDataDocumentsQueryPrivate *priv; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataDocumentsQueryClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataQueryClass parent; diff --git a/gdata/services/documents/gdata-documents-service.c b/gdata/services/documents/gdata-documents-service.c index e350c8d5..0de0aec6 100644 --- a/gdata/services/documents/gdata-documents-service.c +++ b/gdata/services/documents/gdata-documents-service.c @@ -247,7 +247,7 @@ * </example> * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -492,7 +492,7 @@ _query_documents_build_request_uri (GDataDocumentsQuery *query) * Return value: (transfer full): a #GDataDocumentsFeed of query results; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataDocumentsFeed * gdata_documents_service_query_documents (GDataDocumentsService *self, GDataDocumentsQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -541,7 +541,7 @@ gdata_documents_service_query_documents (GDataDocumentsService *self, GDataDocum * and gdata_service_query_async(), which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_documents_service_query_documents_async (GDataDocumentsService *self, GDataDocumentsQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -671,7 +671,7 @@ _upload_checks (GDataDocumentsService *self, GDataDocumentsDocument *document, G * Return value: (transfer full): a #GDataUploadStream to write the document data to, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataUploadStream * gdata_documents_service_upload_document (GDataDocumentsService *self, GDataDocumentsDocument *document, const gchar *slug, const gchar *content_type, GDataDocumentsFolder *folder, GCancellable *cancellable, GError **error) @@ -814,7 +814,7 @@ _update_checks (GDataDocumentsService *self, GError **error) * Return value: (transfer full): a #GDataUploadStream to write the document data to; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataUploadStream * gdata_documents_service_update_document (GDataDocumentsService *self, GDataDocumentsDocument *document, const gchar *slug, const gchar *content_type, GCancellable *cancellable, GError **error) @@ -1131,7 +1131,7 @@ gdata_documents_service_copy_document_finish (GDataDocumentsService *self, GAsyn * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDocumentsEntry * gdata_documents_service_add_entry_to_folder (GDataDocumentsService *self, GDataDocumentsEntry *entry, GDataDocumentsFolder *folder, GCancellable *cancellable, GError **error) @@ -1267,7 +1267,7 @@ add_entry_to_folder_thread (GSimpleAsyncResult *result, GDataDocumentsService *s * of the operation. * * Since: 0.8.0 - **/ + */ void gdata_documents_service_add_entry_to_folder_async (GDataDocumentsService *self, GDataDocumentsEntry *entry, GDataDocumentsFolder *folder, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -1301,7 +1301,7 @@ gdata_documents_service_add_entry_to_folder_async (GDataDocumentsService *self, * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDocumentsEntry * gdata_documents_service_add_entry_to_folder_finish (GDataDocumentsService *self, GAsyncResult *async_result, GError **error) { @@ -1340,7 +1340,7 @@ gdata_documents_service_add_entry_to_folder_finish (GDataDocumentsService *self, * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDocumentsEntry * gdata_documents_service_remove_entry_from_folder (GDataDocumentsService *self, GDataDocumentsEntry *entry, GDataDocumentsFolder *folder, GCancellable *cancellable, GError **error) @@ -1452,7 +1452,7 @@ remove_entry_from_folder_thread (GSimpleAsyncResult *result, GDataDocumentsServi * results of the operation. * * Since: 0.8.0 - **/ + */ void gdata_documents_service_remove_entry_from_folder_async (GDataDocumentsService *self, GDataDocumentsEntry *entry, GDataDocumentsFolder *folder, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -1487,7 +1487,7 @@ gdata_documents_service_remove_entry_from_folder_async (GDataDocumentsService *s * Return value: (transfer full): an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDocumentsEntry * gdata_documents_service_remove_entry_from_folder_finish (GDataDocumentsService *self, GAsyncResult *async_result, GError **error) { @@ -1536,7 +1536,7 @@ _get_upload_uri_for_query_and_folder (GDataDocumentsUploadQuery *query, GDataDoc * Return value: the URI permitting the upload of documents to @folder, or %NULL; free with g_free() * * Since: 0.5.0 - **/ + */ gchar * gdata_documents_service_get_upload_uri (GDataDocumentsFolder *folder) { diff --git a/gdata/services/documents/gdata-documents-service.h b/gdata/services/documents/gdata-documents-service.h index da4c3191..f9902aea 100644 --- a/gdata/services/documents/gdata-documents-service.h +++ b/gdata/services/documents/gdata-documents-service.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * Error codes for #GDataDocumentsService operations. * * Since: 0.4.0 - **/ + */ typedef enum { GDATA_DOCUMENTS_SERVICE_ERROR_INVALID_CONTENT_TYPE } GDataDocumentsServiceError; @@ -59,7 +59,7 @@ typedef struct _GDataDocumentsServicePrivate GDataDocumentsServicePrivate; * All the fields in the #GDataDocumentsService structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataService parent; GDataDocumentsServicePrivate *priv; @@ -71,7 +71,7 @@ typedef struct { * All the fields in the #GDataDocumentsServiceClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataServiceClass parent; diff --git a/gdata/services/documents/gdata-documents-spreadsheet.c b/gdata/services/documents/gdata-documents-spreadsheet.c index ee794a7d..07fd0ee3 100644 --- a/gdata/services/documents/gdata-documents-spreadsheet.c +++ b/gdata/services/documents/gdata-documents-spreadsheet.c @@ -85,7 +85,7 @@ * </example> * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -136,7 +136,7 @@ gdata_documents_spreadsheet_constructed (GObject *object) * Return value: (transfer full): a new #GDataDocumentsSpreadsheet, or %NULL; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataDocumentsSpreadsheet * gdata_documents_spreadsheet_new (const gchar *id) { @@ -161,7 +161,7 @@ gdata_documents_spreadsheet_new (const gchar *id) * Return value: the download URI; free with g_free() * * Since: 0.5.0 - **/ + */ gchar * gdata_documents_spreadsheet_get_download_uri (GDataDocumentsSpreadsheet *self, const gchar *export_format, gint gid) { diff --git a/gdata/services/documents/gdata-documents-spreadsheet.h b/gdata/services/documents/gdata-documents-spreadsheet.h index 38cab006..ccbac362 100644 --- a/gdata/services/documents/gdata-documents-spreadsheet.h +++ b/gdata/services/documents/gdata-documents-spreadsheet.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_CSV "csv" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_ODS "ods" /** @@ -63,7 +63,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_PDF "pdf" /** @@ -76,7 +76,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_TSV "tsv" /** @@ -89,7 +89,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_XLS "xls" /** @@ -102,7 +102,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_HTML "html" #define GDATA_TYPE_DOCUMENTS_SPREADSHEET (gdata_documents_spreadsheet_get_type ()) @@ -123,7 +123,7 @@ typedef struct _GDataDocumentsSpreadsheetPrivate GDataDocumentsSpreadsheetPrivat * All the fields in the #GDataDocumentsSpreadsheet structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataDocumentsDocument parent; GDataDocumentsSpreadsheetPrivate *priv; @@ -135,7 +135,7 @@ typedef struct { * All the fields in the #GDataDocumentsSpreadsheetClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsDocumentClass parent; diff --git a/gdata/services/documents/gdata-documents-text.c b/gdata/services/documents/gdata-documents-text.c index d9a9c046..127fb60e 100644 --- a/gdata/services/documents/gdata-documents-text.c +++ b/gdata/services/documents/gdata-documents-text.c @@ -31,7 +31,7 @@ * <ulink type="http" url="https://developers.google.com/google-apps/documents-list/">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -79,7 +79,7 @@ gdata_documents_text_constructed (GObject *object) * Return value: (transfer full): a new #GDataDocumentsText, or %NULL; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataDocumentsText * gdata_documents_text_new (const gchar *id) { diff --git a/gdata/services/documents/gdata-documents-text.h b/gdata/services/documents/gdata-documents-text.h index 98254b27..adc9369e 100644 --- a/gdata/services/documents/gdata-documents-text.h +++ b/gdata/services/documents/gdata-documents-text.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_DOC "doc" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_HTML "html" /** @@ -76,7 +76,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_ODT "odt" /** @@ -89,7 +89,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_PDF "pdf" /** @@ -102,7 +102,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_PNG "png" /** @@ -115,7 +115,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_RTF "rtf" /** @@ -128,7 +128,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_TXT "txt" /** @@ -141,7 +141,7 @@ G_BEGIN_DECLS * GData protocol specification</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_ZIP "zip" #define GDATA_TYPE_DOCUMENTS_TEXT (gdata_documents_text_get_type ()) @@ -159,7 +159,7 @@ typedef struct _GDataDocumentsTextPrivate GDataDocumentsTextPrivate; * All the fields in the #GDataDocumentsText structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataDocumentsDocument parent; GDataDocumentsTextPrivate *priv; @@ -171,7 +171,7 @@ typedef struct { * All the fields in the #GDataDocumentsTextClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataDocumentsDocumentClass parent; diff --git a/gdata/services/freebase/gdata-freebase-query.c b/gdata/services/freebase/gdata-freebase-query.c index ca62f395..8e66de17 100644 --- a/gdata/services/freebase/gdata-freebase-query.c +++ b/gdata/services/freebase/gdata-freebase-query.c @@ -81,7 +81,7 @@ gdata_freebase_query_class_init (GDataFreebaseQueryClass *klass) * containing (possibly nested) Freebase schema types and values. * * Since: 0.15.1 - **/ + */ g_object_class_install_property (gobject_class, PROP_VARIANT, g_param_spec_variant ("variant", "Variant", diff --git a/gdata/services/freebase/gdata-freebase-result.c b/gdata/services/freebase/gdata-freebase-result.c index a147e994..2c87c3dc 100644 --- a/gdata/services/freebase/gdata-freebase-result.c +++ b/gdata/services/freebase/gdata-freebase-result.c @@ -81,7 +81,7 @@ gdata_freebase_result_class_init (GDataFreebaseResultClass *klass) * containing (possibly nested) Freebase schema types and values. * * Since: 0.15.1 - **/ + */ g_object_class_install_property (gobject_class, PROP_VARIANT, g_param_spec_variant ("variant", "Variant", "Variant holding the raw result.", @@ -179,7 +179,7 @@ gdata_freebase_result_new (void) * Returns: (allow-none) (transfer full): the serialized result, or %NULL; unref with g_variant_unref() * * Since: 0.15.1 - **/ + */ GVariant * gdata_freebase_result_dup_variant (GDataFreebaseResult *self) { diff --git a/gdata/services/freebase/gdata-freebase-search-query.c b/gdata/services/freebase/gdata-freebase-search-query.c index 4c666fd2..1509ca38 100644 --- a/gdata/services/freebase/gdata-freebase-search-query.c +++ b/gdata/services/freebase/gdata-freebase-search-query.c @@ -382,7 +382,7 @@ gdata_freebase_search_query_new (const gchar *search_terms) * Every call to this function must be paired by a call to gdata_freebase_search_query_close_filter(). * * Since: 0.15.1 - **/ + */ void gdata_freebase_search_query_open_filter (GDataFreebaseSearchQuery *self, GDataFreebaseSearchFilterType filter_type) { @@ -417,7 +417,7 @@ gdata_freebase_search_query_open_filter (GDataFreebaseSearchQuery *self, GDataFr * Closes a filter level. * * Since: 0.15.1 - **/ + */ void gdata_freebase_search_query_close_filter (GDataFreebaseSearchQuery *self) { @@ -444,7 +444,7 @@ gdata_freebase_search_query_close_filter (GDataFreebaseSearchQuery *self) * and gdata_freebase_search_query_close_filter(). * * Since: 0.15.1 - **/ + */ void gdata_freebase_search_query_add_filter (GDataFreebaseSearchQuery *self, const gchar *property, const gchar *value) { @@ -483,7 +483,7 @@ gdata_freebase_search_query_add_filter (GDataFreebaseSearchQuery *self, const gc * and gdata_freebase_search_query_close_filter(). * * Since: 0.15.1 - **/ + */ void gdata_freebase_search_query_add_location (GDataFreebaseSearchQuery *self, guint64 radius, gdouble lat, gdouble lon) { @@ -517,7 +517,7 @@ gdata_freebase_search_query_add_location (GDataFreebaseSearchQuery *self, guint6 * the locale preferences will be respected. * * Since: 0.15.1 - **/ + */ void gdata_freebase_search_query_set_language (GDataFreebaseSearchQuery *self, const gchar *lang) @@ -546,7 +546,7 @@ gdata_freebase_search_query_set_language (GDataFreebaseSearchQuery *self, * Return value: (allow-none): The language used on the query. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_query_get_language (GDataFreebaseSearchQuery *self) { @@ -568,7 +568,7 @@ gdata_freebase_search_query_get_language (GDataFreebaseSearchQuery *self) * for search purposes. * * Since: 0.15.1 - **/ + */ void gdata_freebase_search_query_set_stemmed (GDataFreebaseSearchQuery *self, gboolean stemmed) @@ -595,7 +595,7 @@ gdata_freebase_search_query_set_stemmed (GDataFreebaseSearchQuery *self, * Return value: %TRUE if the #GDataFreebaseSearchQuery performs stemming * * Since: 0.15.1 - **/ + */ gboolean gdata_freebase_search_query_get_stemmed (GDataFreebaseSearchQuery *self) { diff --git a/gdata/services/freebase/gdata-freebase-search-result.c b/gdata/services/freebase/gdata-freebase-search-result.c index d2576e7e..3d553ae3 100644 --- a/gdata/services/freebase/gdata-freebase-search-result.c +++ b/gdata/services/freebase/gdata-freebase-search-result.c @@ -236,7 +236,7 @@ gdata_freebase_search_result_new (void) * Returns: The number of items * * Since: 0.15.1 - **/ + */ guint gdata_freebase_search_result_get_num_items (GDataFreebaseSearchResult *self) { @@ -254,7 +254,7 @@ gdata_freebase_search_result_get_num_items (GDataFreebaseSearchResult *self) * Returns: the total number of hits. * * Since: 0.15.1 - **/ + */ guint gdata_freebase_search_result_get_total_hits (GDataFreebaseSearchResult *self) { @@ -273,7 +273,7 @@ gdata_freebase_search_result_get_total_hits (GDataFreebaseSearchResult *self) * Returns: (transfer none) (allow-none): a search result item, or %NULL on invalid item. * * Since: 0.15.1 - **/ + */ const GDataFreebaseSearchResultItem * gdata_freebase_search_result_get_item (GDataFreebaseSearchResult *self, guint i) { @@ -298,7 +298,7 @@ gdata_freebase_search_result_get_item (GDataFreebaseSearchResult *self, guint i) * Returns: (transfer none): The result item MID. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_result_item_get_mid (const GDataFreebaseSearchResultItem *item) { @@ -315,7 +315,7 @@ gdata_freebase_search_result_item_get_mid (const GDataFreebaseSearchResultItem * * Returns: (transfer none): The search result item Freebase ID. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_result_item_get_id (const GDataFreebaseSearchResultItem *item) { @@ -336,7 +336,7 @@ gdata_freebase_search_result_item_get_id (const GDataFreebaseSearchResultItem *i * Returns: (transfer none): The human readable name of the item. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_result_item_get_name (const GDataFreebaseSearchResultItem *item) { @@ -353,7 +353,7 @@ gdata_freebase_search_result_item_get_name (const GDataFreebaseSearchResultItem * Returns: (transfer none): The language of the search result item. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_result_item_get_language (const GDataFreebaseSearchResultItem *item) { @@ -371,7 +371,7 @@ gdata_freebase_search_result_item_get_language (const GDataFreebaseSearchResultI * Returns: (transfer none) (allow-none): The topic the result item is most notable of, or %NULL. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_result_item_get_notable_id (const GDataFreebaseSearchResultItem *item) { @@ -389,7 +389,7 @@ gdata_freebase_search_result_item_get_notable_id (const GDataFreebaseSearchResul * Returns: (transfer none) (allow-none): The human readable topic name, or %NULL * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_search_result_item_get_notable_name (const GDataFreebaseSearchResultItem *item) { @@ -407,7 +407,7 @@ gdata_freebase_search_result_item_get_notable_name (const GDataFreebaseSearchRes * Returns: the result item score. * * Since: 0.15.1 - **/ + */ gdouble gdata_freebase_search_result_item_get_score (const GDataFreebaseSearchResultItem *item) { diff --git a/gdata/services/freebase/gdata-freebase-service.c b/gdata/services/freebase/gdata-freebase-service.c index 68a33d56..3079d123 100644 --- a/gdata/services/freebase/gdata-freebase-service.c +++ b/gdata/services/freebase/gdata-freebase-service.c @@ -93,7 +93,7 @@ gdata_freebase_service_class_init (GDataFreebaseServiceClass *klass) * url="https://developers.google.com/freebase/v1/how-tos/authorizing">online documentation</ulink>. * * Since: 0.15.1 - **/ + */ g_object_class_install_property (gobject_class, PROP_DEVELOPER_KEY, g_param_spec_string ("developer-key", "Developer key", "Your Freebase developer API key.", @@ -458,7 +458,7 @@ compose_image_uri (GDataFreebaseTopicValue *value, guint max_width, guint max_he * Return value: (transfer full): a #GInputStream opened to the image; unref with g_object_unref() * * Since: 0.15.1 - **/ + */ GInputStream * gdata_freebase_service_get_image (GDataFreebaseService *self, GDataFreebaseTopicValue *value, GCancellable *cancellable, guint max_width, guint max_height, GError **error) diff --git a/gdata/services/freebase/gdata-freebase-service.h b/gdata/services/freebase/gdata-freebase-service.h index 2b0523b6..017bb4ef 100644 --- a/gdata/services/freebase/gdata-freebase-service.h +++ b/gdata/services/freebase/gdata-freebase-service.h @@ -50,7 +50,7 @@ typedef struct _GDataFreebaseServicePrivate GDataFreebaseServicePrivate; * All the fields in the #GDataFreebaseService structure are private and should never be accessed directly. * * Since: 0.15.1 - **/ + */ typedef struct { GDataService parent; /*< private >*/ @@ -63,7 +63,7 @@ typedef struct { * All the fields in the #GDataFreebaseServiceClass structure are private and should never be accessed directly. * * Since: 0.15.1 - **/ + */ typedef struct { /*< private >*/ GDataServiceClass parent; diff --git a/gdata/services/freebase/gdata-freebase-topic-query.c b/gdata/services/freebase/gdata-freebase-topic-query.c index b30d0562..48c661ee 100644 --- a/gdata/services/freebase/gdata-freebase-topic-query.c +++ b/gdata/services/freebase/gdata-freebase-topic-query.c @@ -252,7 +252,7 @@ gdata_freebase_topic_query_new (const gchar *id) * the locale preferences will be respected. * * Since: 0.15.1 - **/ + */ void gdata_freebase_topic_query_set_language (GDataFreebaseTopicQuery *self, const gchar *lang) @@ -281,7 +281,7 @@ gdata_freebase_topic_query_set_language (GDataFreebaseTopicQuery *self, * Return value: (allow-none): The language used on the query. * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_query_get_language (GDataFreebaseTopicQuery *self) { @@ -305,7 +305,7 @@ gdata_freebase_topic_query_get_language (GDataFreebaseTopicQuery *self) * If no filter is set, the "commons" special value will be implicitly assumed, which returns a reasonably complete data set. * * Since: 0.15.1 - **/ + */ void gdata_freebase_topic_query_set_filter (GDataFreebaseTopicQuery *self, const gchar * const *filter) { @@ -328,7 +328,7 @@ gdata_freebase_topic_query_set_filter (GDataFreebaseTopicQuery *self, const gcha * Return value: (array zero-terminated=1) (transfer none) (allow-none): The filter used on the query. * * Since: 0.15.1 - **/ + */ const gchar * const * gdata_freebase_topic_query_get_filter (GDataFreebaseTopicQuery *self) { diff --git a/gdata/services/freebase/gdata-freebase-topic-result.c b/gdata/services/freebase/gdata-freebase-topic-result.c index 4b21bd72..476b16af 100644 --- a/gdata/services/freebase/gdata-freebase-topic-result.c +++ b/gdata/services/freebase/gdata-freebase-topic-result.c @@ -575,7 +575,7 @@ gdata_freebase_topic_result_new (void) * gdata_freebase_topic_object_unref() * * Since: 0.15.1 - **/ + */ GDataFreebaseTopicObject * gdata_freebase_topic_result_dup_object (GDataFreebaseTopicResult *self) { @@ -593,7 +593,7 @@ gdata_freebase_topic_result_dup_object (GDataFreebaseTopicResult *self) * Returns: (transfer full): @object, with an extra reference. * * Since: 0.15.1 - **/ + */ GDataFreebaseTopicObject * gdata_freebase_topic_object_ref (GDataFreebaseTopicObject *object) { @@ -611,7 +611,7 @@ gdata_freebase_topic_object_ref (GDataFreebaseTopicObject *object) * the object is freed. * * Since: 0.15.1 - **/ + */ void gdata_freebase_topic_object_unref (GDataFreebaseTopicObject *object) { @@ -633,7 +633,7 @@ gdata_freebase_topic_object_unref (GDataFreebaseTopicObject *object) * Returns: (transfer container) (element-type gchar*): An array of property names, free with g_ptr_array_unref(). * * Since: 0.15.1 - **/ + */ GPtrArray * gdata_freebase_topic_object_list_properties (const GDataFreebaseTopicObject *object) { @@ -663,7 +663,7 @@ gdata_freebase_topic_object_list_properties (const GDataFreebaseTopicObject *obj * Returns: The number of values contained for @property * * Since: 0.15.1 - **/ + */ guint64 gdata_freebase_topic_object_get_property_count (const GDataFreebaseTopicObject *object, const gchar *property) { @@ -695,7 +695,7 @@ gdata_freebase_topic_object_get_property_count (const GDataFreebaseTopicObject * * Returns: the total number of hits for this property * * Since: 0.15.1 - **/ + */ guint64 gdata_freebase_topic_object_get_property_hits (const GDataFreebaseTopicObject *object, const gchar *property) { @@ -725,7 +725,7 @@ gdata_freebase_topic_object_get_property_hits (const GDataFreebaseTopicObject *o * Returns: (allow-none) (transfer none): the value for this property/item * * Since: 0.15.1 - **/ + */ GDataFreebaseTopicValue * gdata_freebase_topic_object_get_property_value (const GDataFreebaseTopicObject *object, const gchar *property, gint64 item) { @@ -753,7 +753,7 @@ gdata_freebase_topic_object_get_property_value (const GDataFreebaseTopicObject * * Returns: (transfer none): the Freebase ID of this object * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_object_get_id (const GDataFreebaseTopicObject *object) { @@ -770,7 +770,7 @@ gdata_freebase_topic_object_get_id (const GDataFreebaseTopicObject *object) * Returns: (transfer full): @value, with an extra reference. * * Since: 0.15.1 - **/ + */ GDataFreebaseTopicValue * gdata_freebase_topic_value_ref (GDataFreebaseTopicValue *value) { @@ -788,7 +788,7 @@ gdata_freebase_topic_value_ref (GDataFreebaseTopicValue *value) * the object is freed. * * Since: 0.15.1 - **/ + */ void gdata_freebase_topic_value_unref (GDataFreebaseTopicValue *value) { @@ -807,7 +807,7 @@ gdata_freebase_topic_value_unref (GDataFreebaseTopicValue *value) * Returns: the property name of @value * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_value_get_property (GDataFreebaseTopicValue *value) { @@ -826,7 +826,7 @@ gdata_freebase_topic_value_get_property (GDataFreebaseTopicValue *value) * Returns: a textual representation of @value * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_value_get_text (GDataFreebaseTopicValue *value) { @@ -843,7 +843,7 @@ gdata_freebase_topic_value_get_text (GDataFreebaseTopicValue *value) * Returns: the language @value is written in * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_value_get_language (GDataFreebaseTopicValue *value) { @@ -860,7 +860,7 @@ gdata_freebase_topic_value_get_language (GDataFreebaseTopicValue *value) * Returns: the creator of this value, as a Freebase ID * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_value_get_creator (GDataFreebaseTopicValue *value) { @@ -879,7 +879,7 @@ gdata_freebase_topic_value_get_creator (GDataFreebaseTopicValue *value) * Returns: The creation time of @value, or -1 * * Since: 0.15.1 - **/ + */ gint64 gdata_freebase_topic_value_get_timestamp (GDataFreebaseTopicValue *value) { @@ -896,7 +896,7 @@ gdata_freebase_topic_value_get_timestamp (GDataFreebaseTopicValue *value) * Returns: the #GType of the contained value * * Since: 0.15.1 - **/ + */ GType gdata_freebase_topic_value_get_value_type (GDataFreebaseTopicValue *value) { @@ -912,7 +912,7 @@ gdata_freebase_topic_value_get_value_type (GDataFreebaseTopicValue *value) * Copies in @gvalue the value held in @value. the #GValue must be later freed through g_value_unset() * * Since: 0.15.1 - **/ + */ void gdata_freebase_topic_value_copy_value (GDataFreebaseTopicValue *value, GValue *gvalue) { @@ -930,7 +930,7 @@ gdata_freebase_topic_value_copy_value (GDataFreebaseTopicValue *value, GValue *g * Returns: the #gint64 value * * Since: 0.15.1 - **/ + */ gint64 gdata_freebase_topic_value_get_int (GDataFreebaseTopicValue *value) { @@ -949,7 +949,7 @@ gdata_freebase_topic_value_get_int (GDataFreebaseTopicValue *value) * Returns: the #gdouble value * * Since: 0.15.1 - **/ + */ gdouble gdata_freebase_topic_value_get_double (GDataFreebaseTopicValue *value) { @@ -968,7 +968,7 @@ gdata_freebase_topic_value_get_double (GDataFreebaseTopicValue *value) * Returns: the string value * * Since: 0.15.1 - **/ + */ const gchar * gdata_freebase_topic_value_get_string (GDataFreebaseTopicValue *value) { @@ -988,7 +988,7 @@ gdata_freebase_topic_value_get_string (GDataFreebaseTopicValue *value) * Returns: (transfer none): the compound value as a #GDataFreebaseTopicObject * * Since: 0.15.1 - **/ + */ const GDataFreebaseTopicObject * gdata_freebase_topic_value_get_object (GDataFreebaseTopicValue *value) { @@ -1009,7 +1009,7 @@ gdata_freebase_topic_value_get_object (GDataFreebaseTopicValue *value) * Returns: Whether @value holds a Freebase image object * * Since: 0.15.1 - **/ + */ gboolean gdata_freebase_topic_value_is_image (GDataFreebaseTopicValue *value) { diff --git a/gdata/services/picasaweb/gdata-picasaweb-album.c b/gdata/services/picasaweb/gdata-picasaweb-album.c index 6c10f07f..515d34a9 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-album.c +++ b/gdata/services/picasaweb/gdata-picasaweb-album.c @@ -80,7 +80,7 @@ * </example> * * Since: 0.4.0 - **/ + */ /* TODO: support the album cover/icon ? I think this is already done with the thumbnails, but we don't set it yet :( */ @@ -181,7 +181,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ALBUM_ID, g_param_spec_string ("album-id", "Album ID", "The ID of the album.", @@ -197,7 +197,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_USER, g_param_spec_string ("user", "User", "The username of the album owner.", @@ -213,7 +213,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NICKNAME, g_param_spec_string ("nickname", "Nickname", "The user's nickname.", @@ -229,7 +229,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * Atom Publishing Protocol specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The time this album was last edited.", @@ -245,7 +245,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LOCATION, g_param_spec_string ("location", "Location", "The user-specified location associated with the album.", @@ -261,7 +261,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VISIBILITY, g_param_spec_enum ("visibility", "Visibility", "The visibility (or access rights) of the album.", @@ -277,7 +277,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMESTAMP, g_param_spec_int64 ("timestamp", "Timestamp", "The timestamp of when the album occurred, settable by the user.", @@ -294,7 +294,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NUM_PHOTOS, g_param_spec_uint ("num-photos", "Number of photos", "The number of photos and videos in the album.", @@ -312,7 +312,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NUM_PHOTOS_REMAINING, g_param_spec_uint ("num-photos-remaining", "Number of photo spaces remaining", "The number of files spaces still free for uploads.", @@ -329,7 +329,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_BYTES_USED, g_param_spec_long ("bytes-used", "Number of bytes used", "The number of bytes consumed by this album and its contents.", @@ -342,7 +342,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * Whether commenting is enabled for this album. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_COMMENTING_ENABLED, g_param_spec_boolean ("is-commenting-enabled", "Commenting enabled?", "Whether commenting is enabled for this album.", @@ -358,7 +358,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_COMMENT_COUNT, g_param_spec_uint ("comment-count", "Comment count", "The number of comments on the album.", @@ -374,7 +374,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * Media RSS specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TAGS, g_param_spec_boxed ("tags", "Tags", "A NULL-terminated array of tags associated with the album", @@ -391,7 +391,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * GeoRSS specification</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LATITUDE, g_param_spec_double ("latitude", "Latitude", "The location as a latitude coordinate associated with this album.", @@ -408,7 +408,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass) * GeoRSS specification</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LONGITUDE, g_param_spec_double ("longitude", "Longitude", "The location as a longitude coordinate associated with this album.", @@ -842,7 +842,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataPicasaWebAlbum, or %NULL; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataPicasaWebAlbum * gdata_picasaweb_album_new (const gchar *id) { @@ -873,7 +873,7 @@ gdata_picasaweb_album_new (const gchar *id) * Return value: the album's ID * * Since: 0.7.0 - **/ + */ const gchar * gdata_picasaweb_album_get_id (GDataPicasaWebAlbum *self) { @@ -890,7 +890,7 @@ gdata_picasaweb_album_get_id (GDataPicasaWebAlbum *self) * Return value: the album owner's username * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_album_get_user (GDataPicasaWebAlbum *self) { @@ -907,7 +907,7 @@ gdata_picasaweb_album_get_user (GDataPicasaWebAlbum *self) * Return value: the album owner's nickname * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_album_get_nickname (GDataPicasaWebAlbum *self) { @@ -924,7 +924,7 @@ gdata_picasaweb_album_get_nickname (GDataPicasaWebAlbum *self) * Return value: the UNIX timestamp for the time the album was last edited, or <code class="literal">-1</code> * * Since: 0.4.0 - **/ + */ gint64 gdata_picasaweb_album_get_edited (GDataPicasaWebAlbum *self) { @@ -941,7 +941,7 @@ gdata_picasaweb_album_get_edited (GDataPicasaWebAlbum *self) * Return value: the album's location, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_album_get_location (GDataPicasaWebAlbum *self) { @@ -959,7 +959,7 @@ gdata_picasaweb_album_get_location (GDataPicasaWebAlbum *self) * Set @location to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_album_set_location (GDataPicasaWebAlbum *self, const gchar *location) { @@ -979,7 +979,7 @@ gdata_picasaweb_album_set_location (GDataPicasaWebAlbum *self, const gchar *loca * Return value: the album's visibility level * * Since: 0.4.0 - **/ + */ GDataPicasaWebVisibility gdata_picasaweb_album_get_visibility (GDataPicasaWebAlbum *self) { @@ -995,7 +995,7 @@ gdata_picasaweb_album_get_visibility (GDataPicasaWebAlbum *self) * Sets the #GDataPicasaWebAlbum:visibility property to @visibility. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_album_set_visibility (GDataPicasaWebAlbum *self, GDataPicasaWebVisibility visibility) { @@ -1016,7 +1016,7 @@ gdata_picasaweb_album_set_visibility (GDataPicasaWebAlbum *self, GDataPicasaWebV * Return value: the UNIX timestamp for the timestamp property in milliseconds, or <code class="literal">-1</code> * * Since: 0.4.0 - **/ + */ gint64 gdata_picasaweb_album_get_timestamp (GDataPicasaWebAlbum *self) { @@ -1034,7 +1034,7 @@ gdata_picasaweb_album_get_timestamp (GDataPicasaWebAlbum *self) * Set @timestamp to <code class="literal">-1</code> to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_album_set_timestamp (GDataPicasaWebAlbum *self, gint64 timestamp) { @@ -1054,7 +1054,7 @@ gdata_picasaweb_album_set_timestamp (GDataPicasaWebAlbum *self, gint64 timestamp * Return value: the number of photos currently in the album * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_album_get_num_photos (GDataPicasaWebAlbum *self) { @@ -1071,7 +1071,7 @@ gdata_picasaweb_album_get_num_photos (GDataPicasaWebAlbum *self) * Return value: the number of photos that can still be uploaded to the album * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_album_get_num_photos_remaining (GDataPicasaWebAlbum *self) { @@ -1089,7 +1089,7 @@ gdata_picasaweb_album_get_num_photos_remaining (GDataPicasaWebAlbum *self) * Return value: the number of bytes used by the album and its contents, or <code class="literal">-1</code> * * Since: 0.4.0 - **/ + */ glong gdata_picasaweb_album_get_bytes_used (GDataPicasaWebAlbum *self) { @@ -1106,7 +1106,7 @@ gdata_picasaweb_album_get_bytes_used (GDataPicasaWebAlbum *self) * Return value: %TRUE if commenting is enabled for the album, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_picasaweb_album_is_commenting_enabled (GDataPicasaWebAlbum *self) { @@ -1122,7 +1122,7 @@ gdata_picasaweb_album_is_commenting_enabled (GDataPicasaWebAlbum *self) * Sets the #GDataPicasaWebAlbum:is-commenting-enabled property to @is_commenting_enabled. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_album_set_is_commenting_enabled (GDataPicasaWebAlbum *self, gboolean is_commenting_enabled) { @@ -1140,7 +1140,7 @@ gdata_picasaweb_album_set_is_commenting_enabled (GDataPicasaWebAlbum *self, gboo * Return value: the number of comments on the album * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_album_get_comment_count (GDataPicasaWebAlbum *self) { @@ -1157,7 +1157,7 @@ gdata_picasaweb_album_get_comment_count (GDataPicasaWebAlbum *self) * Return value: (array zero-terminated=1) (transfer none): a %NULL-terminated array of tags associated with all the photos in the album, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * const * gdata_picasaweb_album_get_tags (GDataPicasaWebAlbum *self) { @@ -1175,7 +1175,7 @@ gdata_picasaweb_album_get_tags (GDataPicasaWebAlbum *self) * Set @tags to %NULL to unset the album's tag list. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_album_set_tags (GDataPicasaWebAlbum *self, const gchar * const *tags) { @@ -1194,7 +1194,7 @@ gdata_picasaweb_album_set_tags (GDataPicasaWebAlbum *self, const gchar * const * * Return value: (element-type GData.MediaContent) (transfer none): a #GList of #GDataMediaContent items * * Since: 0.4.0 - **/ + */ GList * gdata_picasaweb_album_get_contents (GDataPicasaWebAlbum *self) { @@ -1211,7 +1211,7 @@ gdata_picasaweb_album_get_contents (GDataPicasaWebAlbum *self) * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL * * Since: 0.4.0 - **/ + */ GList * gdata_picasaweb_album_get_thumbnails (GDataPicasaWebAlbum *self) { @@ -1230,7 +1230,7 @@ gdata_picasaweb_album_get_thumbnails (GDataPicasaWebAlbum *self) * If the coordinates are unset, @latitude and @longitude will be set to %G_MAXDOUBLE. * * Since: 0.5.0 - **/ + */ void gdata_picasaweb_album_get_coordinates (GDataPicasaWebAlbum *self, gdouble *latitude, gdouble *longitude) { @@ -1252,7 +1252,7 @@ gdata_picasaweb_album_get_coordinates (GDataPicasaWebAlbum *self, gdouble *latit * @latitude and @longitude respectively. * * Since: 0.5.0 - **/ + */ void gdata_picasaweb_album_set_coordinates (GDataPicasaWebAlbum *self, gdouble latitude, gdouble longitude) { diff --git a/gdata/services/picasaweb/gdata-picasaweb-album.h b/gdata/services/picasaweb/gdata-picasaweb-album.h index f09a2de4..9851cb8a 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-album.h +++ b/gdata/services/picasaweb/gdata-picasaweb-album.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Visibility">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ typedef enum { GDATA_PICASAWEB_PUBLIC = 1, GDATA_PICASAWEB_PRIVATE @@ -58,7 +58,7 @@ typedef struct _GDataPicasaWebAlbumPrivate GDataPicasaWebAlbumPrivate; * All the fields in the #GDataPicasaWebAlbum structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataEntry parent; GDataPicasaWebAlbumPrivate *priv; @@ -70,7 +70,7 @@ typedef struct { * All the fields in the #GDataPicasaWebAlbumClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/picasaweb/gdata-picasaweb-feed.c b/gdata/services/picasaweb/gdata-picasaweb-feed.c index f7a4ecc2..d3c1d010 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-feed.c +++ b/gdata/services/picasaweb/gdata-picasaweb-feed.c @@ -28,7 +28,7 @@ * properties which are specific to the Google PicasaWeb API. * * Since: 0.6.0 - **/ + */ #include <glib.h> #include <libxml/parser.h> diff --git a/gdata/services/picasaweb/gdata-picasaweb-feed.h b/gdata/services/picasaweb/gdata-picasaweb-feed.h index 2715bc20..2f7d6c5c 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-feed.h +++ b/gdata/services/picasaweb/gdata-picasaweb-feed.h @@ -41,7 +41,7 @@ G_BEGIN_DECLS * All the fields in the #GDataPicasaWebFeed structure are private and should never be accessed directly. * * Since: 0.6.0 - **/ + */ typedef struct { GDataFeed parent; /*< private >*/ @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataPicasaWebFeedClass structure are private and should never be accessed directly. * * Since: 0.6.0 - **/ + */ typedef struct { /*< private >*/ GDataFeedClass parent; diff --git a/gdata/services/picasaweb/gdata-picasaweb-file.c b/gdata/services/picasaweb/gdata-picasaweb-file.c index 0cbf07a6..dc80c865 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-file.c +++ b/gdata/services/picasaweb/gdata-picasaweb-file.c @@ -90,7 +90,7 @@ * </example> * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -216,7 +216,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FILE_ID, g_param_spec_string ("file-id", "File ID", "The ID of the file.", @@ -232,7 +232,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VERSION, g_param_spec_string ("version", "Version", "The version number of the file.", @@ -248,7 +248,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ALBUM_ID, g_param_spec_string ("album-id", "Album ID", "The ID for the file's album.", @@ -264,7 +264,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CHECKSUM, g_param_spec_string ("checksum", "Checksum", "A checksum of the file, useful for duplicate detection.", @@ -280,7 +280,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VIDEO_STATUS, g_param_spec_string ("video-status", "Video Status", "The status of the file, if it is a video.", @@ -296,7 +296,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_WIDTH, g_param_spec_uint ("width", "Width", "The width of the photo or video, in pixels.", @@ -312,7 +312,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_HEIGHT, g_param_spec_uint ("height", "Height", "The height of the photo or video, in pixels.", @@ -328,7 +328,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SIZE, g_param_spec_ulong ("size", "Size", "The size of the file, in bytes.", @@ -344,7 +344,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * Atom Publishing Protocol specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The time this file was last edited.", @@ -360,7 +360,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMESTAMP, g_param_spec_int64 ("timestamp", "Timestamp", "The time the file was purportedly taken.", @@ -376,7 +376,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_COMMENT_COUNT, g_param_spec_uint ("comment-count", "Comment Count", "The number of comments on the file.", @@ -393,7 +393,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ROTATION, g_param_spec_uint ("rotation", "Rotation", "The rotation of the photo, in degrees.", @@ -406,7 +406,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * Whether commenting is enabled for this file. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_COMMENTING_ENABLED, g_param_spec_boolean ("is-commenting-enabled", "Commenting enabled?", "Indicates whether comments are enabled.", @@ -422,7 +422,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CREDIT, g_param_spec_string ("credit", "Credit", "The nickname of the user credited with this file.", @@ -435,7 +435,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * The file's descriptive caption. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CAPTION, g_param_spec_string ("caption", "Caption", "The file's descriptive caption.", @@ -451,7 +451,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * Media RSS specification</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TAGS, g_param_spec_boxed ("tags", "Tags", "A NULL-terminated array of tags associated with the file.", @@ -467,7 +467,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DISTANCE, g_param_spec_double ("distance", "Distance", "The distance to the subject.", @@ -483,7 +483,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EXPOSURE, g_param_spec_double ("exposure", "Exposure", "The exposure time.", @@ -499,7 +499,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FLASH, g_param_spec_boolean ("flash", "Flash", "Indicates whether the flash was used.", @@ -515,7 +515,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FOCAL_LENGTH, g_param_spec_double ("focal-length", "Focal Length", "The focal length used in the shot.", @@ -532,7 +532,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FSTOP, g_param_spec_double ("fstop", "F-stop", "The F-stop used.", @@ -548,7 +548,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IMAGE_UNIQUE_ID, g_param_spec_string ("image-unique-id", "Image Unique ID", "An unique ID for the image.", @@ -564,7 +564,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink> and ISO 5800:1987. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ISO, g_param_spec_long ("iso", "ISO", "The ISO speed.", @@ -580,7 +580,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MAKE, g_param_spec_string ("make", "Make", "The name of the manufacturer.", @@ -596,7 +596,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * EXIF element reference</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MODEL, g_param_spec_string ("model", "Model", "The model of the camera.", @@ -613,7 +613,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * GeoRSS specification</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LATITUDE, g_param_spec_double ("latitude", "Latitude", "The location as a latitude coordinate associated with this file.", @@ -630,7 +630,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * GeoRSS specification</ulink>. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LONGITUDE, g_param_spec_double ("longitude", "Longitude", "The location as a longitude coordinate associated with this file.", @@ -1117,7 +1117,7 @@ is_comment_deletable (GDataCommentable *self, GDataComment *comment_) * Return value: a new #GDataPicasaWebFile; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataPicasaWebFile * gdata_picasaweb_file_new (const gchar *id) { @@ -1148,7 +1148,7 @@ gdata_picasaweb_file_new (const gchar *id) * Return value: the file's ID * * Since: 0.7.0 - **/ + */ const gchar * gdata_picasaweb_file_get_id (GDataPicasaWebFile *self) { @@ -1165,7 +1165,7 @@ gdata_picasaweb_file_get_id (GDataPicasaWebFile *self) * Return value: the UNIX timestamp for the time the file was last edited, or <code class="literal">-1</code> * * Since: 0.4.0 - **/ + */ gint64 gdata_picasaweb_file_get_edited (GDataPicasaWebFile *self) { @@ -1182,7 +1182,7 @@ gdata_picasaweb_file_get_edited (GDataPicasaWebFile *self) * Return value: the file's version number, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_file_get_version (GDataPicasaWebFile *self) { @@ -1199,7 +1199,7 @@ gdata_picasaweb_file_get_version (GDataPicasaWebFile *self) * Return value: the ID of the album containing the #GDataPicasaWebFile * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_file_get_album_id (GDataPicasaWebFile *self) { @@ -1215,7 +1215,7 @@ gdata_picasaweb_file_get_album_id (GDataPicasaWebFile *self) * Sets the #GDataPicasaWebFile:album-id property, effectively moving the file to the album. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_album_id (GDataPicasaWebFile *self, const gchar *album_id) { @@ -1236,7 +1236,7 @@ gdata_picasaweb_file_set_album_id (GDataPicasaWebFile *self, const gchar *album_ * Return value: the width of the image or video, in pixels * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_file_get_width (GDataPicasaWebFile *self) { @@ -1253,7 +1253,7 @@ gdata_picasaweb_file_get_width (GDataPicasaWebFile *self) * Return value: the height of the image or video, in pixels * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_file_get_height (GDataPicasaWebFile *self) { @@ -1270,7 +1270,7 @@ gdata_picasaweb_file_get_height (GDataPicasaWebFile *self) * Return value: the size of the file, in bytes * * Since: 0.4.0 - **/ + */ gsize gdata_picasaweb_file_get_size (GDataPicasaWebFile *self) { @@ -1287,7 +1287,7 @@ gdata_picasaweb_file_get_size (GDataPicasaWebFile *self) * Return value: the checksum assigned to this file, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_file_get_checksum (GDataPicasaWebFile *self) { @@ -1305,7 +1305,7 @@ gdata_picasaweb_file_get_checksum (GDataPicasaWebFile *self) * Set @checksum to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_checksum (GDataPicasaWebFile *self, const gchar *checksum) { @@ -1326,7 +1326,7 @@ gdata_picasaweb_file_set_checksum (GDataPicasaWebFile *self, const gchar *checks * Return value: the UNIX timestamp for the timestamp property in milliseconds, or <code class="literal">-1</code> * * Since: 0.4.0 - **/ + */ gint64 gdata_picasaweb_file_get_timestamp (GDataPicasaWebFile *self) { @@ -1343,7 +1343,7 @@ gdata_picasaweb_file_get_timestamp (GDataPicasaWebFile *self) * @timestamp is <code class="literal">-1</code>, the property will be unset. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_timestamp (GDataPicasaWebFile *self, gint64 timestamp) { @@ -1368,7 +1368,7 @@ gdata_picasaweb_file_set_timestamp (GDataPicasaWebFile *self, gint64 timestamp) * Return value: %TRUE if commenting is enabled, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_picasaweb_file_is_commenting_enabled (GDataPicasaWebFile *self) { @@ -1384,7 +1384,7 @@ gdata_picasaweb_file_is_commenting_enabled (GDataPicasaWebFile *self) * Sets the #GDataPicasaWebFile:is-commenting-enabled property to @is_commenting_enabled. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_is_commenting_enabled (GDataPicasaWebFile *self, gboolean is_commenting_enabled) { @@ -1402,7 +1402,7 @@ gdata_picasaweb_file_set_is_commenting_enabled (GDataPicasaWebFile *self, gboole * Return value: the number of comments on the file * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_file_get_comment_count (GDataPicasaWebFile *self) { @@ -1419,7 +1419,7 @@ gdata_picasaweb_file_get_comment_count (GDataPicasaWebFile *self) * Return value: the image's rotation, in degrees * * Since: 0.4.0 - **/ + */ guint gdata_picasaweb_file_get_rotation (GDataPicasaWebFile *self) { @@ -1438,7 +1438,7 @@ gdata_picasaweb_file_get_rotation (GDataPicasaWebFile *self) * so calling it with 90° then 20° will result in a final rotation of 20°. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_rotation (GDataPicasaWebFile *self, guint rotation) { @@ -1457,7 +1457,7 @@ gdata_picasaweb_file_set_rotation (GDataPicasaWebFile *self, guint rotation) * Return value: the status of this video ("pending", "ready", "final" or "failed"), or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_file_get_video_status (GDataPicasaWebFile *self) { @@ -1474,7 +1474,7 @@ gdata_picasaweb_file_get_video_status (GDataPicasaWebFile *self) * Return value: (array zero-terminated=1) (transfer none): a %NULL-terminated array of tags associated with the file, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * const * gdata_picasaweb_file_get_tags (GDataPicasaWebFile *self) { @@ -1492,7 +1492,7 @@ gdata_picasaweb_file_get_tags (GDataPicasaWebFile *self) * Set @tags to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_tags (GDataPicasaWebFile *self, const gchar * const *tags) { @@ -1511,7 +1511,7 @@ gdata_picasaweb_file_set_tags (GDataPicasaWebFile *self, const gchar * const *ta * Return value: the nickname of the user credited with this file * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_file_get_credit (GDataPicasaWebFile *self) { @@ -1532,7 +1532,7 @@ gdata_picasaweb_file_get_credit (GDataPicasaWebFile *self) * Return value: the file's descriptive caption, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_file_get_caption (GDataPicasaWebFile *self) { @@ -1550,7 +1550,7 @@ gdata_picasaweb_file_get_caption (GDataPicasaWebFile *self) * Set @caption to %NULL to unset the file's caption. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_file_set_caption (GDataPicasaWebFile *self, const gchar *caption) { @@ -1570,7 +1570,7 @@ gdata_picasaweb_file_set_caption (GDataPicasaWebFile *self, const gchar *caption * Return value: (element-type GData.MediaContent) (transfer none): a #GList of #GDataMediaContent items * * Since: 0.4.0 - **/ + */ GList * gdata_picasaweb_file_get_contents (GDataPicasaWebFile *self) { @@ -1591,7 +1591,7 @@ gdata_picasaweb_file_get_contents (GDataPicasaWebFile *self) * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL * * Since: 0.4.0 - **/ + */ GList * gdata_picasaweb_file_get_thumbnails (GDataPicasaWebFile *self) { @@ -1608,7 +1608,7 @@ gdata_picasaweb_file_get_thumbnails (GDataPicasaWebFile *self) * Return value: the distance recorded in the photo's EXIF, or <code class="literal">-1</code> if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_picasaweb_file_get_distance (GDataPicasaWebFile *self) { @@ -1625,7 +1625,7 @@ gdata_picasaweb_file_get_distance (GDataPicasaWebFile *self) * Return value: the exposure value, or <code class="literal">0</code> if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_picasaweb_file_get_exposure (GDataPicasaWebFile *self) { @@ -1642,7 +1642,7 @@ gdata_picasaweb_file_get_exposure (GDataPicasaWebFile *self) * Return value: %TRUE if flash was used, %FALSE otherwise * * Since: 0.5.0 - **/ + */ gboolean gdata_picasaweb_file_get_flash (GDataPicasaWebFile *self) { @@ -1659,7 +1659,7 @@ gdata_picasaweb_file_get_flash (GDataPicasaWebFile *self) * Return value: the focal-length value, or <code class="literal">-1</code> if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_picasaweb_file_get_focal_length (GDataPicasaWebFile *self) { @@ -1676,7 +1676,7 @@ gdata_picasaweb_file_get_focal_length (GDataPicasaWebFile *self) * Return value: the F-stop value, or <code class="literal">0</code> if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_picasaweb_file_get_fstop (GDataPicasaWebFile *self) { @@ -1693,7 +1693,7 @@ gdata_picasaweb_file_get_fstop (GDataPicasaWebFile *self) * Return value: the photo's unique EXIF identifier, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_picasaweb_file_get_image_unique_id (GDataPicasaWebFile *self) { @@ -1710,7 +1710,7 @@ gdata_picasaweb_file_get_image_unique_id (GDataPicasaWebFile *self) * Return value: the ISO speed, or <code class="literal">-1</code> if unknown * * Since: 0.5.0 - **/ + */ gint gdata_picasaweb_file_get_iso (GDataPicasaWebFile *self) { @@ -1727,7 +1727,7 @@ gdata_picasaweb_file_get_iso (GDataPicasaWebFile *self) * Return value: the name of the manufacturer of the camera, or %NULL if unknown * * Since: 0.5.0 - **/ + */ const gchar * gdata_picasaweb_file_get_make (GDataPicasaWebFile *self) { @@ -1744,7 +1744,7 @@ gdata_picasaweb_file_get_make (GDataPicasaWebFile *self) * Return value: the model name of the camera, or %NULL if unknown * * Since: 0.5.0 - **/ + */ const gchar * gdata_picasaweb_file_get_model (GDataPicasaWebFile *self) { @@ -1763,7 +1763,7 @@ gdata_picasaweb_file_get_model (GDataPicasaWebFile *self) * @latitude and @longitude will be set to %G_MAXDOUBLE. * * Since: 0.5.0 - **/ + */ void gdata_picasaweb_file_get_coordinates (GDataPicasaWebFile *self, gdouble *latitude, gdouble *longitude) { @@ -1785,7 +1785,7 @@ gdata_picasaweb_file_get_coordinates (GDataPicasaWebFile *self, gdouble *latitud * @latitude and @longitude respectively. * * Since: 0.5.0 - **/ + */ void gdata_picasaweb_file_set_coordinates (GDataPicasaWebFile *self, gdouble latitude, gdouble longitude) { diff --git a/gdata/services/picasaweb/gdata-picasaweb-file.h b/gdata/services/picasaweb/gdata-picasaweb-file.h index 638d49ad..ca129dea 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-file.h +++ b/gdata/services/picasaweb/gdata-picasaweb-file.h @@ -35,7 +35,7 @@ G_BEGIN_DECLS * The video is still being processed. * * Since: 0.7.0 - **/ + */ #define GDATA_PICASAWEB_VIDEO_STATUS_PENDING "pending" /** @@ -44,7 +44,7 @@ G_BEGIN_DECLS * The video has been processed, but still needs thumbnailing. * * Since: 0.7.0 - **/ + */ #define GDATA_PICASAWEB_VIDEO_STATUS_READY "ready" /** @@ -53,7 +53,7 @@ G_BEGIN_DECLS * The video has been processed and thumbnailed. * * Since: 0.7.0 - **/ + */ #define GDATA_PICASAWEB_VIDEO_STATUS_FINAL "final" /** @@ -62,7 +62,7 @@ G_BEGIN_DECLS * There was an error while processing or thumbnailing the video and it should be deleted. * * Since: 0.7.0 - **/ + */ #define GDATA_PICASAWEB_VIDEO_STATUS_FAILED "failed" #define GDATA_TYPE_PICASAWEB_FILE (gdata_picasaweb_file_get_type ()) @@ -80,7 +80,7 @@ typedef struct _GDataPicasaWebFilePrivate GDataPicasaWebFilePrivate; * All the fields in the #GDataPicasaWebFile structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataEntry parent; GDataPicasaWebFilePrivate *priv; @@ -92,7 +92,7 @@ typedef struct { * All the fields in the #GDataPicasaWebFileClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/picasaweb/gdata-picasaweb-query.c b/gdata/services/picasaweb/gdata-picasaweb-query.c index 0e8cce54..d459748f 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-query.c +++ b/gdata/services/picasaweb/gdata-picasaweb-query.c @@ -31,7 +31,7 @@ * url="http://code.google.com/apis/picasaweb/reference.html#Parameters">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -98,7 +98,7 @@ gdata_picasaweb_query_class_init (GDataPicasaWebQueryClass *klass) * online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VISIBILITY, g_param_spec_int ("visibility", "Visibility", "Specifies which albums should be listed, in terms of their visibility.", @@ -113,7 +113,7 @@ gdata_picasaweb_query_class_init (GDataPicasaWebQueryClass *klass) * <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Parameters">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_THUMBNAIL_SIZE, g_param_spec_string ("thumbnail-size", "Thumbnail size", "A comma-separated list of thumbnail width (in pixels) to return.", @@ -128,7 +128,7 @@ gdata_picasaweb_query_class_init (GDataPicasaWebQueryClass *klass) * <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Parameters">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IMAGE_SIZE, g_param_spec_string ("image-size", "Image size", "A comma-separated list of image sizes (width in pixels) to return.", @@ -141,7 +141,7 @@ gdata_picasaweb_query_class_init (GDataPicasaWebQueryClass *klass) * A tag which returned results must contain. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TAG, g_param_spec_string ("tag", "Tag", "A tag which returned results must contain.", @@ -154,7 +154,7 @@ gdata_picasaweb_query_class_init (GDataPicasaWebQueryClass *klass) * A location to search for photos, e.g. "London". * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LOCATION, g_param_spec_string ("location", "Location", "A location to search for photos, e.g. \"London\".", @@ -305,7 +305,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Return value: a new #GDataPicasaWebQuery * * Since: 0.4.0 - **/ + */ GDataPicasaWebQuery * gdata_picasaweb_query_new (const gchar *q) { @@ -329,7 +329,7 @@ gdata_picasaweb_query_new (const gchar *q) * Return value: a new #GDataPicasaWebQuery * * Since: 0.6.0 - **/ + */ GDataPicasaWebQuery * gdata_picasaweb_query_new_with_limits (const gchar *q, guint start_index, guint max_results) { @@ -349,7 +349,7 @@ gdata_picasaweb_query_new_with_limits (const gchar *q, guint start_index, guint * Return value: the visibility of the objects to retrieve, or <code class="literal">0</code> to retrieve all objects * * Since: 0.4.0 - **/ + */ GDataPicasaWebVisibility gdata_picasaweb_query_get_visibility (GDataPicasaWebQuery *self) { @@ -365,7 +365,7 @@ gdata_picasaweb_query_get_visibility (GDataPicasaWebQuery *self) * Sets the #GDataPicasaWebQuery:visibility property to @visibility. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_set_visibility (GDataPicasaWebQuery *self, GDataPicasaWebVisibility visibility) { @@ -386,7 +386,7 @@ gdata_picasaweb_query_set_visibility (GDataPicasaWebQuery *self, GDataPicasaWebV * Return value: a comma-separated list of thumbnail sizes to retrieve, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_query_get_thumbnail_size (GDataPicasaWebQuery *self) { @@ -404,7 +404,7 @@ gdata_picasaweb_query_get_thumbnail_size (GDataPicasaWebQuery *self) * Set @thumbnail_size to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_set_thumbnail_size (GDataPicasaWebQuery *self, const gchar *thumbnail_size) { @@ -427,7 +427,7 @@ gdata_picasaweb_query_set_thumbnail_size (GDataPicasaWebQuery *self, const gchar * Return value: the currently set desired image size for retrieval, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_query_get_image_size (GDataPicasaWebQuery *self) { @@ -447,7 +447,7 @@ gdata_picasaweb_query_get_image_size (GDataPicasaWebQuery *self) * Set @image_size to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_set_image_size (GDataPicasaWebQuery *self, const gchar *image_size) { @@ -470,7 +470,7 @@ gdata_picasaweb_query_set_image_size (GDataPicasaWebQuery *self, const gchar *im * Return value: a tag which retrieved objects must have, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_query_get_tag (GDataPicasaWebQuery *self) { @@ -488,7 +488,7 @@ gdata_picasaweb_query_get_tag (GDataPicasaWebQuery *self) * Set @tag to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_set_tag (GDataPicasaWebQuery *self, const gchar *tag) { @@ -513,7 +513,7 @@ gdata_picasaweb_query_set_tag (GDataPicasaWebQuery *self, const gchar *tag) * Gets the latitudes and longitudes of a bounding box, inside which all the results must lie. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_get_bounding_box (GDataPicasaWebQuery *self, gdouble *north, gdouble *east, gdouble *south, gdouble *west) { @@ -542,7 +542,7 @@ gdata_picasaweb_query_get_bounding_box (GDataPicasaWebQuery *self, gdouble *nort * Set @north, @east, @south and @west to <code class="literal">0</code> to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_set_bounding_box (GDataPicasaWebQuery *self, gdouble north, gdouble east, gdouble south, gdouble west) { @@ -570,7 +570,7 @@ gdata_picasaweb_query_set_bounding_box (GDataPicasaWebQuery *self, gdouble north * Return value: a location which returned objects must be near, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_picasaweb_query_get_location (GDataPicasaWebQuery *self) { @@ -588,7 +588,7 @@ gdata_picasaweb_query_get_location (GDataPicasaWebQuery *self) * Set @location to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_picasaweb_query_set_location (GDataPicasaWebQuery *self, const gchar *location) { diff --git a/gdata/services/picasaweb/gdata-picasaweb-query.h b/gdata/services/picasaweb/gdata-picasaweb-query.h index 12e428da..f6f40468 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-query.h +++ b/gdata/services/picasaweb/gdata-picasaweb-query.h @@ -44,7 +44,7 @@ typedef struct _GDataPicasaWebQueryPrivate GDataPicasaWebQueryPrivate; * All the fields in the #GDataPicasaWebQuery structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataQuery parent; GDataPicasaWebQueryPrivate *priv; @@ -56,7 +56,7 @@ typedef struct { * All the fields in the #GDataPicasaWebQueryClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataQueryClass parent; diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.c b/gdata/services/picasaweb/gdata-picasaweb-service.c index ee0ef4d1..914b403f 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-service.c +++ b/gdata/services/picasaweb/gdata-picasaweb-service.c @@ -107,7 +107,7 @@ * * * Since: 0.4.0 - **/ + */ #include <config.h> #include <glib.h> @@ -226,7 +226,7 @@ create_uri (GDataPicasaWebService *self, const gchar *username, const gchar *typ * Return value: (transfer full): a #GDataPicasaWebUser; unref with g_object_unref() * * Since: 0.6.0 - **/ + */ GDataPicasaWebUser * gdata_picasaweb_service_get_user (GDataPicasaWebService *self, const gchar *username, GCancellable *cancellable, GError **error) { @@ -368,7 +368,7 @@ gdata_picasaweb_service_get_user_finish (GDataPicasaWebService *self, GAsyncResu * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataFeed * gdata_picasaweb_service_query_all_albums (GDataPicasaWebService *self, GDataQuery *query, const gchar *username, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -424,7 +424,7 @@ gdata_picasaweb_service_query_all_albums (GDataPicasaWebService *self, GDataQuer * this function, and gdata_service_query_async(), which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_picasaweb_service_query_all_albums_async (GDataPicasaWebService *self, GDataQuery *query, const gchar *username, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -502,7 +502,7 @@ get_query_files_uri (GDataPicasaWebAlbum *album, GError **error) * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataFeed * gdata_picasaweb_service_query_files (GDataPicasaWebService *self, GDataPicasaWebAlbum *album, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -545,7 +545,7 @@ gdata_picasaweb_service_query_files (GDataPicasaWebService *self, GDataPicasaWeb * which is the base asynchronous query function. * * Since: 0.9.1 - **/ + */ void gdata_picasaweb_service_query_files_async (GDataPicasaWebService *self, GDataPicasaWebAlbum *album, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -604,7 +604,7 @@ gdata_picasaweb_service_query_files_async (GDataPicasaWebService *self, GDataPic * Return value: (transfer full): a #GDataUploadStream to write the file data to, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataUploadStream * gdata_picasaweb_service_upload_file (GDataPicasaWebService *self, GDataPicasaWebAlbum *album, GDataPicasaWebFile *file_entry, const gchar *slug, const gchar *content_type, GCancellable *cancellable, GError **error) @@ -695,7 +695,7 @@ gdata_picasaweb_service_finish_file_upload (GDataPicasaWebService *self, GDataUp * g_object_unref() * * Since: 0.6.0 - **/ + */ GDataPicasaWebAlbum * gdata_picasaweb_service_insert_album (GDataPicasaWebService *self, GDataPicasaWebAlbum *album, GCancellable *cancellable, GError **error) { @@ -740,7 +740,7 @@ gdata_picasaweb_service_insert_album (GDataPicasaWebService *self, GDataPicasaWe * gdata_service_insert_entry_async(), which is the base asynchronous insertion function. * * Since: 0.8.0 - **/ + */ void gdata_picasaweb_service_insert_album_async (GDataPicasaWebService *self, GDataPicasaWebAlbum *album, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.h b/gdata/services/picasaweb/gdata-picasaweb-service.h index da3b8bc1..377e7cc9 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-service.h +++ b/gdata/services/picasaweb/gdata-picasaweb-service.h @@ -44,7 +44,7 @@ G_BEGIN_DECLS * All the fields in the #GDataPicasaWebService structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { GDataService parent; } GDataPicasaWebService; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataPicasaWebServiceClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataServiceClass parent; diff --git a/gdata/services/picasaweb/gdata-picasaweb-user.c b/gdata/services/picasaweb/gdata-picasaweb-user.c index 8062656f..38db73f6 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-user.c +++ b/gdata/services/picasaweb/gdata-picasaweb-user.c @@ -28,7 +28,7 @@ * properties which are specific to the Google PicasaWeb API. * * Since: 0.6.0 - **/ + */ #include <glib.h> #include <libxml/parser.h> @@ -274,7 +274,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: the feed's user, or %NULL * * Since: 0.6.0 - **/ + */ const gchar * gdata_picasaweb_user_get_user (GDataPicasaWebUser *self) { @@ -291,7 +291,7 @@ gdata_picasaweb_user_get_user (GDataPicasaWebUser *self) * Return value: the nickname of the feed's user's nickname, or %NULL * * Since: 0.6.0 - **/ + */ const gchar * gdata_picasaweb_user_get_nickname (GDataPicasaWebUser *self) { @@ -310,7 +310,7 @@ gdata_picasaweb_user_get_nickname (GDataPicasaWebUser *self) * Return value: the maximum capacity in bytes for this feed's account, or <code class="literal">-1</code> * * Since: 0.6.0 - **/ + */ gint64 gdata_picasaweb_user_get_quota_limit (GDataPicasaWebUser *self) { @@ -329,7 +329,7 @@ gdata_picasaweb_user_get_quota_limit (GDataPicasaWebUser *self) * Return value: the current number of bytes in use by this feed's account, or <code class="literal">-1</code> * * Since: 0.6.0 - **/ + */ gint64 gdata_picasaweb_user_get_quota_current (GDataPicasaWebUser *self) { @@ -348,7 +348,7 @@ gdata_picasaweb_user_get_quota_current (GDataPicasaWebUser *self) * Return value: the maximum number of photos an album for this account can hold, or <code class="literal">-1</code> * * Since: 0.6.0 - **/ + */ gint gdata_picasaweb_user_get_max_photos_per_album (GDataPicasaWebUser *self) { @@ -365,7 +365,7 @@ gdata_picasaweb_user_get_max_photos_per_album (GDataPicasaWebUser *self) * Return value: the URI for the thumbnail of the account, or %NULL * * Since: 0.6.0 - **/ + */ const gchar * gdata_picasaweb_user_get_thumbnail_uri (GDataPicasaWebUser *self) { diff --git a/gdata/services/picasaweb/gdata-picasaweb-user.h b/gdata/services/picasaweb/gdata-picasaweb-user.h index 93753192..8757a69c 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-user.h +++ b/gdata/services/picasaweb/gdata-picasaweb-user.h @@ -44,7 +44,7 @@ typedef struct _GDataPicasaWebUserPrivate GDataPicasaWebUserPrivate; * All the fields in the #GDataPicasaWebUser structure are private and should never be accessed directly. * * Since: 0.6.0 - **/ + */ typedef struct { GDataEntry parent; GDataPicasaWebUserPrivate *priv; @@ -56,7 +56,7 @@ typedef struct { * All the fields in the #GDataPicasaWebUserClass structure are private and should never be accessed directly. * * Since: 0.6.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/services/youtube/gdata-youtube-category.c b/gdata/services/youtube/gdata-youtube-category.c index c28ab614..20af9102 100644 --- a/gdata/services/youtube/gdata-youtube-category.c +++ b/gdata/services/youtube/gdata-youtube-category.c @@ -28,7 +28,7 @@ * online documentation</ulink>. * * Since: 0.7.0 - **/ + */ #include <glib.h> #include <libxml/parser.h> @@ -77,7 +77,7 @@ gdata_youtube_category_class_init (GDataYouTubeCategoryClass *klass) * Whether new videos can be added to the category. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_ASSIGNABLE, g_param_spec_boolean ("is-assignable", "Assignable?", "Whether new videos can be added to the category.", @@ -90,7 +90,7 @@ gdata_youtube_category_class_init (GDataYouTubeCategoryClass *klass) * Whether the category is deprecated. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_DEPRECATED, g_param_spec_boolean ("is-deprecated", "Deprecated?", "Whether the category is deprecated.", @@ -186,7 +186,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: whether new videos can be assigned to the category * * Since: 0.7.0 - **/ + */ gboolean gdata_youtube_category_is_assignable (GDataYouTubeCategory *self) { @@ -205,7 +205,7 @@ gdata_youtube_category_is_assignable (GDataYouTubeCategory *self) * Return value: whether the category is browsable in @region * * Since: 0.7.0 - **/ + */ gboolean gdata_youtube_category_is_browsable (GDataYouTubeCategory *self, const gchar *region) { @@ -233,7 +233,7 @@ gdata_youtube_category_is_browsable (GDataYouTubeCategory *self, const gchar *re * Return value: whether the category is deprecated * * Since: 0.7.0 - **/ + */ gboolean gdata_youtube_category_is_deprecated (GDataYouTubeCategory *self) { diff --git a/gdata/services/youtube/gdata-youtube-category.h b/gdata/services/youtube/gdata-youtube-category.h index d29fbdbb..7b10661c 100644 --- a/gdata/services/youtube/gdata-youtube-category.h +++ b/gdata/services/youtube/gdata-youtube-category.h @@ -43,7 +43,7 @@ typedef struct _GDataYouTubeCategoryPrivate GDataYouTubeCategoryPrivate; * All the fields in the #GDataYouTubeCategory structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataCategory parent; GDataYouTubeCategoryPrivate *priv; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataYouTubeCategoryClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataCategoryClass parent; diff --git a/gdata/services/youtube/gdata-youtube-content.c b/gdata/services/youtube/gdata-youtube-content.c index 04d51ed8..3b9126e7 100644 --- a/gdata/services/youtube/gdata-youtube-content.c +++ b/gdata/services/youtube/gdata-youtube-content.c @@ -30,7 +30,7 @@ * Since: 0.4.0 * Deprecated: 0.17.0: Accessing YouTube video content directly is no longer * supported by Google. There is no replacement. - **/ + */ #include <glib.h> #include <libxml/parser.h> @@ -81,7 +81,7 @@ gdata_youtube_content_class_init (GDataYouTubeContentClass *klass) * Since: 0.4.0 * Deprecated: 0.17.0: Accessing YouTube video content directly is * no longer supported by Google. There is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_FORMAT, g_param_spec_enum ("format", "Format", "The video format of the video object.", @@ -146,7 +146,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Since: 0.4.0 * Deprecated: 0.17.0: Accessing YouTube video content directly is no longer * supported by Google. There is no replacement. - **/ + */ GDataYouTubeFormat gdata_youtube_content_get_format (GDataYouTubeContent *self) { diff --git a/gdata/services/youtube/gdata-youtube-content.h b/gdata/services/youtube/gdata-youtube-content.h index b65af1a1..1a34d0d0 100644 --- a/gdata/services/youtube/gdata-youtube-content.h +++ b/gdata/services/youtube/gdata-youtube-content.h @@ -43,7 +43,7 @@ G_BEGIN_DECLS * Since: 0.3.0 * Deprecated: 0.17.0: Accessing YouTube video content directly is no longer * supported by Google. There is no replacement. - **/ + */ typedef enum { GDATA_YOUTUBE_FORMAT_UNKNOWN = 0, GDATA_YOUTUBE_FORMAT_RTSP_H263_AMR = 1, @@ -68,7 +68,7 @@ typedef struct _GDataYouTubeContentPrivate GDataYouTubeContentPrivate G_GNUC_DEP * Since: 0.4.0 * Deprecated: 0.17.0: Accessing YouTube video content directly is no longer * supported by Google. There is no replacement. - **/ + */ typedef struct { G_GNUC_BEGIN_IGNORE_DEPRECATIONS GDataMediaContent parent; @@ -84,7 +84,7 @@ typedef struct { * Since: 0.4.0 * Deprecated: 0.17.0: Accessing YouTube video content directly is no longer * supported by Google. There is no replacement. - **/ + */ typedef struct { /*< private >*/ GDataMediaContentClass parent; diff --git a/gdata/services/youtube/gdata-youtube-credit.c b/gdata/services/youtube/gdata-youtube-credit.c index de587df0..b1b7f603 100644 --- a/gdata/services/youtube/gdata-youtube-credit.c +++ b/gdata/services/youtube/gdata-youtube-credit.c @@ -30,7 +30,7 @@ * Since: 0.4.0 * Deprecated: 0.17.0: This is no longer supported by Google. There is no * replacement. - **/ + */ #include <glib.h> #include <libxml/parser.h> @@ -84,7 +84,7 @@ gdata_youtube_credit_class_init (GDataYouTubeCreditClass *klass) * Since: 0.4.0 * Deprecated: 0.17.0: This is no longer supported by Google. There * is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_ENTITY_TYPE, g_param_spec_string ("entity-type", "Entity type", "The type of entity who is credited.", @@ -168,7 +168,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Since: 0.4.0 * Deprecated: 0.17.0: This is no longer supported by Google. There is no * replacement. - **/ + */ const gchar * gdata_youtube_credit_get_entity_type (GDataYouTubeCredit *self) { diff --git a/gdata/services/youtube/gdata-youtube-credit.h b/gdata/services/youtube/gdata-youtube-credit.h index 4065b648..da316306 100644 --- a/gdata/services/youtube/gdata-youtube-credit.h +++ b/gdata/services/youtube/gdata-youtube-credit.h @@ -38,7 +38,7 @@ G_BEGIN_DECLS * Since: 0.7.0 * Deprecated: 0.17.0: This is no longer supported by Google. There is no * replacement. - **/ + */ #define GDATA_YOUTUBE_CREDIT_ENTITY_PARTNER "partner" #define GDATA_TYPE_YOUTUBE_CREDIT (gdata_youtube_credit_get_type ()) @@ -58,7 +58,7 @@ typedef struct _GDataYouTubeCreditPrivate GDataYouTubeCreditPrivate G_GNUC_DEPRE * Since: 0.4.0 * Deprecated: 0.17.0: This is no longer supported by Google. There is no * replacement. - **/ + */ typedef struct { G_GNUC_BEGIN_IGNORE_DEPRECATIONS GDataMediaCredit parent; @@ -74,7 +74,7 @@ typedef struct { * Since: 0.4.0 * Deprecated: 0.17.0: This is no longer supported by Google. There is no * replacement. - **/ + */ typedef struct { /*< private >*/ GDataMediaCreditClass parent; diff --git a/gdata/services/youtube/gdata-youtube-query.c b/gdata/services/youtube/gdata-youtube-query.c index e52683f3..b15d01eb 100644 --- a/gdata/services/youtube/gdata-youtube-query.c +++ b/gdata/services/youtube/gdata-youtube-query.c @@ -35,7 +35,7 @@ * url="https://developers.google.com/youtube/v3/docs/search/list#parameters">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ #include <config.h> #include <glib.h> @@ -111,7 +111,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_FORMAT, g_param_spec_enum ("format", "Format", "Specifies that videos must be available in a particular video format.", @@ -137,7 +137,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * url="https://developers.google.com/youtube/v3/docs/search/list#location">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LATITUDE, g_param_spec_double ("latitude", "Latitude", "The latitude of a particular location of which videos should be found.", @@ -155,7 +155,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * For more information, see the documentation for #GDataYouTubeQuery:latitude. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LONGITUDE, g_param_spec_double ("longitude", "Longitude", "The longitude of a particular location of which videos should be found.", @@ -173,7 +173,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * For more information, see the documentation for #GDataYouTubeQuery:latitude. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LOCATION_RADIUS, g_param_spec_double ("location-radius", "Location radius", "The radius, in metres, of a circle to search within.", @@ -193,7 +193,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. - **/ + */ g_object_class_install_property (gobject_class, PROP_HAS_LOCATION, g_param_spec_boolean ("has-location", "Has location?", "Whether to restrict results to videos with specific coordinates.", @@ -214,7 +214,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_LANGUAGE, g_param_spec_string ("language", "Language", "Restricts the search to videos described in the given language.", @@ -236,7 +236,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * url="https://developers.google.com/youtube/v3/docs/search/list#order">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ORDER_BY, g_param_spec_string ("order-by", "Order by", "Specifies the order of entries in a feed.", @@ -258,7 +258,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * url="https://developers.google.com/youtube/v3/docs/search/list#regionCode">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RESTRICTION, g_param_spec_string ("restriction", "Restriction", "The country code to filter videos playable only in specific countries.", @@ -274,7 +274,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * url="https://developers.google.com/youtube/v3/docs/search/list#safeSearch">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SAFE_SEARCH, g_param_spec_enum ("safe-search", "Safe search", "Whether the search results should include restricted content.", @@ -289,7 +289,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_SORT_ORDER, g_param_spec_enum ("sort-order", "Sort order", "Specifies the direction of sorting.", @@ -304,7 +304,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * age, set the property to %GDATA_YOUTUBE_AGE_ALL_TIME. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_AGE, g_param_spec_enum ("age", "Age", "Restricts the search to videos uploaded within the specified time period.", @@ -320,7 +320,7 @@ gdata_youtube_query_class_init (GDataYouTubeQueryClass *klass) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_UPLOADER, g_param_spec_enum ("uploader", "Uploader", "Restricts the search to videos from the specified type of uploader.", @@ -675,7 +675,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Return value: a new #GDataYouTubeQuery * * Since: 0.3.0 - **/ + */ GDataYouTubeQuery * gdata_youtube_query_new (const gchar *q) { @@ -695,7 +695,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ GDataYouTubeFormat gdata_youtube_query_get_format (GDataYouTubeQuery *self) { @@ -713,7 +713,7 @@ gdata_youtube_query_get_format (GDataYouTubeQuery *self) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ void gdata_youtube_query_set_format (GDataYouTubeQuery *self, GDataYouTubeFormat format) { @@ -740,7 +740,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS * #GDataYouTubeQuery:location-radius and #GDataYouTubeQuery:has-location. * * Since: 0.3.0 - **/ + */ void gdata_youtube_query_get_location (GDataYouTubeQuery *self, gdouble *latitude, gdouble *longitude, gdouble *radius, gboolean *has_location) { @@ -768,7 +768,7 @@ gdata_youtube_query_get_location (GDataYouTubeQuery *self, gdouble *latitude, gd * #GDataYouTubeQuery:location-radius and #GDataYouTubeQuery:has-location. * * Since: 0.3.0 - **/ + */ void gdata_youtube_query_set_location (GDataYouTubeQuery *self, gdouble latitude, gdouble longitude, gdouble radius, gboolean has_location) { @@ -801,7 +801,7 @@ gdata_youtube_query_set_location (GDataYouTubeQuery *self, gdouble latitude, gdo * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ const gchar * gdata_youtube_query_get_language (GDataYouTubeQuery *self) { @@ -821,7 +821,7 @@ gdata_youtube_query_get_language (GDataYouTubeQuery *self) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ void gdata_youtube_query_set_language (GDataYouTubeQuery *self, const gchar *language) { @@ -843,7 +843,7 @@ gdata_youtube_query_set_language (GDataYouTubeQuery *self, const gchar *language * Return value: the order by property, or %NULL if it is unset * * Since: 0.3.0 - **/ + */ const gchar * gdata_youtube_query_get_order_by (GDataYouTubeQuery *self) { @@ -861,7 +861,7 @@ gdata_youtube_query_get_order_by (GDataYouTubeQuery *self) * Set @order_by to %NULL to unset the property in the query URI. * * Since: 0.3.0 - **/ + */ void gdata_youtube_query_set_order_by (GDataYouTubeQuery *self, const gchar *order_by) { @@ -884,7 +884,7 @@ gdata_youtube_query_set_order_by (GDataYouTubeQuery *self, const gchar *order_by * Return value: the restriction property, or %NULL if it is unset * * Since: 0.3.0 - **/ + */ const gchar * gdata_youtube_query_get_restriction (GDataYouTubeQuery *self) { @@ -902,7 +902,7 @@ gdata_youtube_query_get_restriction (GDataYouTubeQuery *self) * Set @restriction to %NULL to unset the property in the query URI. * * Since: 0.3.0 - **/ + */ void gdata_youtube_query_set_restriction (GDataYouTubeQuery *self, const gchar *restriction) { @@ -924,7 +924,7 @@ gdata_youtube_query_set_restriction (GDataYouTubeQuery *self, const gchar *restr * Return value: the safe search property * * Since: 0.3.0 - **/ + */ GDataYouTubeSafeSearch gdata_youtube_query_get_safe_search (GDataYouTubeQuery *self) { @@ -940,7 +940,7 @@ gdata_youtube_query_get_safe_search (GDataYouTubeQuery *self) * Sets the #GDataYouTubeQuery:safe-search property of the #GDataYouTubeQuery to @safe_search. * * Since: 0.3.0 - **/ + */ void gdata_youtube_query_set_safe_search (GDataYouTubeQuery *self, GDataYouTubeSafeSearch safe_search) { @@ -965,7 +965,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ GDataYouTubeSortOrder gdata_youtube_query_get_sort_order (GDataYouTubeQuery *self) { @@ -985,7 +985,7 @@ gdata_youtube_query_get_sort_order (GDataYouTubeQuery *self) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ void gdata_youtube_query_set_sort_order (GDataYouTubeQuery *self, GDataYouTubeSortOrder sort_order) { @@ -1008,7 +1008,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS * Return value: the age property * * Since: 0.3.0 - **/ + */ GDataYouTubeAge gdata_youtube_query_get_age (GDataYouTubeQuery *self) { @@ -1024,7 +1024,7 @@ gdata_youtube_query_get_age (GDataYouTubeQuery *self) * Sets the #GDataYouTubeQuery:age property of the #GDataYouTubeQuery to @age. * * Since: 0.3.0 - **/ + */ void gdata_youtube_query_set_age (GDataYouTubeQuery *self, GDataYouTubeAge age) { @@ -1049,7 +1049,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ GDataYouTubeUploader gdata_youtube_query_get_uploader (GDataYouTubeQuery *self) { @@ -1067,7 +1067,7 @@ gdata_youtube_query_get_uploader (GDataYouTubeQuery *self) * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. The value of * this property will be unused in queries. There is no replacement. - **/ + */ void gdata_youtube_query_set_uploader (GDataYouTubeQuery *self, GDataYouTubeUploader uploader) { diff --git a/gdata/services/youtube/gdata-youtube-query.h b/gdata/services/youtube/gdata-youtube-query.h index 216eed80..32924a1c 100644 --- a/gdata/services/youtube/gdata-youtube-query.h +++ b/gdata/services/youtube/gdata-youtube-query.h @@ -41,7 +41,7 @@ G_BEGIN_DECLS * <ulink type="http" url="https://developers.google.com/youtube/v3/docs/search/list#safeSearch">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ typedef enum { GDATA_YOUTUBE_SAFE_SEARCH_NONE = 0, GDATA_YOUTUBE_SAFE_SEARCH_MODERATE, @@ -60,7 +60,7 @@ typedef enum { * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. There is no * replacement. - **/ + */ typedef enum { GDATA_YOUTUBE_SORT_NONE = 0, GDATA_YOUTUBE_SORT_ASCENDING, @@ -78,7 +78,7 @@ typedef enum { * Video ages, allowing queries to be limited to videos uploaded in a recent time period. * * Since: 0.3.0 - **/ + */ typedef enum { GDATA_YOUTUBE_AGE_ALL_TIME = 0, GDATA_YOUTUBE_AGE_TODAY, @@ -97,7 +97,7 @@ typedef enum { * Since: 0.3.0 * Deprecated: 0.17.0: No longer supported by Google. There is no * replacement. - **/ + */ typedef enum { GDATA_YOUTUBE_UPLOADER_ALL = 0, GDATA_YOUTUBE_UPLOADER_PARTNER @@ -139,7 +139,7 @@ typedef struct _GDataYouTubeQueryPrivate GDataYouTubeQueryPrivate; * All the fields in the #GDataYouTubeQuery structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { GDataQuery parent; GDataYouTubeQueryPrivate *priv; @@ -151,7 +151,7 @@ typedef struct { * All the fields in the #GDataYouTubeQueryClass structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { /*< private >*/ GDataQueryClass parent; diff --git a/gdata/services/youtube/gdata-youtube-service.c b/gdata/services/youtube/gdata-youtube-service.c index ddaabaf4..cc8d14cd 100644 --- a/gdata/services/youtube/gdata-youtube-service.c +++ b/gdata/services/youtube/gdata-youtube-service.c @@ -242,7 +242,7 @@ * g_object_unref (feed); * </programlisting> * </example> - **/ + */ #include <config.h> #include <glib.h> @@ -321,7 +321,7 @@ gdata_youtube_service_class_init (GDataYouTubeServiceClass *klass) * With the port from v2 to v3 of the YouTube API in libgdata * 0.17.0, it might be necessary to update your application’s * developer key. - **/ + */ g_object_class_install_property (gobject_class, PROP_DEVELOPER_KEY, g_param_spec_string ("developer-key", "Developer key", "Your YouTube developer API key.", @@ -726,7 +726,7 @@ standard_feed_type_to_feed_uri (GDataYouTubeStandardFeedType feed_type) * Parameters and errors are as for gdata_service_query(). * * 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, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -774,7 +774,7 @@ gdata_youtube_service_query_standard_feed (GDataYouTubeService *self, GDataYouTu * to get the results of the operation. * * Since: 0.9.1 - **/ + */ void gdata_youtube_service_query_standard_feed_async (GDataYouTubeService *self, GDataYouTubeStandardFeedType feed_type, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -814,7 +814,7 @@ gdata_youtube_service_query_standard_feed_async (GDataYouTubeService *self, GDat * Parameters and errors are as for gdata_service_query(). * * 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, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -856,7 +856,7 @@ gdata_youtube_service_query_videos (GDataYouTubeService *self, GDataQuery *query * to get the results of the operation. * * Since: 0.9.1 - **/ + */ void gdata_youtube_service_query_videos_async (GDataYouTubeService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -894,7 +894,7 @@ gdata_youtube_service_query_videos_async (GDataYouTubeService *self, GDataQuery * Parameters and other errors are as for gdata_service_query(). * * 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, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -947,7 +947,7 @@ gdata_youtube_service_query_related (GDataYouTubeService *self, GDataYouTubeVide * to get the results of the operation. * * Since: 0.9.1 - **/ + */ void gdata_youtube_service_query_related_async (GDataYouTubeService *self, GDataYouTubeVideo *video, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -1003,7 +1003,7 @@ gdata_youtube_service_query_related_async (GDataYouTubeService *self, GDataYouTu * Return value: (transfer full): a #GDataUploadStream to write the video data to, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataUploadStream * gdata_youtube_service_upload_video (GDataYouTubeService *self, GDataYouTubeVideo *video, const gchar *slug, const gchar *content_type, GCancellable *cancellable, GError **error) @@ -1093,7 +1093,7 @@ gdata_youtube_service_finish_video_upload (GDataYouTubeService *self, GDataUploa * Gets the #GDataYouTubeService:developer-key property from the #GDataYouTubeService. * * Return value: the developer key property - **/ + */ const gchar * gdata_youtube_service_get_developer_key (GDataYouTubeService *self) { @@ -1115,7 +1115,7 @@ gdata_youtube_service_get_developer_key (GDataYouTubeService *self) * Return value: (transfer full): a #GDataAPPCategories, or %NULL; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataAPPCategories * gdata_youtube_service_get_categories (GDataYouTubeService *self, GCancellable *cancellable, GError **error) { @@ -1191,7 +1191,7 @@ get_categories_thread (GSimpleAsyncResult *result, GDataYouTubeService *service, * operation. * * Since: 0.7.0 - **/ + */ void gdata_youtube_service_get_categories_async (GDataYouTubeService *self, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { @@ -1217,7 +1217,7 @@ gdata_youtube_service_get_categories_async (GDataYouTubeService *self, GCancella * Return value: (transfer full): a #GDataAPPCategories, or %NULL; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataAPPCategories * gdata_youtube_service_get_categories_finish (GDataYouTubeService *self, GAsyncResult *async_result, GError **error) { diff --git a/gdata/services/youtube/gdata-youtube-service.h b/gdata/services/youtube/gdata-youtube-service.h index d0516247..74710675 100644 --- a/gdata/services/youtube/gdata-youtube-service.h +++ b/gdata/services/youtube/gdata-youtube-service.h @@ -78,7 +78,7 @@ G_BEGIN_DECLS * gdata_youtube_service_query_standard_feed(). For more information, see the * <ulink type="http" url="https://developers.google.com/youtube/2.0/developers_guide_protocol_video_feeds#Standard_feeds">online * documentation</ulink>. - **/ + */ typedef enum { GDATA_YOUTUBE_TOP_RATED_FEED, GDATA_YOUTUBE_TOP_FAVORITES_FEED, @@ -101,7 +101,7 @@ typedef enum { * <ulink type="http" url="https://www.youtube.com/create_channel">https://www.youtube.com/create_channel</ulink> * * Error codes for #GDataYouTubeService operations. - **/ + */ typedef enum { GDATA_YOUTUBE_SERVICE_ERROR_API_QUOTA_EXCEEDED, GDATA_YOUTUBE_SERVICE_ERROR_ENTRY_QUOTA_EXCEEDED, @@ -123,7 +123,7 @@ typedef struct _GDataYouTubeServicePrivate GDataYouTubeServicePrivate; * GDataYouTubeService: * * All the fields in the #GDataYouTubeService structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataService parent; GDataYouTubeServicePrivate *priv; @@ -133,7 +133,7 @@ typedef struct { * GDataYouTubeServiceClass: * * All the fields in the #GDataYouTubeServiceClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataServiceClass parent; diff --git a/gdata/services/youtube/gdata-youtube-state.c b/gdata/services/youtube/gdata-youtube-state.c index 96ced6b1..be1fa0f5 100644 --- a/gdata/services/youtube/gdata-youtube-state.c +++ b/gdata/services/youtube/gdata-youtube-state.c @@ -27,7 +27,7 @@ * <ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state">YouTube namespace</ulink>. * * Since: 0.4.0 - **/ + */ #include <glib.h> @@ -78,7 +78,7 @@ gdata_youtube_state_class_init (GDataYouTubeStateClass *klass) * <ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_string ("name", "Name", "The name of the status of the unpublished video.", @@ -96,7 +96,7 @@ gdata_youtube_state_class_init (GDataYouTubeStateClass *klass) * <ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_REASON_CODE, g_param_spec_string ("reason-code", "Reason code", "The reason code explaining why the video failed to upload.", @@ -115,7 +115,7 @@ gdata_youtube_state_class_init (GDataYouTubeStateClass *klass) * <ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_HELP_URI, g_param_spec_string ("help-uri", "Help URI", "A URI for a YouTube Help Center page.", @@ -133,7 +133,7 @@ gdata_youtube_state_class_init (GDataYouTubeStateClass *klass) * <ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state">online documentation</ulink>. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MESSAGE, g_param_spec_string ("message", "Message", "A human-readable description of why the video failed to upload.", @@ -225,7 +225,7 @@ gdata_youtube_state_set_property (GObject *object, * Return value: the status name * * Since: 0.4.0 - **/ + */ const gchar * gdata_youtube_state_get_name (GDataYouTubeState *self) { @@ -242,7 +242,7 @@ gdata_youtube_state_get_name (GDataYouTubeState *self) * Return value: the status reason code, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_youtube_state_get_reason_code (GDataYouTubeState *self) { @@ -259,7 +259,7 @@ gdata_youtube_state_get_reason_code (GDataYouTubeState *self) * Return value: the help URI, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_youtube_state_get_help_uri (GDataYouTubeState *self) { @@ -276,7 +276,7 @@ gdata_youtube_state_get_help_uri (GDataYouTubeState *self) * Return value: the status message, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_youtube_state_get_message (GDataYouTubeState *self) { diff --git a/gdata/services/youtube/gdata-youtube-state.h b/gdata/services/youtube/gdata-youtube-state.h index 07651ba3..a820e241 100644 --- a/gdata/services/youtube/gdata-youtube-state.h +++ b/gdata/services/youtube/gdata-youtube-state.h @@ -40,7 +40,7 @@ typedef struct _GDataYouTubeStatePrivate GDataYouTubeStatePrivate; * GDataYouTubeState: * * All the fields in the #GDataYouTubeState structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataYouTubeStatePrivate *priv; @@ -52,7 +52,7 @@ typedef struct { * All the fields in the #GDataYouTubeStateClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/services/youtube/gdata-youtube-video.c b/gdata/services/youtube/gdata-youtube-video.c index f7d07630..18b0340f 100644 --- a/gdata/services/youtube/gdata-youtube-video.c +++ b/gdata/services/youtube/gdata-youtube-video.c @@ -57,7 +57,7 @@ * g_object_unref (video); * </programlisting> * </example> - **/ + */ #include <config.h> #include <glib.h> @@ -191,7 +191,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#statistics.viewCount">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_VIEW_COUNT, g_param_spec_uint ("view-count", "View count", "The number of times the video has been viewed.", @@ -205,7 +205,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#statistics.favoriteCount">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_FAVORITE_COUNT, g_param_spec_uint ("favorite-count", "Favorite count", "The number of users who have added the video to their favorites.", @@ -219,7 +219,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#recordingDetails.locationDescription">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_LOCATION, g_param_spec_string ("location", "Location", "Descriptive text about the location where the video was taken.", @@ -233,7 +233,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_MIN_RATING, g_param_spec_uint ("min-rating", "Minimum rating", "The minimum allowed rating for the video.", @@ -247,7 +247,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_MAX_RATING, g_param_spec_uint ("max-rating", "Maximum rating", "The maximum allowed rating for the video.", @@ -261,7 +261,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_RATING_COUNT, g_param_spec_uint ("rating-count", "Rating count", "The number of times the video has been rated.", @@ -275,7 +275,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_AVERAGE_RATING, g_param_spec_double ("average-rating", "Average rating", "The average rating of the video.", @@ -289,7 +289,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#snippet.tags[]">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_KEYWORDS, g_param_spec_boxed ("keywords", "Keywords", "A NULL-terminated array of words associated with the video.", @@ -300,7 +300,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * GDataYouTubeVideo:player-uri: * * A URI for a browser-based media player for the full-length video (i.e. the video's page on YouTube). - **/ + */ g_object_class_install_property (gobject_class, PROP_PLAYER_URI, g_param_spec_string ("player-uri", "Player URI", "A URI for a browser-based media player for the full-length video.", @@ -314,7 +314,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#snippet.categoryId">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_CATEGORY, g_param_spec_object ("category", "Category", "Specifies a genre or developer tag that describes the video.", @@ -330,7 +330,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * Deprecated: 0.17.0: This is no longer supported by Google, and * will always be %NULL. There is no replacement. - **/ + */ g_object_class_install_property (gobject_class, PROP_CREDIT, g_param_spec_object ("credit", "Credit", "Identifies the owner of the video.", @@ -347,7 +347,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#snippet.description">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_DESCRIPTION, g_param_spec_string ("description", "Description", "A summary or description of the video.", @@ -361,7 +361,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#contentDetails.duration">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_DURATION, g_param_spec_uint ("duration", "Duration", "The duration of the video in seconds.", @@ -375,7 +375,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#status.privacyStatus">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIVATE, g_param_spec_boolean ("is-private", "Private?", "Indicates whether the video is private.", @@ -389,7 +389,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#snippet.publishedAt">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_UPLOADED, g_param_spec_int64 ("uploaded", "Uploaded", "Specifies the time the video was originally uploaded to YouTube.", @@ -405,7 +405,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * url="https://developers.google.com/youtube/v3/docs/videos#id">online documentation</ulink>. * * Deprecated: 0.17.0: This is now equal to #GDataEntry:id. - **/ + */ g_object_class_install_property (gobject_class, PROP_VIDEO_ID, g_param_spec_string ("video-id", "Video ID", "Specifies a unique ID which YouTube uses to identify the video.", @@ -420,7 +420,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * Deprecated: 0.17.0: This is now equal to * #GDataYouTubeVideo:is-private. - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_DRAFT, g_param_spec_boolean ("is-draft", "Draft?", "Indicates whether the video is in draft, or unpublished, status.", @@ -436,7 +436,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#status.uploadStatus">online documentation</ulink>. - **/ + */ g_object_class_install_property (gobject_class, PROP_STATE, g_param_spec_object ("state", "State", "Information describing the state of the video.", @@ -452,7 +452,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * url="https://developers.google.com/youtube/v3/docs/videos#recordingDetails.recordingDate">online documentation</ulink>. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RECORDED, g_param_spec_int64 ("recorded", "Recorded", "Specifies the time the video was originally recorded.", @@ -466,7 +466,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * %GDATA_YOUTUBE_ASPECT_RATIO_WIDESCREEN means the video is definitely widescreen. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ASPECT_RATIO, g_param_spec_string ("aspect-ratio", "Aspect Ratio", "The aspect ratio of the video.", @@ -485,7 +485,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * online documentation</ulink>. * * Since: 0.8.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LATITUDE, g_param_spec_double ("latitude", "Latitude", "The location as a latitude coordinate associated with this video.", @@ -504,7 +504,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * online documentation</ulink>. * * Since: 0.8.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LONGITUDE, g_param_spec_double ("longitude", "Longitude", "The location as a longitude coordinate associated with this video.", @@ -1567,7 +1567,7 @@ is_comment_deletable (GDataCommentable *self, GDataComment *comment_) * Creates a new #GDataYouTubeVideo with the given ID and default properties. * * Return value: a new #GDataYouTubeVideo; unref with g_object_unref() - **/ + */ GDataYouTubeVideo * gdata_youtube_video_new (const gchar *id) { @@ -1581,7 +1581,7 @@ gdata_youtube_video_new (const gchar *id) * Gets the #GDataYouTubeVideo:view-count property. * * Return value: the number of times the video has been viewed - **/ + */ guint gdata_youtube_video_get_view_count (GDataYouTubeVideo *self) { @@ -1596,7 +1596,7 @@ gdata_youtube_video_get_view_count (GDataYouTubeVideo *self) * Gets the #GDataYouTubeVideo:favorite-count property. * * Return value: the number of users who have added the video to their favorites list - **/ + */ guint gdata_youtube_video_get_favorite_count (GDataYouTubeVideo *self) { @@ -1611,7 +1611,7 @@ gdata_youtube_video_get_favorite_count (GDataYouTubeVideo *self) * Gets the #GDataYouTubeVideo:location property. * * Return value: a string describing the video's location, or %NULL - **/ + */ const gchar * gdata_youtube_video_get_location (GDataYouTubeVideo *self) { @@ -1627,7 +1627,7 @@ gdata_youtube_video_get_location (GDataYouTubeVideo *self) * Sets the #GDataYouTubeVideo:location property to the new location string, @location. * * Set @location to %NULL to unset the property in the video. - **/ + */ void gdata_youtube_video_set_location (GDataYouTubeVideo *self, const gchar *location) { @@ -1649,7 +1649,7 @@ gdata_youtube_video_set_location (GDataYouTubeVideo *self, const gchar *location * Return value: the permission associated with @action, or %GDATA_YOUTUBE_PERMISSION_DENIED * * Since: 0.7.0 - **/ + */ GDataYouTubePermission gdata_youtube_video_get_access_control (GDataYouTubeVideo *self, const gchar *action) { @@ -1675,7 +1675,7 @@ gdata_youtube_video_get_access_control (GDataYouTubeVideo *self, const gchar *ac * Note that only %GDATA_YOUTUBE_ACTION_RATE and %GDATA_YOUTUBE_ACTION_COMMENT actions can have the %GDATA_YOUTUBE_PERMISSION_MODERATED permission. * * Since: 0.7.0 - **/ + */ void gdata_youtube_video_set_access_control (GDataYouTubeVideo *self, const gchar *action, GDataYouTubePermission permission) { @@ -1698,7 +1698,7 @@ gdata_youtube_video_set_access_control (GDataYouTubeVideo *self, const gchar *ac * Note that this property may not be retrieved when querying for multiple * videos at once, but is guaranteed to be retrieved when querying with * gdata_service_query_single_entry_async(). - **/ + */ void gdata_youtube_video_get_rating (GDataYouTubeVideo *self, guint *min, guint *max, guint *count, gdouble *average) { @@ -1720,7 +1720,7 @@ gdata_youtube_video_get_rating (GDataYouTubeVideo *self, guint *min, guint *max, * Gets the #GDataYouTubeVideo:keywords property. * * Return value: (array zero-terminated=1) (transfer none): a %NULL-terminated array of words associated with the video - **/ + */ const gchar * const * gdata_youtube_video_get_keywords (GDataYouTubeVideo *self) { @@ -1737,7 +1737,7 @@ gdata_youtube_video_get_keywords (GDataYouTubeVideo *self) * * @keywords must not be %NULL. For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#snippet.tags[]">online documentation</ulink>. - **/ + */ void gdata_youtube_video_set_keywords (GDataYouTubeVideo *self, const gchar * const *keywords) { @@ -1756,7 +1756,7 @@ gdata_youtube_video_set_keywords (GDataYouTubeVideo *self, const gchar * const * * Gets the #GDataYouTubeVideo:player-uri property. * * Return value: a URI where the video is playable in a web browser, or %NULL - **/ + */ const gchar * gdata_youtube_video_get_player_uri (GDataYouTubeVideo *self) { @@ -1800,7 +1800,7 @@ strv_contains (const gchar * const *strv, const gchar *key) * Return value: %TRUE if the video is restricted in @country, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_youtube_video_is_restricted_in_country (GDataYouTubeVideo *self, const gchar *country) { @@ -1928,7 +1928,7 @@ gdata_youtube_video_get_media_rating (GDataYouTubeVideo *self, const gchar *rati * Gets the #GDataYouTubeVideo:category property. * * Return value: (transfer none): a #GDataMediaCategory giving the video's single and mandatory category - **/ + */ GDataMediaCategory * gdata_youtube_video_get_category (GDataYouTubeVideo *self) { @@ -1945,7 +1945,7 @@ gdata_youtube_video_get_category (GDataYouTubeVideo *self) * * @category must not be %NULL. For more information, see the <ulink type="http" * url="https://developers.google.com/youtube/v3/docs/videos#snippet.categoryId">online documentation</ulink>. - **/ + */ void gdata_youtube_video_set_category (GDataYouTubeVideo *self, GDataMediaCategory *category) { @@ -1969,7 +1969,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * Return value: (transfer none): a #GDataMediaCredit giving information on whom to credit for the video, or %NULL * Deprecated: 0.17.0: This is no longer supported by Google, and will * always return %NULL. There is no replacement. - **/ + */ GDataYouTubeCredit * gdata_youtube_video_get_credit (GDataYouTubeVideo *self) { @@ -1986,7 +1986,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS * Gets the #GDataYouTubeVideo:description property. * * Return value: the video's long text description, or %NULL - **/ + */ const gchar * gdata_youtube_video_get_description (GDataYouTubeVideo *self) { @@ -2002,7 +2002,7 @@ gdata_youtube_video_get_description (GDataYouTubeVideo *self) * Sets the #GDataYouTubeVideo:description property to the new description, @description. * * Set @description to %NULL to unset the video's description. - **/ + */ void gdata_youtube_video_set_description (GDataYouTubeVideo *self, const gchar *description) { @@ -2025,7 +2025,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * Deprecated: 0.17.0: This is no longer supported by Google, and will * always return %NULL. To view a video, open the URI returned by * gdata_youtube_video_get_player_uri() in a web browser. - **/ + */ GDataYouTubeContent * gdata_youtube_video_look_up_content (GDataYouTubeVideo *self, const gchar *type) { @@ -2045,7 +2045,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS * Gets a list of the thumbnails available for the video. * * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnail<!-- -->s, or %NULL - **/ + */ GList * gdata_youtube_video_get_thumbnails (GDataYouTubeVideo *self) { @@ -2060,7 +2060,7 @@ gdata_youtube_video_get_thumbnails (GDataYouTubeVideo *self) * Gets the #GDataYouTubeVideo:duration property. * * Return value: the video duration in seconds, or <code class="literal">0</code> if unknown - **/ + */ guint gdata_youtube_video_get_duration (GDataYouTubeVideo *self) { @@ -2075,7 +2075,7 @@ gdata_youtube_video_get_duration (GDataYouTubeVideo *self) * Gets the #GDataYouTubeVideo:is-private property. * * Return value: %TRUE if the video is private, %FALSE otherwise - **/ + */ gboolean gdata_youtube_video_is_private (GDataYouTubeVideo *self) { @@ -2089,7 +2089,7 @@ gdata_youtube_video_is_private (GDataYouTubeVideo *self) * @is_private: whether the video is private * * Sets the #GDataYouTubeVideo:is-private property to decide whether the video is publicly viewable. - **/ + */ void gdata_youtube_video_set_is_private (GDataYouTubeVideo *self, gboolean is_private) { @@ -2105,7 +2105,7 @@ gdata_youtube_video_set_is_private (GDataYouTubeVideo *self, gboolean is_private * Gets the #GDataYouTubeVideo:uploaded property. If the property is unset, <code class="literal">-1</code> will be returned. * * Return value: the UNIX timestamp for the time the video was uploaded, or <code class="literal">-1</code> - **/ + */ gint64 gdata_youtube_video_get_uploaded (GDataYouTubeVideo *self) { @@ -2121,7 +2121,7 @@ gdata_youtube_video_get_uploaded (GDataYouTubeVideo *self) * * Return value: the video's unique and permanent ID * Deprecated: 0.17.0: This is now equal to #GDataEntry:id. - **/ + */ const gchar * gdata_youtube_video_get_video_id (GDataYouTubeVideo *self) { @@ -2138,7 +2138,7 @@ gdata_youtube_video_get_video_id (GDataYouTubeVideo *self) * Return value: %TRUE if the video is a draft, %FALSE otherwise * Deprecated: 0.17.0: This is now equal to * gdata_youtube_video_is_private(). - **/ + */ gboolean gdata_youtube_video_is_draft (GDataYouTubeVideo *self) { @@ -2155,7 +2155,7 @@ gdata_youtube_video_is_draft (GDataYouTubeVideo *self) * * Deprecated: 0.17.0: This is now equivalent to * gdata_youtube_video_set_is_private(). - **/ + */ void gdata_youtube_video_set_is_draft (GDataYouTubeVideo *self, gboolean is_draft) { @@ -2253,7 +2253,7 @@ convert_state_reason_code (const gchar *v2_name, * url="https://developers.google.com/youtube/v3/docs/videos#status.uploadStatus">online documentation</ulink>. * * Return value: (transfer none): a #GDataYouTubeState showing the state of the video, or %NULL - **/ + */ GDataYouTubeState * gdata_youtube_video_get_state (GDataYouTubeVideo *self) { @@ -2293,7 +2293,7 @@ gdata_youtube_video_get_state (GDataYouTubeVideo *self) * Return value: the UNIX timestamp for the time the video was recorded, or <code class="literal">-1</code> * * Since: 0.3.0 - **/ + */ gint64 gdata_youtube_video_get_recorded (GDataYouTubeVideo *self) { @@ -2311,7 +2311,7 @@ gdata_youtube_video_get_recorded (GDataYouTubeVideo *self) * Set @recorded to <code class="literal">-1</code> to unset the video's recorded time. * * Since: 0.3.0 - **/ + */ void gdata_youtube_video_set_recorded (GDataYouTubeVideo *self, gint64 recorded) { @@ -2343,7 +2343,7 @@ gdata_youtube_video_set_recorded (GDataYouTubeVideo *self, gint64 recorded) * Since: 0.4.0 * * Return value: the video ID, or %NULL; free with g_free() - **/ + */ gchar * gdata_youtube_video_get_video_id_from_uri (const gchar *video_uri) { @@ -2398,7 +2398,7 @@ gdata_youtube_video_get_video_id_from_uri (const gchar *video_uri) * Return value: the aspect ratio property, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_youtube_video_get_aspect_ratio (GDataYouTubeVideo *self) { @@ -2418,7 +2418,7 @@ gdata_youtube_video_get_aspect_ratio (GDataYouTubeVideo *self) * If @aspect_ratio is %NULL, the property will be unset. * * Since: 0.4.0 - **/ + */ void gdata_youtube_video_set_aspect_ratio (GDataYouTubeVideo *self, const gchar *aspect_ratio) { @@ -2438,7 +2438,7 @@ gdata_youtube_video_set_aspect_ratio (GDataYouTubeVideo *self, const gchar *aspe * longitude is %NULL, that parameter will not be set. If the coordinates are unset, @latitude and @longitude will be set to %G_MAXDOUBLE. * * Since: 0.8.0 - **/ + */ void gdata_youtube_video_get_coordinates (GDataYouTubeVideo *self, gdouble *latitude, gdouble *longitude) { @@ -2461,7 +2461,7 @@ gdata_youtube_video_get_coordinates (GDataYouTubeVideo *self, gdouble *latitude, * Sets the #GDataYouTubeVideo:latitude and #GDataYouTubeVideo:longitude properties to @latitude and @longitude respectively. * * Since: 0.8.0 - **/ + */ void gdata_youtube_video_set_coordinates (GDataYouTubeVideo *self, gdouble latitude, gdouble longitude) { diff --git a/gdata/services/youtube/gdata-youtube-video.h b/gdata/services/youtube/gdata-youtube-video.h index 69f4cfe4..da526334 100644 --- a/gdata/services/youtube/gdata-youtube-video.h +++ b/gdata/services/youtube/gdata-youtube-video.h @@ -40,7 +40,7 @@ G_BEGIN_DECLS * online documentation</ulink>. * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ASPECT_RATIO_WIDESCREEN "widescreen" /** @@ -49,7 +49,7 @@ G_BEGIN_DECLS * An action to rate a video, for use with gdata_youtube_video_set_access_control(). * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ACTION_RATE "rate" /** @@ -58,7 +58,7 @@ G_BEGIN_DECLS * An action to comment on a video, for use with gdata_youtube_video_set_access_control(). * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ACTION_COMMENT "comment" /** @@ -67,7 +67,7 @@ G_BEGIN_DECLS * An action to rate other users' comments on a video, for use with gdata_youtube_video_set_access_control(). * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ACTION_COMMENT_VOTE "commentVote" /** @@ -76,7 +76,7 @@ G_BEGIN_DECLS * An action to add a video response to a video, for use with gdata_youtube_video_set_access_control(). * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ACTION_VIDEO_RESPOND "videoRespond" /** @@ -85,7 +85,7 @@ G_BEGIN_DECLS * An action to embed a video on third-party websites, for use with gdata_youtube_video_set_access_control(). * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ACTION_EMBED "embed" /** @@ -94,7 +94,7 @@ G_BEGIN_DECLS * An action allowing YouTube to show the video on mobile phones and televisions, for use with gdata_youtube_video_set_access_control(). * * Since: 0.7.0 - **/ + */ #define GDATA_YOUTUBE_ACTION_SYNDICATE "syndicate" #ifndef LIBGDATA_DISABLE_DEPRECATED @@ -147,7 +147,7 @@ G_BEGIN_DECLS * %GDATA_YOUTUBE_ACTION_RATE and %GDATA_YOUTUBE_ACTION_COMMENT. * * Since: 0.7.0 - **/ + */ typedef enum { GDATA_YOUTUBE_PERMISSION_ALLOWED, GDATA_YOUTUBE_PERMISSION_DENIED, @@ -167,7 +167,7 @@ typedef struct _GDataYouTubeVideoPrivate GDataYouTubeVideoPrivate; * GDataYouTubeVideo: * * All the fields in the #GDataYouTubeVideo structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataEntry parent; GDataYouTubeVideoPrivate *priv; @@ -177,7 +177,7 @@ typedef struct { * GDataYouTubeVideoClass: * * All the fields in the #GDataYouTubeVideoClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; |