From bf0da775d998d06fac1fd108250e6f7c55dd7c4e Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Tue, 24 Jan 2017 23:14:28 +0000 Subject: =?UTF-8?q?docs:=20Replace=20=E2=80=98**/=E2=80=99=20gtk-doc=20com?= =?UTF-8?q?ment=20endings=20with=20=E2=80=98*/=E2=80=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ‘*/’ is more standard, so this is basically a housekeeping improvement in coding style. --- gdata/app/gdata-app-categories.c | 8 +- gdata/app/gdata-app-categories.h | 4 +- gdata/atom/gdata-author.c | 22 +- gdata/atom/gdata-author.h | 4 +- gdata/atom/gdata-category.c | 22 +- gdata/atom/gdata-category.h | 4 +- gdata/atom/gdata-generator.c | 14 +- gdata/atom/gdata-generator.h | 4 +- gdata/atom/gdata-link.c | 40 ++-- gdata/atom/gdata-link.h | 18 +- gdata/exif/gdata-exif-tags.c | 20 +- gdata/exif/gdata-exif-tags.h | 4 +- gdata/gcontact/gdata-gcontact-calendar.c | 28 +-- gdata/gcontact/gdata-gcontact-calendar.h | 10 +- gdata/gcontact/gdata-gcontact-event.c | 22 +- gdata/gcontact/gdata-gcontact-event.h | 8 +- gdata/gcontact/gdata-gcontact-external-id.c | 22 +- gdata/gcontact/gdata-gcontact-external-id.h | 12 +- gdata/gcontact/gdata-gcontact-jot.c | 16 +- gdata/gcontact/gdata-gcontact-jot.h | 14 +- gdata/gcontact/gdata-gcontact-language.c | 16 +- gdata/gcontact/gdata-gcontact-language.h | 4 +- gdata/gcontact/gdata-gcontact-relation.c | 22 +- gdata/gcontact/gdata-gcontact-relation.h | 32 +-- gdata/gcontact/gdata-gcontact-website.c | 28 +-- gdata/gcontact/gdata-gcontact-website.h | 18 +- gdata/gd/gdata-gd-email-address.c | 34 +-- gdata/gd/gdata-gd-email-address.h | 10 +- gdata/gd/gdata-gd-im-address.c | 34 +-- gdata/gd/gdata-gd-im-address.h | 28 +-- gdata/gd/gdata-gd-name.c | 40 ++-- gdata/gd/gdata-gd-name.h | 4 +- gdata/gd/gdata-gd-organization.c | 58 +++--- gdata/gd/gdata-gd-organization.h | 8 +- gdata/gd/gdata-gd-phone-number.c | 34 +-- gdata/gd/gdata-gd-phone-number.h | 44 ++-- gdata/gd/gdata-gd-postal-address.c | 104 +++++----- gdata/gd/gdata-gd-postal-address.h | 22 +- gdata/gd/gdata-gd-reminder.c | 26 +-- gdata/gd/gdata-gd-reminder.h | 10 +- gdata/gd/gdata-gd-when.c | 32 +-- gdata/gd/gdata-gd-when.h | 22 +- gdata/gd/gdata-gd-where.c | 22 +- gdata/gd/gdata-gd-where.h | 10 +- gdata/gd/gdata-gd-who.c | 22 +- gdata/gd/gdata-gd-who.h | 12 +- gdata/gdata-access-handler.c | 6 +- gdata/gdata-access-handler.h | 4 +- gdata/gdata-access-rule.c | 22 +- gdata/gdata-access-rule.h | 12 +- gdata/gdata-batch-feed.h | 4 +- gdata/gdata-batch-operation.c | 28 +-- gdata/gdata-batch-operation.h | 10 +- gdata/gdata-batchable.c | 2 +- gdata/gdata-batchable.h | 4 +- gdata/gdata-buffer.c | 10 +- gdata/gdata-buffer.h | 2 +- gdata/gdata-comparable.c | 4 +- gdata/gdata-comparable.h | 4 +- gdata/gdata-download-stream.c | 24 +-- gdata/gdata-download-stream.h | 4 +- gdata/gdata-entry.c | 68 +++--- gdata/gdata-entry.h | 4 +- gdata/gdata-feed.c | 62 +++--- gdata/gdata-feed.h | 4 +- gdata/gdata-parsable.c | 8 +- gdata/gdata-parsable.h | 6 +- gdata/gdata-private.h | 2 +- gdata/gdata-query.c | 78 +++---- gdata/gdata-query.h | 4 +- gdata/gdata-service.c | 50 ++--- gdata/gdata-service.h | 8 +- gdata/gdata-types.c | 6 +- gdata/gdata-types.h | 2 +- gdata/gdata-upload-stream.c | 34 +-- gdata/gdata-upload-stream.h | 4 +- gdata/georss/gdata-georss-where.c | 8 +- gdata/georss/gdata-georss-where.h | 4 +- gdata/media/gdata-media-category.c | 22 +- gdata/media/gdata-media-category.h | 4 +- gdata/media/gdata-media-content.c | 40 ++-- gdata/media/gdata-media-content.h | 8 +- gdata/media/gdata-media-credit.c | 14 +- gdata/media/gdata-media-credit.h | 4 +- gdata/media/gdata-media-group.c | 28 +-- gdata/media/gdata-media-group.h | 4 +- gdata/media/gdata-media-thumbnail.c | 22 +- gdata/media/gdata-media-thumbnail.h | 4 +- gdata/services/calendar/gdata-calendar-calendar.c | 40 ++-- gdata/services/calendar/gdata-calendar-calendar.h | 4 +- gdata/services/calendar/gdata-calendar-event.c | 90 ++++---- gdata/services/calendar/gdata-calendar-event.h | 4 +- gdata/services/calendar/gdata-calendar-feed.c | 10 +- gdata/services/calendar/gdata-calendar-feed.h | 4 +- gdata/services/calendar/gdata-calendar-query.c | 60 +++--- gdata/services/calendar/gdata-calendar-query.h | 4 +- gdata/services/calendar/gdata-calendar-service.c | 18 +- gdata/services/calendar/gdata-calendar-service.h | 4 +- gdata/services/contacts/gdata-contacts-contact.c | 228 ++++++++++----------- gdata/services/contacts/gdata-contacts-contact.h | 22 +- gdata/services/contacts/gdata-contacts-group.c | 22 +- gdata/services/contacts/gdata-contacts-group.h | 12 +- gdata/services/contacts/gdata-contacts-query.c | 30 +-- gdata/services/contacts/gdata-contacts-query.h | 4 +- gdata/services/contacts/gdata-contacts-service.c | 18 +- gdata/services/contacts/gdata-contacts-service.h | 4 +- .../services/documents/gdata-documents-document.c | 6 +- .../services/documents/gdata-documents-document.h | 4 +- gdata/services/documents/gdata-documents-drawing.c | 4 +- gdata/services/documents/gdata-documents-drawing.h | 10 +- gdata/services/documents/gdata-documents-entry.c | 30 +-- gdata/services/documents/gdata-documents-entry.h | 10 +- gdata/services/documents/gdata-documents-feed.c | 2 +- gdata/services/documents/gdata-documents-feed.h | 4 +- gdata/services/documents/gdata-documents-folder.c | 4 +- gdata/services/documents/gdata-documents-folder.h | 4 +- gdata/services/documents/gdata-documents-pdf.c | 4 +- gdata/services/documents/gdata-documents-pdf.h | 4 +- .../documents/gdata-documents-presentation.c | 4 +- .../documents/gdata-documents-presentation.h | 14 +- gdata/services/documents/gdata-documents-query.c | 42 ++-- gdata/services/documents/gdata-documents-query.h | 4 +- gdata/services/documents/gdata-documents-service.c | 24 +-- gdata/services/documents/gdata-documents-service.h | 6 +- .../documents/gdata-documents-spreadsheet.c | 6 +- .../documents/gdata-documents-spreadsheet.h | 16 +- gdata/services/documents/gdata-documents-text.c | 4 +- gdata/services/documents/gdata-documents-text.h | 20 +- gdata/services/freebase/gdata-freebase-query.c | 2 +- gdata/services/freebase/gdata-freebase-result.c | 4 +- .../freebase/gdata-freebase-search-query.c | 16 +- .../freebase/gdata-freebase-search-result.c | 20 +- gdata/services/freebase/gdata-freebase-service.c | 4 +- gdata/services/freebase/gdata-freebase-service.h | 4 +- .../services/freebase/gdata-freebase-topic-query.c | 8 +- .../freebase/gdata-freebase-topic-result.c | 44 ++-- gdata/services/picasaweb/gdata-picasaweb-album.c | 78 +++---- gdata/services/picasaweb/gdata-picasaweb-album.h | 6 +- gdata/services/picasaweb/gdata-picasaweb-feed.c | 2 +- gdata/services/picasaweb/gdata-picasaweb-feed.h | 4 +- gdata/services/picasaweb/gdata-picasaweb-file.c | 130 ++++++------ gdata/services/picasaweb/gdata-picasaweb-file.h | 12 +- gdata/services/picasaweb/gdata-picasaweb-query.c | 40 ++-- gdata/services/picasaweb/gdata-picasaweb-query.h | 4 +- gdata/services/picasaweb/gdata-picasaweb-service.c | 18 +- gdata/services/picasaweb/gdata-picasaweb-service.h | 4 +- gdata/services/picasaweb/gdata-picasaweb-user.c | 14 +- gdata/services/picasaweb/gdata-picasaweb-user.h | 4 +- gdata/services/youtube/gdata-youtube-category.c | 12 +- gdata/services/youtube/gdata-youtube-category.h | 4 +- gdata/services/youtube/gdata-youtube-content.c | 6 +- gdata/services/youtube/gdata-youtube-content.h | 6 +- gdata/services/youtube/gdata-youtube-credit.c | 6 +- gdata/services/youtube/gdata-youtube-credit.h | 6 +- gdata/services/youtube/gdata-youtube-query.c | 64 +++--- gdata/services/youtube/gdata-youtube-query.h | 12 +- gdata/services/youtube/gdata-youtube-service.c | 26 +-- gdata/services/youtube/gdata-youtube-service.h | 8 +- gdata/services/youtube/gdata-youtube-state.c | 18 +- gdata/services/youtube/gdata-youtube-state.h | 4 +- gdata/services/youtube/gdata-youtube-video.c | 114 +++++------ gdata/services/youtube/gdata-youtube-video.h | 20 +- 162 files changed, 1581 insertions(+), 1581 deletions(-) diff --git a/gdata/app/gdata-app-categories.c b/gdata/app/gdata-app-categories.c index 84a23a82..d2719339 100644 --- a/gdata/app/gdata-app-categories.c +++ b/gdata/app/gdata-app-categories.c @@ -27,7 +27,7 @@ * Atom Publishing Protocol Category Document. * * Since: 0.7.0 - **/ + */ #include #include @@ -84,7 +84,7 @@ gdata_app_categories_class_init (GDataAPPCategoriesClass *klass) * API reference: app:categories * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_FIXED, g_param_spec_boolean ("is-fixed", "Fixed?", "Whether entries may use categories not in this category list.", @@ -223,7 +223,7 @@ post_parse_json (GDataParsable *parsable, gpointer user_data, GError **error) * Return value: (element-type GData.Category) (transfer none): a #GList of #GDataCategorys * * Since: 0.7.0 - **/ + */ GList * gdata_app_categories_get_categories (GDataAPPCategories *self) { @@ -240,7 +240,7 @@ gdata_app_categories_get_categories (GDataAPPCategories *self) * Return value: whether entries may use categories not in this category list * * Since: 0.7.0 - **/ + */ gboolean gdata_app_categories_is_fixed (GDataAPPCategories *self) { diff --git a/gdata/app/gdata-app-categories.h b/gdata/app/gdata-app-categories.h index dbe29be0..48ec77bf 100644 --- a/gdata/app/gdata-app-categories.h +++ b/gdata/app/gdata-app-categories.h @@ -42,7 +42,7 @@ typedef struct _GDataAPPCategoriesPrivate GDataAPPCategoriesPrivate; * All the fields in the #GDataAPPCategories structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsable parent; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataAPPCategoriesClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/atom/gdata-author.c b/gdata/atom/gdata-author.c index bb5565a4..09bf03fc 100644 --- a/gdata/atom/gdata-author.c +++ b/gdata/atom/gdata-author.c @@ -27,7 +27,7 @@ * Atom specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -86,7 +86,7 @@ gdata_author_class_init (GDataAuthorClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_string ("name", "Name", "A human-readable name for the person.", @@ -102,7 +102,7 @@ gdata_author_class_init (GDataAuthorClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "An IRI associated with the person.", @@ -118,7 +118,7 @@ gdata_author_class_init (GDataAuthorClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EMAIL_ADDRESS, g_param_spec_string ("email-address", "E-mail address", "An e-mail address associated with the person.", @@ -255,7 +255,7 @@ get_xml (GDataParsable *parsable, GString *xml_string) * @name must be non-%NULL and non-empty. * * Return value: a new #GDataAuthor, or %NULL; unref with g_object_unref() - **/ + */ GDataAuthor * gdata_author_new (const gchar *name, const gchar *uri, const gchar *email_address) { @@ -272,7 +272,7 @@ gdata_author_new (const gchar *name, const gchar *uri, const gchar *email_addres * Return value: the author's name * * Since: 0.4.0 - **/ + */ const gchar * gdata_author_get_name (GDataAuthor *self) { @@ -288,7 +288,7 @@ gdata_author_get_name (GDataAuthor *self) * Sets the #GDataAuthor:name property to @name. @name must be non-%NULL and non-empty. * * Since: 0.4.0 - **/ + */ void gdata_author_set_name (GDataAuthor *self, const gchar *name) { @@ -309,7 +309,7 @@ gdata_author_set_name (GDataAuthor *self, const gchar *name) * Return value: the author's URI, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_author_get_uri (GDataAuthor *self) { @@ -327,7 +327,7 @@ gdata_author_get_uri (GDataAuthor *self) * Set @uri to %NULL to unset the property in the author. * * Since: 0.4.0 - **/ + */ void gdata_author_set_uri (GDataAuthor *self, const gchar *uri) { @@ -347,7 +347,7 @@ gdata_author_set_uri (GDataAuthor *self, const gchar *uri) * Return value: the author's e-mail address, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_author_get_email_address (GDataAuthor *self) { @@ -365,7 +365,7 @@ gdata_author_get_email_address (GDataAuthor *self) * Set @email_address to %NULL to unset the property in the author. * * Since: 0.4.0 - **/ + */ void gdata_author_set_email_address (GDataAuthor *self, const gchar *email_address) { diff --git a/gdata/atom/gdata-author.h b/gdata/atom/gdata-author.h index 1575ae98..7487b4cf 100644 --- a/gdata/atom/gdata-author.h +++ b/gdata/atom/gdata-author.h @@ -40,7 +40,7 @@ typedef struct _GDataAuthorPrivate GDataAuthorPrivate; * GDataAuthor: * * All the fields in the #GDataAuthor structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataAuthorPrivate *priv; @@ -52,7 +52,7 @@ typedef struct { * All the fields in the #GDataAuthorClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/atom/gdata-category.c b/gdata/atom/gdata-category.c index 1d2109df..c02771ce 100644 --- a/gdata/atom/gdata-category.c +++ b/gdata/atom/gdata-category.c @@ -27,7 +27,7 @@ * Atom specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -85,7 +85,7 @@ gdata_category_class_init (GDataCategoryClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TERM, g_param_spec_string ("term", "Term", "Identifies the category to which the entry or feed belongs.", @@ -102,7 +102,7 @@ gdata_category_class_init (GDataCategoryClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SCHEME, g_param_spec_string ("scheme", "Scheme", "An IRI that identifies a categorization scheme.", @@ -119,7 +119,7 @@ gdata_category_class_init (GDataCategoryClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A human-readable label for display in end-user applications.", @@ -254,7 +254,7 @@ pre_get_xml (GDataParsable *parsable, GString *xml_string) * @term must be non-%NULL and non-empty. @scheme must be %NULL or non-empty. * * Return value: a new #GDataCategory, or %NULL; unref with g_object_unref() - **/ + */ GDataCategory * gdata_category_new (const gchar *term, const gchar *scheme, const gchar *label) { @@ -272,7 +272,7 @@ gdata_category_new (const gchar *term, const gchar *scheme, const gchar *label) * Return value: the category's term * * Since: 0.4.0 - **/ + */ const gchar * gdata_category_get_term (GDataCategory *self) { @@ -288,7 +288,7 @@ gdata_category_get_term (GDataCategory *self) * Sets the #GDataCategory:term property to @term. @term must be non-%NULL and non-empty. * * Since: 0.4.0 - **/ + */ void gdata_category_set_term (GDataCategory *self, const gchar *term) { @@ -309,7 +309,7 @@ gdata_category_set_term (GDataCategory *self, const gchar *term) * Return value: the category's scheme, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_category_get_scheme (GDataCategory *self) { @@ -327,7 +327,7 @@ gdata_category_get_scheme (GDataCategory *self) * Set @scheme to %NULL to unset the property in the category. * * Since: 0.4.0 - **/ + */ void gdata_category_set_scheme (GDataCategory *self, const gchar *scheme) { @@ -347,7 +347,7 @@ gdata_category_set_scheme (GDataCategory *self, const gchar *scheme) * Return value: the category's label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_category_get_label (GDataCategory *self) { @@ -365,7 +365,7 @@ gdata_category_get_label (GDataCategory *self) * Set @label to %NULL to unset the property in the category. * * Since: 0.4.0 - **/ + */ void gdata_category_set_label (GDataCategory *self, const gchar *label) { diff --git a/gdata/atom/gdata-category.h b/gdata/atom/gdata-category.h index f537952f..20f7cacf 100644 --- a/gdata/atom/gdata-category.h +++ b/gdata/atom/gdata-category.h @@ -80,7 +80,7 @@ typedef struct _GDataCategoryPrivate GDataCategoryPrivate; * GDataCategory: * * All the fields in the #GDataCategory structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataCategoryPrivate *priv; @@ -92,7 +92,7 @@ typedef struct { * All the fields in the #GDataCategoryClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/atom/gdata-generator.c b/gdata/atom/gdata-generator.c index 8bf54f84..69a17d25 100644 --- a/gdata/atom/gdata-generator.c +++ b/gdata/atom/gdata-generator.c @@ -25,7 +25,7 @@ * * #GDataGenerator represents a "generator" element from the * Atom specification. - **/ + */ #include #include @@ -81,7 +81,7 @@ gdata_generator_class_init (GDataGeneratorClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_string ("name", "Name", "A human-readable name for the generating agent.", @@ -98,7 +98,7 @@ gdata_generator_class_init (GDataGeneratorClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "An IRI reference that is relevant to the agent.", @@ -115,7 +115,7 @@ gdata_generator_class_init (GDataGeneratorClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VERSION, g_param_spec_string ("version", "Version", "Indicates the version of the generating agent.", @@ -221,7 +221,7 @@ parse_xml (GDataParsable *parsable, xmlDoc *doc, xmlNode *node, gpointer user_da * Return value: (nullable): the generator's name * * Since: 0.4.0 - **/ + */ const gchar * gdata_generator_get_name (GDataGenerator *self) { @@ -238,7 +238,7 @@ gdata_generator_get_name (GDataGenerator *self) * Return value: (nullable): the generator's URI, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_generator_get_uri (GDataGenerator *self) { @@ -255,7 +255,7 @@ gdata_generator_get_uri (GDataGenerator *self) * Return value: the generator's version, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_generator_get_version (GDataGenerator *self) { diff --git a/gdata/atom/gdata-generator.h b/gdata/atom/gdata-generator.h index b436baee..d4d81d68 100644 --- a/gdata/atom/gdata-generator.h +++ b/gdata/atom/gdata-generator.h @@ -40,7 +40,7 @@ typedef struct _GDataGeneratorPrivate GDataGeneratorPrivate; * GDataGenerator: * * All the fields in the #GDataGenerator structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataGeneratorPrivate *priv; @@ -52,7 +52,7 @@ typedef struct { * All the fields in the #GDataGeneratorClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/atom/gdata-link.c b/gdata/atom/gdata-link.c index 30cb22de..49facc58 100644 --- a/gdata/atom/gdata-link.c +++ b/gdata/atom/gdata-link.c @@ -27,7 +27,7 @@ * Atom specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -91,7 +91,7 @@ gdata_link_class_init (GDataLinkClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "The link's IRI.", @@ -107,7 +107,7 @@ gdata_link_class_init (GDataLinkClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "The link relation type.", @@ -124,7 +124,7 @@ gdata_link_class_init (GDataLinkClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT_TYPE, g_param_spec_string ("content-type", "Content type", "An advisory media type.", @@ -140,7 +140,7 @@ gdata_link_class_init (GDataLinkClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LANGUAGE, g_param_spec_string ("language", "Language", "Describes the language of the resource pointed to by the uri property.", @@ -156,7 +156,7 @@ gdata_link_class_init (GDataLinkClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TITLE, g_param_spec_string ("title", "Title", "Conveys human-readable information about the link.", @@ -172,7 +172,7 @@ gdata_link_class_init (GDataLinkClass *klass) * Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LENGTH, g_param_spec_int ("length", "Length", "Indicates an advisory length of the linked content in octets.", @@ -368,7 +368,7 @@ pre_get_xml (GDataParsable *parsable, GString *xml_string) * @uri must be non-%NULL and non-empty. @relation_type must be %NULL or non-empty. * * Return value: a new #GDataLink, or %NULL; unref with g_object_unref() - **/ + */ GDataLink * gdata_link_new (const gchar *uri, const gchar *relation_type) { @@ -392,7 +392,7 @@ gdata_link_new (const gchar *uri, const gchar *relation_type) * Return value: the link's URI * * Since: 0.4.0 - **/ + */ const gchar * gdata_link_get_uri (GDataLink *self) { @@ -408,7 +408,7 @@ gdata_link_get_uri (GDataLink *self) * Sets the #GDataLink:uri property to @uri. @uri must be non-%NULL and non-empty. * * Since: 0.4.0 - **/ + */ void gdata_link_set_uri (GDataLink *self, const gchar *uri) { @@ -429,7 +429,7 @@ gdata_link_set_uri (GDataLink *self, const gchar *uri) * Return value: (nullable): the link's relation type * * Since: 0.4.0 - **/ + */ const gchar * gdata_link_get_relation_type (GDataLink *self) { @@ -448,7 +448,7 @@ gdata_link_get_relation_type (GDataLink *self) * Set @relation_type to %NULL to unset the property in the link. * * Since: 0.4.0 - **/ + */ void gdata_link_set_relation_type (GDataLink *self, const gchar *relation_type) { @@ -479,7 +479,7 @@ gdata_link_set_relation_type (GDataLink *self, const gchar *relation_type) * Return value: (nullable): the link's content type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_link_get_content_type (GDataLink *self) { @@ -497,7 +497,7 @@ gdata_link_get_content_type (GDataLink *self) * Set @content_type to %NULL to unset the property in the link. * * Since: 0.4.0 - **/ + */ void gdata_link_set_content_type (GDataLink *self, const gchar *content_type) { @@ -518,7 +518,7 @@ gdata_link_set_content_type (GDataLink *self, const gchar *content_type) * Return value: (nullable): the link's language, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_link_get_language (GDataLink *self) { @@ -536,7 +536,7 @@ gdata_link_get_language (GDataLink *self) * Set @language to %NULL to unset the property in the link. * * Since: 0.4.0 - **/ + */ void gdata_link_set_language (GDataLink *self, const gchar *language) { @@ -557,7 +557,7 @@ gdata_link_set_language (GDataLink *self, const gchar *language) * Return value: the link's title, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_link_get_title (GDataLink *self) { @@ -575,7 +575,7 @@ gdata_link_get_title (GDataLink *self) * Set @title to %NULL to unset the property in the link. * * Since: 0.4.0 - **/ + */ void gdata_link_set_title (GDataLink *self, const gchar *title) { @@ -595,7 +595,7 @@ gdata_link_set_title (GDataLink *self, const gchar *title) * Return value: the link's length, or -1 * * Since: 0.4.0 - **/ + */ gint gdata_link_get_length (GDataLink *self) { @@ -613,7 +613,7 @@ gdata_link_get_length (GDataLink *self) * Set @length to -1 to unset the property in the link. * * Since: 0.4.0 - **/ + */ void gdata_link_set_length (GDataLink *self, gint length) { diff --git a/gdata/atom/gdata-link.h b/gdata/atom/gdata-link.h index 421f18aa..75ba5d6a 100644 --- a/gdata/atom/gdata-link.h +++ b/gdata/atom/gdata-link.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * Atom specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_ALTERNATE "http://www.iana.org/assignments/relation/alternate" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * Atom specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_RELATED "http://www.iana.org/assignments/relation/related" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * Atom specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_SELF "http://www.iana.org/assignments/relation/self" /** @@ -72,7 +72,7 @@ G_BEGIN_DECLS * Atom specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_ENCLOSURE "http://www.iana.org/assignments/relation/enclosure" /** @@ -84,7 +84,7 @@ G_BEGIN_DECLS * Atom specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_VIA "http://www.iana.org/assignments/relation/via" /** @@ -96,7 +96,7 @@ G_BEGIN_DECLS * Atom Publishing Protocol specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_EDIT "http://www.iana.org/assignments/relation/edit" /** @@ -109,7 +109,7 @@ G_BEGIN_DECLS * Atom Publishing Protocol specification. * * Since: 0.4.0 - **/ + */ #define GDATA_LINK_EDIT_MEDIA "http://www.iana.org/assignments/relation/edit-media" /** @@ -140,7 +140,7 @@ typedef struct _GDataLinkPrivate GDataLinkPrivate; * GDataLink: * * All the fields in the #GDataLink structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataLinkPrivate *priv; @@ -152,7 +152,7 @@ typedef struct { * All the fields in the #GDataLinkClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/exif/gdata-exif-tags.c b/gdata/exif/gdata-exif-tags.c index fbe38416..0a456cf2 100644 --- a/gdata/exif/gdata-exif-tags.c +++ b/gdata/exif/gdata-exif-tags.c @@ -180,7 +180,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: the distance value, or -1 if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_exif_tags_get_distance (GDataExifTags *self) { @@ -197,7 +197,7 @@ gdata_exif_tags_get_distance (GDataExifTags *self) * Return value: the exposure value, or 0 if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_exif_tags_get_exposure (GDataExifTags *self) { @@ -214,7 +214,7 @@ gdata_exif_tags_get_exposure (GDataExifTags *self) * Return value: %TRUE if flash was used, %FALSE otherwise * * Since: 0.5.0 - **/ + */ gboolean gdata_exif_tags_get_flash (GDataExifTags *self) { @@ -231,7 +231,7 @@ gdata_exif_tags_get_flash (GDataExifTags *self) * Return value: the focal-length value, or -1 if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_exif_tags_get_focal_length (GDataExifTags *self) { @@ -248,7 +248,7 @@ gdata_exif_tags_get_focal_length (GDataExifTags *self) * Return value: the F-stop value, or 0 if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_exif_tags_get_fstop (GDataExifTags *self) { @@ -265,7 +265,7 @@ gdata_exif_tags_get_fstop (GDataExifTags *self) * Return value: the photo's unique EXIF identifier, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_exif_tags_get_image_unique_id (GDataExifTags *self) { @@ -282,7 +282,7 @@ gdata_exif_tags_get_image_unique_id (GDataExifTags *self) * Return value: the ISO speed, or -1 if unknown * * Since: 0.5.0 - **/ + */ gint gdata_exif_tags_get_iso (GDataExifTags *self) { @@ -299,7 +299,7 @@ gdata_exif_tags_get_iso (GDataExifTags *self) * Return value: the name of the manufacturer of the camera, or %NULL if unknown * * Since: 0.5.0 - **/ + */ const gchar * gdata_exif_tags_get_make (GDataExifTags *self) { @@ -316,7 +316,7 @@ gdata_exif_tags_get_make (GDataExifTags *self) * Return value: the model name of the camera, or %NULL if unknown * * Since: 0.5.0 - **/ + */ const gchar * gdata_exif_tags_get_model (GDataExifTags *self) { @@ -334,7 +334,7 @@ gdata_exif_tags_get_model (GDataExifTags *self) * Return value: the UNIX timestamp for the time property in milliseconds, or -1 * * Since: 0.5.0 - **/ + */ gint64 gdata_exif_tags_get_time (GDataExifTags *self) { diff --git a/gdata/exif/gdata-exif-tags.h b/gdata/exif/gdata-exif-tags.h index 0eb37585..efb586f9 100644 --- a/gdata/exif/gdata-exif-tags.h +++ b/gdata/exif/gdata-exif-tags.h @@ -42,7 +42,7 @@ typedef struct _GDataExifTagsPrivate GDataExifTagsPrivate; * All the fields in the #GDataExifTags structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { GDataParsable parent; GDataExifTagsPrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataExifTagsClass structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-calendar.c b/gdata/gcontact/gdata-gcontact-calendar.c index 80b2d12b..90562d24 100644 --- a/gdata/gcontact/gdata-gcontact-calendar.c +++ b/gdata/gcontact/gdata-gcontact-calendar.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -89,7 +89,7 @@ gdata_gcontact_calendar_class_init (GDataGContactCalendarClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "The URI of the calendar.", @@ -106,7 +106,7 @@ gdata_gcontact_calendar_class_init (GDataGContactCalendarClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of calendar.", @@ -122,7 +122,7 @@ gdata_gcontact_calendar_class_init (GDataGContactCalendarClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A free-form string that identifies the type of calendar.", @@ -138,7 +138,7 @@ gdata_gcontact_calendar_class_init (GDataGContactCalendarClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which calendar out of a group is primary.", @@ -312,7 +312,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactCalendar; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactCalendar * gdata_gcontact_calendar_new (const gchar *uri, const gchar *relation_type, const gchar *label, gboolean is_primary) { @@ -333,7 +333,7 @@ gdata_gcontact_calendar_new (const gchar *uri, const gchar *relation_type, const * Return value: the calendar's URI * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_calendar_get_uri (GDataGContactCalendar *self) { @@ -349,7 +349,7 @@ gdata_gcontact_calendar_get_uri (GDataGContactCalendar *self) * Sets the #GDataGContactCalendar:uri property to @uri. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_calendar_set_uri (GDataGContactCalendar *self, const gchar *uri) { @@ -370,7 +370,7 @@ gdata_gcontact_calendar_set_uri (GDataGContactCalendar *self, const gchar *uri) * Return value: the type of the relation, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_calendar_get_relation_type (GDataGContactCalendar *self) { @@ -390,7 +390,7 @@ gdata_gcontact_calendar_get_relation_type (GDataGContactCalendar *self) * exactly one of #GDataGContactCalendar:relation-type and #GDataGContactCalendar:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_calendar_set_relation_type (GDataGContactCalendar *self, const gchar *relation_type) { @@ -411,7 +411,7 @@ gdata_gcontact_calendar_set_relation_type (GDataGContactCalendar *self, const gc * Return value: a free-form label for the calendar, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_calendar_get_label (GDataGContactCalendar *self) { @@ -430,7 +430,7 @@ gdata_gcontact_calendar_get_label (GDataGContactCalendar *self) * exactly one of #GDataGContactCalendar:relation-type and #GDataGContactCalendar:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_calendar_set_label (GDataGContactCalendar *self, const gchar *label) { @@ -451,7 +451,7 @@ gdata_gcontact_calendar_set_label (GDataGContactCalendar *self, const gchar *lab * Return value: %TRUE if this is the contact's primary calendar, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gboolean gdata_gcontact_calendar_is_primary (GDataGContactCalendar *self) { @@ -467,7 +467,7 @@ gdata_gcontact_calendar_is_primary (GDataGContactCalendar *self) * Sets the #GDataGContactCalendar:is-primary property to @is_primary. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_calendar_set_is_primary (GDataGContactCalendar *self, gboolean is_primary) { diff --git a/gdata/gcontact/gdata-gcontact-calendar.h b/gdata/gcontact/gdata-gcontact-calendar.h index a225ebc7..125ee6d7 100644 --- a/gdata/gcontact/gdata-gcontact-calendar.h +++ b/gdata/gcontact/gdata-gcontact-calendar.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_CALENDAR_WORK "work" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_CALENDAR_HOME "home" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_CALENDAR_FREE_BUSY "free-busy" #define GDATA_TYPE_GCONTACT_CALENDAR (gdata_gcontact_calendar_get_type ()) @@ -78,7 +78,7 @@ typedef struct _GDataGContactCalendarPrivate GDataGContactCalendarPrivate; * All the fields in the #GDataGContactCalendar structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactCalendarPrivate *priv; @@ -90,7 +90,7 @@ typedef struct { * All the fields in the #GDataGContactCalendarClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-event.c b/gdata/gcontact/gdata-gcontact-event.c index d595b14e..6ea8257d 100644 --- a/gdata/gcontact/gdata-gcontact-event.c +++ b/gdata/gcontact/gdata-gcontact-event.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -91,7 +91,7 @@ gdata_gcontact_event_class_init (GDataGContactEventClass *klass) * GContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DATE, g_param_spec_boxed ("date", "Date", "The date of the event.", @@ -108,7 +108,7 @@ gdata_gcontact_event_class_init (GDataGContactEventClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of website.", @@ -125,7 +125,7 @@ gdata_gcontact_event_class_init (GDataGContactEventClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this event.", @@ -317,7 +317,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactEvent; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactEvent * gdata_gcontact_event_new (const GDate *date, const gchar *relation_type, const gchar *label) { @@ -336,7 +336,7 @@ gdata_gcontact_event_new (const GDate *date, const gchar *relation_type, const g * Gets the #GDataGContactEvent:date property. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_event_get_date (GDataGContactEvent *self, GDate *date) { @@ -353,7 +353,7 @@ gdata_gcontact_event_get_date (GDataGContactEvent *self, GDate *date) * Sets the #GDataGContactEvent:date property to @date. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_event_set_date (GDataGContactEvent *self, const GDate *date) { @@ -373,7 +373,7 @@ gdata_gcontact_event_set_date (GDataGContactEvent *self, const GDate *date) * Return value: the event's relation type, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_event_get_relation_type (GDataGContactEvent *self) { @@ -393,7 +393,7 @@ gdata_gcontact_event_get_relation_type (GDataGContactEvent *self) * exactly one of #GDataGContactEvent:relation-type and #GDataGContactEvent:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_event_set_relation_type (GDataGContactEvent *self, const gchar *relation_type) { @@ -414,7 +414,7 @@ gdata_gcontact_event_set_relation_type (GDataGContactEvent *self, const gchar *r * Return value: the event's label, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_event_get_label (GDataGContactEvent *self) { @@ -433,7 +433,7 @@ gdata_gcontact_event_get_label (GDataGContactEvent *self) * exactly one of #GDataGContactEvent:relation-type and #GDataGContactEvent:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_event_set_label (GDataGContactEvent *self, const gchar *label) { diff --git a/gdata/gcontact/gdata-gcontact-event.h b/gdata/gcontact/gdata-gcontact-event.h index bf3d2d17..d1c68755 100644 --- a/gdata/gcontact/gdata-gcontact-event.h +++ b/gdata/gcontact/gdata-gcontact-event.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_EVENT_ANNIVERSARY "anniversary" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_EVENT_OTHER "other" #define GDATA_TYPE_GCONTACT_EVENT (gdata_gcontact_event_get_type ()) @@ -66,7 +66,7 @@ typedef struct _GDataGContactEventPrivate GDataGContactEventPrivate; * All the fields in the #GDataGContactEvent structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactEventPrivate *priv; @@ -78,7 +78,7 @@ typedef struct { * All the fields in the #GDataGContactEventClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-external-id.c b/gdata/gcontact/gdata-gcontact-external-id.c index 480e29d2..3da3ef07 100644 --- a/gdata/gcontact/gdata-gcontact-external-id.c +++ b/gdata/gcontact/gdata-gcontact-external-id.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -87,7 +87,7 @@ gdata_gcontact_external_id_class_init (GDataGContactExternalIDClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VALUE, g_param_spec_string ("value", "Value", "The value of the external ID.", @@ -104,7 +104,7 @@ gdata_gcontact_external_id_class_init (GDataGContactExternalIDClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of external ID.", @@ -120,7 +120,7 @@ gdata_gcontact_external_id_class_init (GDataGContactExternalIDClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A free-form string that identifies the type of external ID.", @@ -276,7 +276,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactExternalID; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactExternalID * gdata_gcontact_external_id_new (const gchar *value, const gchar *relation_type, const gchar *label) { @@ -296,7 +296,7 @@ gdata_gcontact_external_id_new (const gchar *value, const gchar *relation_type, * Return value: the external ID's value * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_external_id_get_value (GDataGContactExternalID *self) { @@ -312,7 +312,7 @@ gdata_gcontact_external_id_get_value (GDataGContactExternalID *self) * Sets the #GDataGContactExternalID:value property to @value. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_external_id_set_value (GDataGContactExternalID *self, const gchar *value) { @@ -333,7 +333,7 @@ gdata_gcontact_external_id_set_value (GDataGContactExternalID *self, const gchar * Return value: the type of the relation, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_external_id_get_relation_type (GDataGContactExternalID *self) { @@ -353,7 +353,7 @@ gdata_gcontact_external_id_get_relation_type (GDataGContactExternalID *self) * exactly one of #GDataGContactExternalID:relation-type and #GDataGContactExternalID:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_external_id_set_relation_type (GDataGContactExternalID *self, const gchar *relation_type) { @@ -374,7 +374,7 @@ gdata_gcontact_external_id_set_relation_type (GDataGContactExternalID *self, con * Return value: a free-form label for the external ID, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_external_id_get_label (GDataGContactExternalID *self) { @@ -393,7 +393,7 @@ gdata_gcontact_external_id_get_label (GDataGContactExternalID *self) * exactly one of #GDataGContactExternalID:relation-type and #GDataGContactExternalID:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_external_id_set_label (GDataGContactExternalID *self, const gchar *label) { diff --git a/gdata/gcontact/gdata-gcontact-external-id.h b/gdata/gcontact/gdata-gcontact-external-id.h index ab8afd5e..e0a35f4f 100644 --- a/gdata/gcontact/gdata-gcontact-external-id.h +++ b/gdata/gcontact/gdata-gcontact-external-id.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_EXTERNAL_ID_ACCOUNT "account" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_EXTERNAL_ID_CUSTOMER "customer" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_EXTERNAL_ID_NETWORK "network" /** @@ -72,7 +72,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_EXTERNAL_ID_ORGANIZATION "organization" #define GDATA_TYPE_GCONTACT_EXTERNAL_ID (gdata_gcontact_external_id_get_type ()) @@ -90,7 +90,7 @@ typedef struct _GDataGContactExternalIDPrivate GDataGContactExternalIDPrivate; * All the fields in the #GDataGContactExternalID structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactExternalIDPrivate *priv; @@ -102,7 +102,7 @@ typedef struct { * All the fields in the #GDataGContactExternalIDClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-jot.c b/gdata/gcontact/gdata-gcontact-jot.c index 3eedcca9..0e58d1b8 100644 --- a/gdata/gcontact/gdata-gcontact-jot.c +++ b/gdata/gcontact/gdata-gcontact-jot.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -86,7 +86,7 @@ gdata_gcontact_jot_class_init (GDataGContactJotClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT, g_param_spec_string ("content", "Content", "The content of the jot.", @@ -102,7 +102,7 @@ gdata_gcontact_jot_class_init (GDataGContactJotClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of jot.", @@ -223,7 +223,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactJot; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactJot * gdata_gcontact_jot_new (const gchar *content, const gchar *relation_type) { @@ -241,7 +241,7 @@ gdata_gcontact_jot_new (const gchar *content, const gchar *relation_type) * Return value: the jot's content * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_jot_get_content (GDataGContactJot *self) { @@ -257,7 +257,7 @@ gdata_gcontact_jot_get_content (GDataGContactJot *self) * Sets the #GDataGContactJot:content property to @content. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_jot_set_content (GDataGContactJot *self, const gchar *content) { @@ -278,7 +278,7 @@ gdata_gcontact_jot_set_content (GDataGContactJot *self, const gchar *content) * Return value: the jot's relation type * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_jot_get_relation_type (GDataGContactJot *self) { @@ -295,7 +295,7 @@ gdata_gcontact_jot_get_relation_type (GDataGContactJot *self) * such as %GDATA_GCONTACT_JOT_HOME or %GDATA_GCONTACT_JOT_OTHER. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_jot_set_relation_type (GDataGContactJot *self, const gchar *relation_type) { diff --git a/gdata/gcontact/gdata-gcontact-jot.h b/gdata/gcontact/gdata-gcontact-jot.h index 556e51be..b9272b9b 100644 --- a/gdata/gcontact/gdata-gcontact-jot.h +++ b/gdata/gcontact/gdata-gcontact-jot.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_JOT_HOME "home" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_JOT_WORK "work" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_JOT_OTHER "other" /** @@ -72,7 +72,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_JOT_KEYWORDS "keywords" /** @@ -84,7 +84,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_JOT_USER "user" #define GDATA_TYPE_GCONTACT_JOT (gdata_gcontact_jot_get_type ()) @@ -102,7 +102,7 @@ typedef struct _GDataGContactJotPrivate GDataGContactJotPrivate; * All the fields in the #GDataGContactJot structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactJotPrivate *priv; @@ -114,7 +114,7 @@ typedef struct { * All the fields in the #GDataGContactJotClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-language.c b/gdata/gcontact/gdata-gcontact-language.c index ac524892..5fe867f9 100644 --- a/gdata/gcontact/gdata-gcontact-language.c +++ b/gdata/gcontact/gdata-gcontact-language.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -85,7 +85,7 @@ gdata_gcontact_language_class_init (GDataGContactLanguageClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CODE, g_param_spec_string ("code", "Code", "A code identifying the language, conforming to the IETF BCP 47 specification.", @@ -101,7 +101,7 @@ gdata_gcontact_language_class_init (GDataGContactLanguageClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A free-form string that identifies the language.", @@ -238,7 +238,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactLanguage; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactLanguage * gdata_gcontact_language_new (const gchar *code, const gchar *label) { @@ -255,7 +255,7 @@ gdata_gcontact_language_new (const gchar *code, const gchar *label) * Return value: the language's code, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_language_get_code (GDataGContactLanguage *self) { @@ -274,7 +274,7 @@ gdata_gcontact_language_get_code (GDataGContactLanguage *self) * exactly one of #GDataGContactLanguage:code and #GDataGContactLanguage:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_language_set_code (GDataGContactLanguage *self, const gchar *code) { @@ -295,7 +295,7 @@ gdata_gcontact_language_set_code (GDataGContactLanguage *self, const gchar *code * Return value: a free-form label for the language, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_language_get_label (GDataGContactLanguage *self) { @@ -314,7 +314,7 @@ gdata_gcontact_language_get_label (GDataGContactLanguage *self) * exactly one of #GDataGContactLanguage:code and #GDataGContactLanguage:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_language_set_label (GDataGContactLanguage *self, const gchar *label) { diff --git a/gdata/gcontact/gdata-gcontact-language.h b/gdata/gcontact/gdata-gcontact-language.h index 71e4f8c6..acd9265d 100644 --- a/gdata/gcontact/gdata-gcontact-language.h +++ b/gdata/gcontact/gdata-gcontact-language.h @@ -42,7 +42,7 @@ typedef struct _GDataGContactLanguagePrivate GDataGContactLanguagePrivate; * All the fields in the #GDataGContactLanguage structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactLanguagePrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataGContactLanguageClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-relation.c b/gdata/gcontact/gdata-gcontact-relation.c index 9d1062e2..b562fa47 100644 --- a/gdata/gcontact/gdata-gcontact-relation.c +++ b/gdata/gcontact/gdata-gcontact-relation.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -88,7 +88,7 @@ gdata_gcontact_relation_class_init (GDataGContactRelationClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_string ("name", "Name", "The name of the relation.", @@ -105,7 +105,7 @@ gdata_gcontact_relation_class_init (GDataGContactRelationClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of relation.", @@ -121,7 +121,7 @@ gdata_gcontact_relation_class_init (GDataGContactRelationClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A free-form string that identifies the type of relation.", @@ -276,7 +276,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactRelation; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactRelation * gdata_gcontact_relation_new (const gchar *name, const gchar *relation_type, const gchar *label) { @@ -296,7 +296,7 @@ gdata_gcontact_relation_new (const gchar *name, const gchar *relation_type, cons * Return value: the relation's name * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_relation_get_name (GDataGContactRelation *self) { @@ -312,7 +312,7 @@ gdata_gcontact_relation_get_name (GDataGContactRelation *self) * Sets the #GDataGContactRelation:name property to @name. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_relation_set_name (GDataGContactRelation *self, const gchar *name) { @@ -333,7 +333,7 @@ gdata_gcontact_relation_set_name (GDataGContactRelation *self, const gchar *name * Return value: the type of the relation, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_relation_get_relation_type (GDataGContactRelation *self) { @@ -353,7 +353,7 @@ gdata_gcontact_relation_get_relation_type (GDataGContactRelation *self) * exactly one of #GDataGContactRelation:relation-type and #GDataGContactRelation:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_relation_set_relation_type (GDataGContactRelation *self, const gchar *relation_type) { @@ -374,7 +374,7 @@ gdata_gcontact_relation_set_relation_type (GDataGContactRelation *self, const gc * Return value: a free-form label for the type of the relation, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_relation_get_label (GDataGContactRelation *self) { @@ -393,7 +393,7 @@ gdata_gcontact_relation_get_label (GDataGContactRelation *self) * exactly one of #GDataGContactRelation:relation-type and #GDataGContactRelation:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_relation_set_label (GDataGContactRelation *self, const gchar *label) { diff --git a/gdata/gcontact/gdata-gcontact-relation.h b/gdata/gcontact/gdata-gcontact-relation.h index d3fd8090..74cad065 100644 --- a/gdata/gcontact/gdata-gcontact-relation.h +++ b/gdata/gcontact/gdata-gcontact-relation.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_ASSISTANT "assistant" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_BROTHER "brother" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_CHILD "child" /** @@ -72,7 +72,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_DOMESTIC_PARTNER "domestic-partner" /** @@ -84,7 +84,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_FATHER "father" /** @@ -96,7 +96,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_FRIEND "friend" /** @@ -108,7 +108,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_MANAGER "manager" /** @@ -120,7 +120,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_MOTHER "mother" /** @@ -132,7 +132,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_PARENT "parent" /** @@ -144,7 +144,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_PARTNER "partner" /** @@ -156,7 +156,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_REFERRER "referred-by" /** @@ -168,7 +168,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_RELATIVE "relative" /** @@ -180,7 +180,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_SISTER "sister" /** @@ -192,7 +192,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_RELATION_SPOUSE "spouse" #define GDATA_TYPE_GCONTACT_RELATION (gdata_gcontact_relation_get_type ()) @@ -210,7 +210,7 @@ typedef struct _GDataGContactRelationPrivate GDataGContactRelationPrivate; * All the fields in the #GDataGContactRelation structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactRelationPrivate *priv; @@ -222,7 +222,7 @@ typedef struct { * All the fields in the #GDataGContactRelationClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gcontact/gdata-gcontact-website.c b/gdata/gcontact/gdata-gcontact-website.c index 9340bded..e0ec4c6f 100644 --- a/gdata/gcontact/gdata-gcontact-website.c +++ b/gdata/gcontact/gdata-gcontact-website.c @@ -27,7 +27,7 @@ * gContact specification. * * Since: 0.7.0 - **/ + */ #include #include @@ -89,7 +89,7 @@ gdata_gcontact_website_class_init (GDataGContactWebsiteClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "The URI of the website.", @@ -106,7 +106,7 @@ gdata_gcontact_website_class_init (GDataGContactWebsiteClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of website.", @@ -123,7 +123,7 @@ gdata_gcontact_website_class_init (GDataGContactWebsiteClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this website.", @@ -139,7 +139,7 @@ gdata_gcontact_website_class_init (GDataGContactWebsiteClass *klass) * gContact specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which website out of a group is primary.", @@ -314,7 +314,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGContactWebsite; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataGContactWebsite * gdata_gcontact_website_new (const gchar *uri, const gchar *relation_type, const gchar *label, gboolean is_primary) { @@ -335,7 +335,7 @@ gdata_gcontact_website_new (const gchar *uri, const gchar *relation_type, const * Return value: the URI of the website * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_website_get_uri (GDataGContactWebsite *self) { @@ -351,7 +351,7 @@ gdata_gcontact_website_get_uri (GDataGContactWebsite *self) * Sets the #GDataGContactWebsite:uri property to @uri. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_website_set_uri (GDataGContactWebsite *self, const gchar *uri) { @@ -372,7 +372,7 @@ gdata_gcontact_website_set_uri (GDataGContactWebsite *self, const gchar *uri) * Return value: the website's relation type * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_website_get_relation_type (GDataGContactWebsite *self) { @@ -392,7 +392,7 @@ gdata_gcontact_website_get_relation_type (GDataGContactWebsite *self) * exactly one of #GDataGContactWebsite:relation-type and #GDataGContactWebsite:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_website_set_relation_type (GDataGContactWebsite *self, const gchar *relation_type) { @@ -413,7 +413,7 @@ gdata_gcontact_website_set_relation_type (GDataGContactWebsite *self, const gcha * Return value: the website's label, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_gcontact_website_get_label (GDataGContactWebsite *self) { @@ -432,7 +432,7 @@ gdata_gcontact_website_get_label (GDataGContactWebsite *self) * exactly one of #GDataGContactWebsite:relation-type and #GDataGContactWebsite:label must be %NULL. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_website_set_label (GDataGContactWebsite *self, const gchar *label) { @@ -454,7 +454,7 @@ gdata_gcontact_website_set_label (GDataGContactWebsite *self, const gchar *label * Return value: %TRUE if this is the primary website, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gboolean gdata_gcontact_website_is_primary (GDataGContactWebsite *self) { @@ -470,7 +470,7 @@ gdata_gcontact_website_is_primary (GDataGContactWebsite *self) * Sets the #GDataGContactWebsite:is-primary property to @is_primary. * * Since: 0.7.0 - **/ + */ void gdata_gcontact_website_set_is_primary (GDataGContactWebsite *self, gboolean is_primary) { diff --git a/gdata/gcontact/gdata-gcontact-website.h b/gdata/gcontact/gdata-gcontact-website.h index deeced7b..c96d30b1 100644 --- a/gdata/gcontact/gdata-gcontact-website.h +++ b/gdata/gcontact/gdata-gcontact-website.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_HOME_PAGE "home-page" /** @@ -48,7 +48,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_BLOG "blog" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_PROFILE "profile" /** @@ -72,7 +72,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_HOME "home" /** @@ -84,7 +84,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_WORK "work" /** @@ -96,7 +96,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_OTHER "other" /** @@ -108,7 +108,7 @@ G_BEGIN_DECLS * gContact specification. * * Since: 0.7.0 - **/ + */ #define GDATA_GCONTACT_WEBSITE_FTP "ftp" #define GDATA_TYPE_GCONTACT_WEBSITE (gdata_gcontact_website_get_type ()) @@ -126,7 +126,7 @@ typedef struct _GDataGContactWebsitePrivate GDataGContactWebsitePrivate; * All the fields in the #GDataGContactWebsite structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GDataParsable parent; GDataGContactWebsitePrivate *priv; @@ -138,7 +138,7 @@ typedef struct { * All the fields in the #GDataGContactWebsiteClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-email-address.c b/gdata/gd/gdata-gd-email-address.c index 2950e664..63ae95bb 100644 --- a/gdata/gd/gdata-gd-email-address.c +++ b/gdata/gd/gdata-gd-email-address.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -91,7 +91,7 @@ gdata_gd_email_address_class_init (GDataGDEmailAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ADDRESS, g_param_spec_string ("address", "Address", "The e-mail address itself.", @@ -107,7 +107,7 @@ gdata_gd_email_address_class_init (GDataGDEmailAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of e-mail address.", @@ -123,7 +123,7 @@ gdata_gd_email_address_class_init (GDataGDEmailAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this e-mail address.", @@ -139,7 +139,7 @@ gdata_gd_email_address_class_init (GDataGDEmailAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which e-mail address out of a group is primary.", @@ -155,7 +155,7 @@ gdata_gd_email_address_class_init (GDataGDEmailAddressClass *klass) * GData specification. * * Since: 0.6.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DISPLAY_NAME, g_param_spec_string ("display-name", "Display name", "A display name of the entity the e-mail address belongs to.", @@ -322,7 +322,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDEmailAddress, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDEmailAddress * gdata_gd_email_address_new (const gchar *address, const gchar *relation_type, const gchar *label, gboolean is_primary) { @@ -341,7 +341,7 @@ gdata_gd_email_address_new (const gchar *address, const gchar *relation_type, co * Return value: the e-mail address itself, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_email_address_get_address (GDataGDEmailAddress *self) { @@ -357,7 +357,7 @@ gdata_gd_email_address_get_address (GDataGDEmailAddress *self) * Sets the #GDataGDEmailAddress:address property to @address. * * Since: 0.4.0 - **/ + */ void gdata_gd_email_address_set_address (GDataGDEmailAddress *self, const gchar *address) { @@ -378,7 +378,7 @@ gdata_gd_email_address_set_address (GDataGDEmailAddress *self, const gchar *addr * Return value: the e-mail address' relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_email_address_get_relation_type (GDataGDEmailAddress *self) { @@ -396,7 +396,7 @@ gdata_gd_email_address_get_relation_type (GDataGDEmailAddress *self) * Set @relation_type to %NULL to unset the property in the e-mail address. * * Since: 0.4.0 - **/ + */ void gdata_gd_email_address_set_relation_type (GDataGDEmailAddress *self, const gchar *relation_type) { @@ -417,7 +417,7 @@ gdata_gd_email_address_set_relation_type (GDataGDEmailAddress *self, const gchar * Return value: the e-mail address' label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_email_address_get_label (GDataGDEmailAddress *self) { @@ -435,7 +435,7 @@ gdata_gd_email_address_get_label (GDataGDEmailAddress *self) * Set @label to %NULL to unset the property in the e-mail address. * * Since: 0.4.0 - **/ + */ void gdata_gd_email_address_set_label (GDataGDEmailAddress *self, const gchar *label) { @@ -455,7 +455,7 @@ gdata_gd_email_address_set_label (GDataGDEmailAddress *self, const gchar *label) * Return value: %TRUE if this is the primary e-mail address, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_email_address_is_primary (GDataGDEmailAddress *self) { @@ -471,7 +471,7 @@ gdata_gd_email_address_is_primary (GDataGDEmailAddress *self) * Sets the #GDataGDEmailAddress:is-primary property to @is_primary. * * Since: 0.4.0 - **/ + */ void gdata_gd_email_address_set_is_primary (GDataGDEmailAddress *self, gboolean is_primary) { @@ -490,7 +490,7 @@ gdata_gd_email_address_set_is_primary (GDataGDEmailAddress *self, gboolean is_pr * Return value: a display name for the e-mail address, or %NULL * * Since: 0.6.0 - **/ + */ const gchar * gdata_gd_email_address_get_display_name (GDataGDEmailAddress *self) { @@ -508,7 +508,7 @@ gdata_gd_email_address_get_display_name (GDataGDEmailAddress *self) * Set @display_name to %NULL to unset the property in the e-mail address. * * Since: 0.6.0 - **/ + */ void gdata_gd_email_address_set_display_name (GDataGDEmailAddress *self, const gchar *display_name) { diff --git a/gdata/gd/gdata-gd-email-address.h b/gdata/gd/gdata-gd-email-address.h index 701a0319..588f9a93 100644 --- a/gdata/gd/gdata-gd-email-address.h +++ b/gdata/gd/gdata-gd-email-address.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The relation type URI for a home e-mail address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EMAIL_ADDRESS_HOME "http://schemas.google.com/g/2005#home" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The relation type URI for a miscellaneous e-mail address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EMAIL_ADDRESS_OTHER "http://schemas.google.com/g/2005#other" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The relation type URI for a work e-mail address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EMAIL_ADDRESS_WORK "http://schemas.google.com/g/2005#work" #define GDATA_TYPE_GD_EMAIL_ADDRESS (gdata_gd_email_address_get_type ()) @@ -69,7 +69,7 @@ typedef struct _GDataGDEmailAddressPrivate GDataGDEmailAddressPrivate; * All the fields in the #GDataGDEmailAddress structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDEmailAddressPrivate *priv; @@ -81,7 +81,7 @@ typedef struct { * All the fields in the #GDataGDEmailAddressClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-im-address.c b/gdata/gd/gdata-gd-im-address.c index eae29e7c..5b446801 100644 --- a/gdata/gd/gdata-gd-im-address.c +++ b/gdata/gd/gdata-gd-im-address.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -91,7 +91,7 @@ gdata_gd_im_address_class_init (GDataGDIMAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ADDRESS, g_param_spec_string ("address", "Address", "The IM address itself.", @@ -107,7 +107,7 @@ gdata_gd_im_address_class_init (GDataGDIMAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_PROTOCOL, g_param_spec_string ("protocol", "Protocol", "Identifies the IM network.", @@ -123,7 +123,7 @@ gdata_gd_im_address_class_init (GDataGDIMAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of IM address.", @@ -139,7 +139,7 @@ gdata_gd_im_address_class_init (GDataGDIMAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this IM address.", @@ -155,7 +155,7 @@ gdata_gd_im_address_class_init (GDataGDIMAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which IM address out of a group is primary.", @@ -328,7 +328,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDIMAddress, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDIMAddress * gdata_gd_im_address_new (const gchar *address, const gchar *protocol, const gchar *relation_type, const gchar *label, gboolean is_primary) { @@ -348,7 +348,7 @@ gdata_gd_im_address_new (const gchar *address, const gchar *protocol, const gcha * Return value: the IM address itself, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_im_address_get_address (GDataGDIMAddress *self) { @@ -364,7 +364,7 @@ gdata_gd_im_address_get_address (GDataGDIMAddress *self) * Sets the #GDataGDIMAddress:address property to @address. * * Since: 0.4.0 - **/ + */ void gdata_gd_im_address_set_address (GDataGDIMAddress *self, const gchar *address) { @@ -385,7 +385,7 @@ gdata_gd_im_address_set_address (GDataGDIMAddress *self, const gchar *address) * Return value: the IM address' protocol, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_im_address_get_protocol (GDataGDIMAddress *self) { @@ -401,7 +401,7 @@ gdata_gd_im_address_get_protocol (GDataGDIMAddress *self) * Sets the #GDataGDIMAddress:protocol property to @protocol. * * Since: 0.4.0 - **/ + */ void gdata_gd_im_address_set_protocol (GDataGDIMAddress *self, const gchar *protocol) { @@ -422,7 +422,7 @@ gdata_gd_im_address_set_protocol (GDataGDIMAddress *self, const gchar *protocol) * Return value: the IM address' relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_im_address_get_relation_type (GDataGDIMAddress *self) { @@ -440,7 +440,7 @@ gdata_gd_im_address_get_relation_type (GDataGDIMAddress *self) * Set @relation_type to %NULL to unset the property in the IM address. * * Since: 0.4.0 - **/ + */ void gdata_gd_im_address_set_relation_type (GDataGDIMAddress *self, const gchar *relation_type) { @@ -461,7 +461,7 @@ gdata_gd_im_address_set_relation_type (GDataGDIMAddress *self, const gchar *rela * Return value: the IM address' label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_im_address_get_label (GDataGDIMAddress *self) { @@ -479,7 +479,7 @@ gdata_gd_im_address_get_label (GDataGDIMAddress *self) * Set @label to %NULL to unset the property in the IM address. * * Since: 0.4.0 - **/ + */ void gdata_gd_im_address_set_label (GDataGDIMAddress *self, const gchar *label) { @@ -499,7 +499,7 @@ gdata_gd_im_address_set_label (GDataGDIMAddress *self, const gchar *label) * Return value: %TRUE if this is the primary IM address, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_im_address_is_primary (GDataGDIMAddress *self) { @@ -515,7 +515,7 @@ gdata_gd_im_address_is_primary (GDataGDIMAddress *self) * Sets the #GDataGDIMAddress:is-primary property to @is_primary. * * Since: 0.4.0 - **/ + */ void gdata_gd_im_address_set_is_primary (GDataGDIMAddress *self, gboolean is_primary) { diff --git a/gdata/gd/gdata-gd-im-address.h b/gdata/gd/gdata-gd-im-address.h index 9e2d82cd..9e717c1f 100644 --- a/gdata/gd/gdata-gd-im-address.h +++ b/gdata/gd/gdata-gd-im-address.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The relation type URI for a home IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_ADDRESS_HOME "http://schemas.google.com/g/2005#home" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The relation type URI for a Microsoft NetMeeting IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_ADDRESS_NETMEETING "http://schemas.google.com/g/2005#netmeeting" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The relation type URI for a miscellaneous IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_ADDRESS_OTHER "http://schemas.google.com/g/2005#other" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * The relation type URI for a work IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_ADDRESS_WORK "http://schemas.google.com/g/2005#work" /** @@ -69,7 +69,7 @@ G_BEGIN_DECLS * The protocol type URI for an AIM IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_AIM "http://schemas.google.com/g/2005#AIM" /** @@ -78,7 +78,7 @@ G_BEGIN_DECLS * The protocol type URI for an Windows Live Messenger IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_LIVE_MESSENGER "http://schemas.google.com/g/2005#MSN" /** @@ -87,7 +87,7 @@ G_BEGIN_DECLS * The protocol type URI for a Yahoo! Messenger IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_YAHOO_MESSENGER "http://schemas.google.com/g/2005#YAHOO" /** @@ -96,7 +96,7 @@ G_BEGIN_DECLS * The protocol type URI for a Skype IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_SKYPE "http://schemas.google.com/g/2005#SKYPE" /** @@ -105,7 +105,7 @@ G_BEGIN_DECLS * The protocol type URI for a QQ IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_QQ "http://schemas.google.com/g/2005#QQ" /** @@ -114,7 +114,7 @@ G_BEGIN_DECLS * The protocol type URI for a Google Talk IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_GOOGLE_TALK "http://schemas.google.com/g/2005#GOOGLE_TALK" /** @@ -123,7 +123,7 @@ G_BEGIN_DECLS * The protocol type URI for an ICQ IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_ICQ "http://schemas.google.com/g/2005#ICQ" /** @@ -132,7 +132,7 @@ G_BEGIN_DECLS * The protocol type URI for a Jabber IM address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_IM_PROTOCOL_JABBER "http://schemas.google.com/g/2005#JABBER" #define GDATA_TYPE_GD_IM_ADDRESS (gdata_gd_im_address_get_type ()) @@ -150,7 +150,7 @@ typedef struct _GDataGDIMAddressPrivate GDataGDIMAddressPrivate; * All the fields in the #GDataGDIMAddress structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDIMAddressPrivate *priv; @@ -162,7 +162,7 @@ typedef struct { * All the fields in the #GDataGDIMAddressClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-name.c b/gdata/gd/gdata-gd-name.c index 32d1dd57..4c1fde67 100644 --- a/gdata/gd/gdata-gd-name.c +++ b/gdata/gd/gdata-gd-name.c @@ -37,7 +37,7 @@ * * * Since: 0.5.0 - **/ + */ #include #include @@ -103,7 +103,7 @@ gdata_gd_name_class_init (GDataGDNameClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_GIVEN_NAME, g_param_spec_string ("given-name", "Given name", "The person's given name.", @@ -119,7 +119,7 @@ gdata_gd_name_class_init (GDataGDNameClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ADDITIONAL_NAME, g_param_spec_string ("additional-name", "Additional name", "An additional name for the person (e.g. a middle name).", @@ -135,7 +135,7 @@ gdata_gd_name_class_init (GDataGDNameClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FAMILY_NAME, g_param_spec_string ("family-name", "Family name", "The person's family name.", @@ -151,7 +151,7 @@ gdata_gd_name_class_init (GDataGDNameClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_PREFIX, g_param_spec_string ("prefix", "Prefix", "An honorific prefix.", @@ -167,7 +167,7 @@ gdata_gd_name_class_init (GDataGDNameClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SUFFIX, g_param_spec_string ("suffix", "Suffix", "An honorific suffix.", @@ -184,7 +184,7 @@ gdata_gd_name_class_init (GDataGDNameClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FULL_NAME, g_param_spec_string ("full-name", "Full name", "An unstructured representation of the person's full name.", @@ -352,7 +352,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDName, or %NULL; unref with g_object_unref() * * Since: 0.5.0 - **/ + */ GDataGDName * gdata_gd_name_new (const gchar *given_name, const gchar *family_name) { @@ -370,7 +370,7 @@ gdata_gd_name_new (const gchar *given_name, const gchar *family_name) * Return value: the person's given name, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_name_get_given_name (GDataGDName *self) { @@ -386,7 +386,7 @@ gdata_gd_name_get_given_name (GDataGDName *self) * Sets the #GDataGDName:given-name property to @given_name. * * Since: 0.5.0 - **/ + */ void gdata_gd_name_set_given_name (GDataGDName *self, const gchar *given_name) { @@ -407,7 +407,7 @@ gdata_gd_name_set_given_name (GDataGDName *self, const gchar *given_name) * Return value: the person's additional name, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_name_get_additional_name (GDataGDName *self) { @@ -423,7 +423,7 @@ gdata_gd_name_get_additional_name (GDataGDName *self) * Sets the #GDataGDName:additional-name property to @additional_name. * * Since: 0.5.0 - **/ + */ void gdata_gd_name_set_additional_name (GDataGDName *self, const gchar *additional_name) { @@ -444,7 +444,7 @@ gdata_gd_name_set_additional_name (GDataGDName *self, const gchar *additional_na * Return value: the person's family name, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_name_get_family_name (GDataGDName *self) { @@ -460,7 +460,7 @@ gdata_gd_name_get_family_name (GDataGDName *self) * Sets the #GDataGDName:family-name property to @family_name. * * Since: 0.5.0 - **/ + */ void gdata_gd_name_set_family_name (GDataGDName *self, const gchar *family_name) { @@ -481,7 +481,7 @@ gdata_gd_name_set_family_name (GDataGDName *self, const gchar *family_name) * Return value: the person's name prefix, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_name_get_prefix (GDataGDName *self) { @@ -497,7 +497,7 @@ gdata_gd_name_get_prefix (GDataGDName *self) * Sets the #GDataGDName:prefix property to @prefix. * * Since: 0.5.0 - **/ + */ void gdata_gd_name_set_prefix (GDataGDName *self, const gchar *prefix) { @@ -518,7 +518,7 @@ gdata_gd_name_set_prefix (GDataGDName *self, const gchar *prefix) * Return value: the person's name suffix, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_name_get_suffix (GDataGDName *self) { @@ -534,7 +534,7 @@ gdata_gd_name_get_suffix (GDataGDName *self) * Sets the #GDataGDName:suffix property to @suffix. * * Since: 0.5.0 - **/ + */ void gdata_gd_name_set_suffix (GDataGDName *self, const gchar *suffix) { @@ -555,7 +555,7 @@ gdata_gd_name_set_suffix (GDataGDName *self, const gchar *suffix) * Return value: the person's full name, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_name_get_full_name (GDataGDName *self) { @@ -571,7 +571,7 @@ gdata_gd_name_get_full_name (GDataGDName *self) * Sets the #GDataGDName:full-name property to @full_name. * * Since: 0.5.0 - **/ + */ void gdata_gd_name_set_full_name (GDataGDName *self, const gchar *full_name) { diff --git a/gdata/gd/gdata-gd-name.h b/gdata/gd/gdata-gd-name.h index 2507ca3a..2044564e 100644 --- a/gdata/gd/gdata-gd-name.h +++ b/gdata/gd/gdata-gd-name.h @@ -42,7 +42,7 @@ typedef struct _GDataGDNamePrivate GDataGDNamePrivate; * All the fields in the #GDataGDName structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDNamePrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataGDNameClass structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-organization.c b/gdata/gd/gdata-gd-organization.c index f4e6f811..c5d6a23a 100644 --- a/gdata/gd/gdata-gd-organization.c +++ b/gdata/gd/gdata-gd-organization.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -107,7 +107,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_string ("name", "Name", "The name of the organization.", @@ -123,7 +123,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TITLE, g_param_spec_string ("title", "Title", "The title of a person within the organization.", @@ -139,7 +139,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of organization.", @@ -156,7 +156,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this organization.", @@ -172,7 +172,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which organization out of a group is primary.", @@ -188,7 +188,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DEPARTMENT, g_param_spec_string ("department", "Department", "Specifies a department within the organization.", @@ -204,7 +204,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_JOB_DESCRIPTION, g_param_spec_string ("job-description", "Job description", "Description of a job within the organization.", @@ -220,7 +220,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SYMBOL, g_param_spec_string ("symbol", "Symbol", "Symbol of the organization.", @@ -236,7 +236,7 @@ gdata_gd_organization_class_init (GDataGDOrganizationClass *klass) * GData specification. * * Since: 0.6.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LOCATION, g_param_spec_object ("location", "Location", "A place associated with the organization, e.g. office location.", @@ -474,7 +474,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDOrganization, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDOrganization * gdata_gd_organization_new (const gchar *name, const gchar *title, const gchar *relation_type, const gchar *label, gboolean is_primary) { @@ -492,7 +492,7 @@ gdata_gd_organization_new (const gchar *name, const gchar *title, const gchar *r * Return value: the organization's name, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_organization_get_name (GDataGDOrganization *self) { @@ -510,7 +510,7 @@ gdata_gd_organization_get_name (GDataGDOrganization *self) * Set @name to %NULL to unset the property in the organization. * * Since: 0.4.0 - **/ + */ void gdata_gd_organization_set_name (GDataGDOrganization *self, const gchar *name) { @@ -530,7 +530,7 @@ gdata_gd_organization_set_name (GDataGDOrganization *self, const gchar *name) * Return value: the organization's title, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_organization_get_title (GDataGDOrganization *self) { @@ -548,7 +548,7 @@ gdata_gd_organization_get_title (GDataGDOrganization *self) * Set @title to %NULL to unset the property in the organization. * * Since: 0.4.0 - **/ + */ void gdata_gd_organization_set_title (GDataGDOrganization *self, const gchar *title) { @@ -568,7 +568,7 @@ gdata_gd_organization_set_title (GDataGDOrganization *self, const gchar *title) * Return value: the organization's relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_organization_get_relation_type (GDataGDOrganization *self) { @@ -586,7 +586,7 @@ gdata_gd_organization_get_relation_type (GDataGDOrganization *self) * Set @relation_type to %NULL to unset the property in the organization. * * Since: 0.4.0 - **/ + */ void gdata_gd_organization_set_relation_type (GDataGDOrganization *self, const gchar *relation_type) { @@ -607,7 +607,7 @@ gdata_gd_organization_set_relation_type (GDataGDOrganization *self, const gchar * Return value: the organization's label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_organization_get_label (GDataGDOrganization *self) { @@ -625,7 +625,7 @@ gdata_gd_organization_get_label (GDataGDOrganization *self) * Set @label to %NULL to unset the property in the organization. * * Since: 0.4.0 - **/ + */ void gdata_gd_organization_set_label (GDataGDOrganization *self, const gchar *label) { @@ -645,7 +645,7 @@ gdata_gd_organization_set_label (GDataGDOrganization *self, const gchar *label) * Return value: %TRUE if this is the primary organization, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_organization_is_primary (GDataGDOrganization *self) { @@ -661,7 +661,7 @@ gdata_gd_organization_is_primary (GDataGDOrganization *self) * Sets the #GDataGDOrganization:is-primary property to @is_primary. * * Since: 0.4.0 - **/ + */ void gdata_gd_organization_set_is_primary (GDataGDOrganization *self, gboolean is_primary) { @@ -680,7 +680,7 @@ gdata_gd_organization_set_is_primary (GDataGDOrganization *self, gboolean is_pri * Return value: the department in which the person works in this organization, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_organization_get_department (GDataGDOrganization *self) { @@ -698,7 +698,7 @@ gdata_gd_organization_get_department (GDataGDOrganization *self) * Set @department to %NULL to unset the property in the organization. * * Since: 0.5.0 - **/ + */ void gdata_gd_organization_set_department (GDataGDOrganization *self, const gchar *department) { @@ -718,7 +718,7 @@ gdata_gd_organization_set_department (GDataGDOrganization *self, const gchar *de * Return value: the job description of the person in the organization, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_organization_get_job_description (GDataGDOrganization *self) { @@ -736,7 +736,7 @@ gdata_gd_organization_get_job_description (GDataGDOrganization *self) * Set @job_description to %NULL to unset the property in the organization. * * Since: 0.5.0 - **/ + */ void gdata_gd_organization_set_job_description (GDataGDOrganization *self, const gchar *job_description) { @@ -756,7 +756,7 @@ gdata_gd_organization_set_job_description (GDataGDOrganization *self, const gcha * Return value: the organization's stock symbol, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_organization_get_symbol (GDataGDOrganization *self) { @@ -774,7 +774,7 @@ gdata_gd_organization_get_symbol (GDataGDOrganization *self) * Set @symbol to %NULL to unset the property in the organization. * * Since: 0.5.0 - **/ + */ void gdata_gd_organization_set_symbol (GDataGDOrganization *self, const gchar *symbol) { @@ -794,7 +794,7 @@ gdata_gd_organization_set_symbol (GDataGDOrganization *self, const gchar *symbol * Return value: (transfer none): the organization's location, or %NULL * * Since: 0.6.0 - **/ + */ GDataGDWhere * gdata_gd_organization_get_location (GDataGDOrganization *self) { @@ -812,7 +812,7 @@ gdata_gd_organization_get_location (GDataGDOrganization *self) * Set @location to %NULL to unset the property in the organization. * * Since: 0.6.0 - **/ + */ void gdata_gd_organization_set_location (GDataGDOrganization *self, GDataGDWhere *location) { diff --git a/gdata/gd/gdata-gd-organization.h b/gdata/gd/gdata-gd-organization.h index 74e6c8c9..331d31ac 100644 --- a/gdata/gd/gdata-gd-organization.h +++ b/gdata/gd/gdata-gd-organization.h @@ -34,7 +34,7 @@ G_BEGIN_DECLS * The relation type URI for a work organization. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_ORGANIZATION_WORK "http://schemas.google.com/g/2005#work" /** @@ -43,7 +43,7 @@ G_BEGIN_DECLS * The relation type URI for a miscellaneous organization. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_ORGANIZATION_OTHER "http://schemas.google.com/g/2005#other" #define GDATA_TYPE_GD_ORGANIZATION (gdata_gd_organization_get_type ()) @@ -61,7 +61,7 @@ typedef struct _GDataGDOrganizationPrivate GDataGDOrganizationPrivate; * All the fields in the #GDataGDOrganization structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDOrganizationPrivate *priv; @@ -73,7 +73,7 @@ typedef struct { * All the fields in the #GDataGDOrganizationClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-phone-number.c b/gdata/gd/gdata-gd-phone-number.c index 280798e6..06c0be98 100644 --- a/gdata/gd/gdata-gd-phone-number.c +++ b/gdata/gd/gdata-gd-phone-number.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -96,7 +96,7 @@ gdata_gd_phone_number_class_init (GDataGDPhoneNumberClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NUMBER, g_param_spec_string ("number", "Number", "Human-readable phone number; may be in any telephone number format.", @@ -112,7 +112,7 @@ gdata_gd_phone_number_class_init (GDataGDPhoneNumberClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "An optional \"tel URI\" used to represent the number in a formal way.", @@ -128,7 +128,7 @@ gdata_gd_phone_number_class_init (GDataGDPhoneNumberClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of phone number.", @@ -144,7 +144,7 @@ gdata_gd_phone_number_class_init (GDataGDPhoneNumberClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this phone number.", @@ -160,7 +160,7 @@ gdata_gd_phone_number_class_init (GDataGDPhoneNumberClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which phone number out of a group is primary.", @@ -362,7 +362,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDPhoneNumber, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDPhoneNumber * gdata_gd_phone_number_new (const gchar *number, const gchar *relation_type, const gchar *label, const gchar *uri, gboolean is_primary) { @@ -381,7 +381,7 @@ gdata_gd_phone_number_new (const gchar *number, const gchar *relation_type, cons * Return value: the phone number itself * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_phone_number_get_number (GDataGDPhoneNumber *self) { @@ -397,7 +397,7 @@ gdata_gd_phone_number_get_number (GDataGDPhoneNumber *self) * Sets the #GDataGDPhoneNumber:number property to @number. * * Since: 0.4.0 - **/ + */ void gdata_gd_phone_number_set_number (GDataGDPhoneNumber *self, const gchar *number) { @@ -420,7 +420,7 @@ gdata_gd_phone_number_set_number (GDataGDPhoneNumber *self, const gchar *number) * Return value: the phone number's URI, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_phone_number_get_uri (GDataGDPhoneNumber *self) { @@ -438,7 +438,7 @@ gdata_gd_phone_number_get_uri (GDataGDPhoneNumber *self) * Set @uri to %NULL to unset the property in the phone number. * * Since: 0.4.0 - **/ + */ void gdata_gd_phone_number_set_uri (GDataGDPhoneNumber *self, const gchar *uri) { @@ -458,7 +458,7 @@ gdata_gd_phone_number_set_uri (GDataGDPhoneNumber *self, const gchar *uri) * Return value: the phone number's relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_phone_number_get_relation_type (GDataGDPhoneNumber *self) { @@ -476,7 +476,7 @@ gdata_gd_phone_number_get_relation_type (GDataGDPhoneNumber *self) * Set @relation_type to %NULL to unset the property in the phone number. * * Since: 0.4.0 - **/ + */ void gdata_gd_phone_number_set_relation_type (GDataGDPhoneNumber *self, const gchar *relation_type) { @@ -497,7 +497,7 @@ gdata_gd_phone_number_set_relation_type (GDataGDPhoneNumber *self, const gchar * * Return value: the phone number's label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_phone_number_get_label (GDataGDPhoneNumber *self) { @@ -515,7 +515,7 @@ gdata_gd_phone_number_get_label (GDataGDPhoneNumber *self) * Set @label to %NULL to unset the property in the phone number. * * Since: 0.4.0 - **/ + */ void gdata_gd_phone_number_set_label (GDataGDPhoneNumber *self, const gchar *label) { @@ -535,7 +535,7 @@ gdata_gd_phone_number_set_label (GDataGDPhoneNumber *self, const gchar *label) * Return value: %TRUE if this is the primary phone number, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_phone_number_is_primary (GDataGDPhoneNumber *self) { @@ -551,7 +551,7 @@ gdata_gd_phone_number_is_primary (GDataGDPhoneNumber *self) * Sets the #GDataGDPhoneNumber:is-primary property to @is_primary. * * Since: 0.4.0 - **/ + */ void gdata_gd_phone_number_set_is_primary (GDataGDPhoneNumber *self, gboolean is_primary) { diff --git a/gdata/gd/gdata-gd-phone-number.h b/gdata/gd/gdata-gd-phone-number.h index dab6a484..4a2995f5 100644 --- a/gdata/gd/gdata-gd-phone-number.h +++ b/gdata/gd/gdata-gd-phone-number.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of an assistant. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_ASSISTANT "http://schemas.google.com/g/2005#assistant" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a callback service. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_CALLBACK "http://schemas.google.com/g/2005#callback" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a car phone. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_CAR "http://schemas.google.com/g/2005#car" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * The relation type URI for the main phone number of a company. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_COMPANY_MAIN "http://schemas.google.com/g/2005#company_main" /** @@ -69,7 +69,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a fax machine. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_FAX "http://schemas.google.com/g/2005#fax" /** @@ -78,7 +78,7 @@ G_BEGIN_DECLS * The relation type URI for a home phone number. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_HOME "http://schemas.google.com/g/2005#home" /** @@ -87,7 +87,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a home fax machine. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_HOME_FAX "http://schemas.google.com/g/2005#home_fax" /** @@ -96,7 +96,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of an ISDN phone. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_ISDN "http://schemas.google.com/g/2005#isdn" /** @@ -105,7 +105,7 @@ G_BEGIN_DECLS * The relation type URI for the main phone number of a person. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_MAIN "http://schemas.google.com/g/2005#main" /** @@ -114,7 +114,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a mobile phone. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_MOBILE "http://schemas.google.com/g/2005#mobile" /** @@ -123,7 +123,7 @@ G_BEGIN_DECLS * The relation type URI for a miscellaneous phone number. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_OTHER "http://schemas.google.com/g/2005#other" /** @@ -132,7 +132,7 @@ G_BEGIN_DECLS * The relation type URI for a miscellaneous fax machine's phone number. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_OTHER_FAX "http://schemas.google.com/g/2005#other_fax" /** @@ -141,7 +141,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a pager. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_PAGER "http://schemas.google.com/g/2005#pager" /** @@ -150,7 +150,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a radio phone. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_RADIO "http://schemas.google.com/g/2005#radio" /** @@ -159,7 +159,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a telex machine. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_TELEX "http://schemas.google.com/g/2005#telex" /** @@ -168,7 +168,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a TTY TTD. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_TTY_TDD "http://schemas.google.com/g/2005#tty_tdd" /** @@ -177,7 +177,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a work place. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_WORK "http://schemas.google.com/g/2005#work" /** @@ -186,7 +186,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a work fax machine. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_WORK_FAX "http://schemas.google.com/g/2005#work_fax" /** @@ -195,7 +195,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a work mobile phone. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_WORK_MOBILE "http://schemas.google.com/g/2005#work_mobile" /** @@ -204,7 +204,7 @@ G_BEGIN_DECLS * The relation type URI for the phone number of a work pager. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_PHONE_NUMBER_WORK_PAGER "http://schemas.google.com/g/2005#work_pager" #define GDATA_TYPE_GD_PHONE_NUMBER (gdata_gd_phone_number_get_type ()) @@ -222,7 +222,7 @@ typedef struct _GDataGDPhoneNumberPrivate GDataGDPhoneNumberPrivate; * All the fields in the #GDataGDPhoneNumber structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDPhoneNumberPrivate *priv; @@ -234,7 +234,7 @@ typedef struct { * All the fields in the #GDataGDPhoneNumberClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-postal-address.c b/gdata/gd/gdata-gd-postal-address.c index 6067409a..7adc68d7 100644 --- a/gdata/gd/gdata-gd-postal-address.c +++ b/gdata/gd/gdata-gd-postal-address.c @@ -28,7 +28,7 @@ * Note that it does not represent a simple "postalAddress" element, as "structuredPostalAddress" is now used wherever possible in the GData API. * * Since: 0.4.0 - **/ + */ #include #include @@ -121,7 +121,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FORMATTED_ADDRESS, g_param_spec_string ("address", "Address", "The postal address itself.", @@ -138,7 +138,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "A programmatic value that identifies the type of postal address.", @@ -154,7 +154,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A simple string value used to name this postal address.", @@ -170,7 +170,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_PRIMARY, g_param_spec_boolean ("is-primary", "Primary?", "Indicates which postal address out of a group is primary.", @@ -186,7 +186,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MAIL_CLASS, g_param_spec_string ("mail-class", "Mail class", "Classes of mail accepted at this address.", @@ -202,7 +202,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_USAGE, g_param_spec_string ("usage", "Usage", "The context in which this addess can be used.", @@ -218,7 +218,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_AGENT, g_param_spec_string ("agent", "Agent", "The agent who actually receives the mail.", @@ -234,7 +234,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_HOUSE_NAME, g_param_spec_string ("house-name", "House name", "Used in places where houses or buildings have names (and not numbers).", @@ -250,7 +250,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_STREET, g_param_spec_string ("street", "Street", "Can be street, avenue, road, etc.", @@ -266,7 +266,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_PO_BOX, g_param_spec_string ("po-box", "PO box", "Covers actual P.O. boxes, drawers, locked bags, etc.", @@ -283,7 +283,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_NEIGHBORHOOD, g_param_spec_string ("neighborhood", "Neighborhood", "This is used to disambiguate a street address.", @@ -299,7 +299,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CITY, g_param_spec_string ("city", "City", "Can be city, village, town, borough, etc.", @@ -316,7 +316,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SUBREGION, g_param_spec_string ("subregion", "Subregion", "Handles administrative districts such as U.S. or U.K. counties.", @@ -332,7 +332,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_REGION, g_param_spec_string ("region", "Region", "A state, province, county, Land, departement, etc.", @@ -348,7 +348,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_POSTCODE, g_param_spec_string ("postcode", "Postcode", "Postal code.", @@ -365,7 +365,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * GData specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_COUNTRY, g_param_spec_string ("country", "Country", "The name of the country.", @@ -383,7 +383,7 @@ gdata_gd_postal_address_class_init (GDataGDPostalAddressClass *klass) * or ISO 3166-1 alpha-2. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_COUNTRY_CODE, g_param_spec_string ("country-code", "Country code", "The ISO 3166-1 alpha-2 country code for the country.", @@ -688,7 +688,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDPostalAddress, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDPostalAddress * gdata_gd_postal_address_new (const gchar *relation_type, const gchar *label, gboolean is_primary) { @@ -705,7 +705,7 @@ gdata_gd_postal_address_new (const gchar *relation_type, const gchar *label, gbo * Return value: the postal address itself, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_postal_address_get_address (GDataGDPostalAddress *self) { @@ -721,7 +721,7 @@ gdata_gd_postal_address_get_address (GDataGDPostalAddress *self) * Sets the #GDataGDPostalAddress:address property to @address. * * Since: 0.4.0 - **/ + */ void gdata_gd_postal_address_set_address (GDataGDPostalAddress *self, const gchar *address) { @@ -743,7 +743,7 @@ gdata_gd_postal_address_set_address (GDataGDPostalAddress *self, const gchar *ad * Return value: the postal address' relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_postal_address_get_relation_type (GDataGDPostalAddress *self) { @@ -761,7 +761,7 @@ gdata_gd_postal_address_get_relation_type (GDataGDPostalAddress *self) * Set @relation_type to %NULL to unset the property in the postal address. * * Since: 0.4.0 - **/ + */ void gdata_gd_postal_address_set_relation_type (GDataGDPostalAddress *self, const gchar *relation_type) { @@ -782,7 +782,7 @@ gdata_gd_postal_address_set_relation_type (GDataGDPostalAddress *self, const gch * Return value: the postal address' label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_postal_address_get_label (GDataGDPostalAddress *self) { @@ -800,7 +800,7 @@ gdata_gd_postal_address_get_label (GDataGDPostalAddress *self) * Set @label to %NULL to unset the property in the postal address. * * Since: 0.4.0 - **/ + */ void gdata_gd_postal_address_set_label (GDataGDPostalAddress *self, const gchar *label) { @@ -820,7 +820,7 @@ gdata_gd_postal_address_set_label (GDataGDPostalAddress *self, const gchar *labe * Return value: %TRUE if this is the primary postal address, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_postal_address_is_primary (GDataGDPostalAddress *self) { @@ -836,7 +836,7 @@ gdata_gd_postal_address_is_primary (GDataGDPostalAddress *self) * Sets the #GDataGDPostalAddress:is-primary property to @is_primary. * * Since: 0.4.0 - **/ + */ void gdata_gd_postal_address_set_is_primary (GDataGDPostalAddress *self, gboolean is_primary) { @@ -855,7 +855,7 @@ gdata_gd_postal_address_set_is_primary (GDataGDPostalAddress *self, gboolean is_ * Return value: the postal address' mail class, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_mail_class (GDataGDPostalAddress *self) { @@ -873,7 +873,7 @@ gdata_gd_postal_address_get_mail_class (GDataGDPostalAddress *self) * Set @mail_class to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_mail_class (GDataGDPostalAddress *self, const gchar *mail_class) { @@ -894,7 +894,7 @@ gdata_gd_postal_address_set_mail_class (GDataGDPostalAddress *self, const gchar * Return value: the postal address' usage, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_usage (GDataGDPostalAddress *self) { @@ -912,7 +912,7 @@ gdata_gd_postal_address_get_usage (GDataGDPostalAddress *self) * Set @usage to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_usage (GDataGDPostalAddress *self, const gchar *usage) { @@ -933,7 +933,7 @@ gdata_gd_postal_address_set_usage (GDataGDPostalAddress *self, const gchar *usag * Return value: the postal address' agent, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_agent (GDataGDPostalAddress *self) { @@ -951,7 +951,7 @@ gdata_gd_postal_address_get_agent (GDataGDPostalAddress *self) * Set @agent to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_agent (GDataGDPostalAddress *self, const gchar *agent) { @@ -972,7 +972,7 @@ gdata_gd_postal_address_set_agent (GDataGDPostalAddress *self, const gchar *agen * Return value: the postal address' house name, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_house_name (GDataGDPostalAddress *self) { @@ -990,7 +990,7 @@ gdata_gd_postal_address_get_house_name (GDataGDPostalAddress *self) * Set @house_name to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_house_name (GDataGDPostalAddress *self, const gchar *house_name) { @@ -1011,7 +1011,7 @@ gdata_gd_postal_address_set_house_name (GDataGDPostalAddress *self, const gchar * Return value: the postal address' street, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_street (GDataGDPostalAddress *self) { @@ -1029,7 +1029,7 @@ gdata_gd_postal_address_get_street (GDataGDPostalAddress *self) * Set @street to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_street (GDataGDPostalAddress *self, const gchar *street) { @@ -1050,7 +1050,7 @@ gdata_gd_postal_address_set_street (GDataGDPostalAddress *self, const gchar *str * Return value: the postal address' P.O. box, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_po_box (GDataGDPostalAddress *self) { @@ -1068,7 +1068,7 @@ gdata_gd_postal_address_get_po_box (GDataGDPostalAddress *self) * Set @po_box to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_po_box (GDataGDPostalAddress *self, const gchar *po_box) { @@ -1089,7 +1089,7 @@ gdata_gd_postal_address_set_po_box (GDataGDPostalAddress *self, const gchar *po_ * Return value: the postal address' neighborhood, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_neighborhood (GDataGDPostalAddress *self) { @@ -1107,7 +1107,7 @@ gdata_gd_postal_address_get_neighborhood (GDataGDPostalAddress *self) * Set @neighborhood to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_neighborhood (GDataGDPostalAddress *self, const gchar *neighborhood) { @@ -1128,7 +1128,7 @@ gdata_gd_postal_address_set_neighborhood (GDataGDPostalAddress *self, const gcha * Return value: the postal address' city, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_city (GDataGDPostalAddress *self) { @@ -1146,7 +1146,7 @@ gdata_gd_postal_address_get_city (GDataGDPostalAddress *self) * Set @city to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_city (GDataGDPostalAddress *self, const gchar *city) { @@ -1167,7 +1167,7 @@ gdata_gd_postal_address_set_city (GDataGDPostalAddress *self, const gchar *city) * Return value: the postal address' subregion, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_subregion (GDataGDPostalAddress *self) { @@ -1185,7 +1185,7 @@ gdata_gd_postal_address_get_subregion (GDataGDPostalAddress *self) * Set @subregion to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_subregion (GDataGDPostalAddress *self, const gchar *subregion) { @@ -1206,7 +1206,7 @@ gdata_gd_postal_address_set_subregion (GDataGDPostalAddress *self, const gchar * * Return value: the postal address' region, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_region (GDataGDPostalAddress *self) { @@ -1224,7 +1224,7 @@ gdata_gd_postal_address_get_region (GDataGDPostalAddress *self) * Set @region to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_region (GDataGDPostalAddress *self, const gchar *region) { @@ -1245,7 +1245,7 @@ gdata_gd_postal_address_set_region (GDataGDPostalAddress *self, const gchar *reg * Return value: the postal address' postcode, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_postcode (GDataGDPostalAddress *self) { @@ -1263,7 +1263,7 @@ gdata_gd_postal_address_get_postcode (GDataGDPostalAddress *self) * Set @postcode to %NULL to unset the property in the postal address. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_postcode (GDataGDPostalAddress *self, const gchar *postcode) { @@ -1284,7 +1284,7 @@ gdata_gd_postal_address_set_postcode (GDataGDPostalAddress *self, const gchar *p * Return value: the postal address' country, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_country (GDataGDPostalAddress *self) { @@ -1301,7 +1301,7 @@ gdata_gd_postal_address_get_country (GDataGDPostalAddress *self) * Return value: the postal address' ISO 3166-1 alpha-2 country code, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_gd_postal_address_get_country_code (GDataGDPostalAddress *self) { @@ -1321,7 +1321,7 @@ gdata_gd_postal_address_get_country_code (GDataGDPostalAddress *self) * also be provided. * * Since: 0.5.0 - **/ + */ void gdata_gd_postal_address_set_country (GDataGDPostalAddress *self, const gchar *country, const gchar *country_code) { diff --git a/gdata/gd/gdata-gd-postal-address.h b/gdata/gd/gdata-gd-postal-address.h index c4208193..c544c419 100644 --- a/gdata/gd/gdata-gd-postal-address.h +++ b/gdata/gd/gdata-gd-postal-address.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The relation type URI for the postal address of a workplace. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_POSTAL_ADDRESS_WORK "http://schemas.google.com/g/2005#work" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The relation type URI for the postal address of a home. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_POSTAL_ADDRESS_HOME "http://schemas.google.com/g/2005#home" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The relation type URI for a miscellaneous postal address. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_POSTAL_ADDRESS_OTHER "http://schemas.google.com/g/2005#other" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * Parcels and letters can be sent to the address. Value for #GDataGDPostalAddress:mail-class. * * Since: 0.5.0 - **/ + */ #define GDATA_GD_MAIL_CLASS_BOTH "http://schemas.google.com/g/2005#both" /** @@ -69,7 +69,7 @@ G_BEGIN_DECLS * Only letters can be sent to the address. Value for #GDataGDPostalAddress:mail-class. * * Since: 0.5.0 - **/ + */ #define GDATA_GD_MAIL_CLASS_LETTERS "http://schemas.google.com/g/2005#letters" /** @@ -78,7 +78,7 @@ G_BEGIN_DECLS * Only parcels can be sent to the address. Value for #GDataGDPostalAddress:mail-class. * * Since: 0.5.0 - **/ + */ #define GDATA_GD_MAIL_CLASS_PARCELS "http://schemas.google.com/g/2005#parcels" /** @@ -87,7 +87,7 @@ G_BEGIN_DECLS * Address is purely locational and cannot be used for mail. Value for #GDataGDPostalAddress:mail-class. * * Since: 0.5.0 - **/ + */ #define GDATA_GD_MAIL_CLASS_NEITHER "http://schemas.google.com/g/2005#neither" /** @@ -96,7 +96,7 @@ G_BEGIN_DECLS * The address is for general usage. Value for #GDataGDPostalAddress:usage. * * Since: 0.5.0 - **/ + */ #define GDATA_GD_ADDRESS_USAGE_GENERAL "http://schemas.google.com/g/2005#general" /** @@ -105,7 +105,7 @@ G_BEGIN_DECLS * The address is for local usage. Value for #GDataGDPostalAddress:usage. * * Since: 0.5.0 - **/ + */ #define GDATA_GD_ADDRESS_USAGE_LOCAL "http://schemas.google.com/g/2005#local" #define GDATA_TYPE_GD_POSTAL_ADDRESS (gdata_gd_postal_address_get_type ()) @@ -123,7 +123,7 @@ typedef struct _GDataGDPostalAddressPrivate GDataGDPostalAddressPrivate; * All the fields in the #GDataGDPostalAddress structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDPostalAddressPrivate *priv; @@ -135,7 +135,7 @@ typedef struct { * All the fields in the #GDataGDPostalAddressClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-reminder.c b/gdata/gd/gdata-gd-reminder.c index 92763037..6c1e25d3 100644 --- a/gdata/gd/gdata-gd-reminder.c +++ b/gdata/gd/gdata-gd-reminder.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -89,7 +89,7 @@ gdata_gd_reminder_class_init (GDataGDReminderClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_METHOD, g_param_spec_string ("method", "Method", "The notification method the reminder should use.", @@ -105,7 +105,7 @@ gdata_gd_reminder_class_init (GDataGDReminderClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ABSOLUTE_TIME, g_param_spec_int64 ("absolute-time", "Absolute time", "Absolute time at which the reminder should be issued.", @@ -121,7 +121,7 @@ gdata_gd_reminder_class_init (GDataGDReminderClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_ABSOLUTE_TIME, g_param_spec_boolean ("is-absolute-time", "Absolute time?", "Whether the reminder is specified as an absolute or relative time.", @@ -137,7 +137,7 @@ gdata_gd_reminder_class_init (GDataGDReminderClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATIVE_TIME, g_param_spec_int ("relative-time", "Relative time", "Time at which the reminder should be issued, in minutes.", @@ -324,7 +324,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDReminder, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDReminder * gdata_gd_reminder_new (const gchar *method, gint64 absolute_time, gint relative_time) { @@ -343,7 +343,7 @@ gdata_gd_reminder_new (const gchar *method, gint64 absolute_time, gint relative_ * Return value: the method, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_reminder_get_method (GDataGDReminder *self) { @@ -361,7 +361,7 @@ gdata_gd_reminder_get_method (GDataGDReminder *self) * Set @method to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_reminder_set_method (GDataGDReminder *self, const gchar *method) { @@ -381,7 +381,7 @@ gdata_gd_reminder_set_method (GDataGDReminder *self, const gchar *method) * Return value: the UNIX timestamp of the absolute time for the reminder, or -1 * * Since: 0.4.0 - **/ + */ gint64 gdata_gd_reminder_get_absolute_time (GDataGDReminder *self) { @@ -399,7 +399,7 @@ gdata_gd_reminder_get_absolute_time (GDataGDReminder *self) * Set @absolute_time to -1 to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_reminder_set_absolute_time (GDataGDReminder *self, gint64 absolute_time) { @@ -420,7 +420,7 @@ gdata_gd_reminder_set_absolute_time (GDataGDReminder *self, gint64 absolute_time * Return value: %TRUE if the reminder is absolute, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_reminder_is_absolute_time (GDataGDReminder *self) { @@ -437,7 +437,7 @@ gdata_gd_reminder_is_absolute_time (GDataGDReminder *self) * Return value: the relative time, or -1 * * Since: 0.4.0 - **/ + */ gint gdata_gd_reminder_get_relative_time (GDataGDReminder *self) { @@ -455,7 +455,7 @@ gdata_gd_reminder_get_relative_time (GDataGDReminder *self) * Set @relative_time to -1 to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_reminder_set_relative_time (GDataGDReminder *self, gint relative_time) { diff --git a/gdata/gd/gdata-gd-reminder.h b/gdata/gd/gdata-gd-reminder.h index 96e36c27..9f7373d8 100644 --- a/gdata/gd/gdata-gd-reminder.h +++ b/gdata/gd/gdata-gd-reminder.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The #GDataGDReminder:method for an alert to appear in the user's browser. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_REMINDER_ALERT "alert" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The #GDataGDReminder:method for an alert to be sent to the user by e-mail. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_REMINDER_EMAIL "email" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The #GDataGDReminder:method for an alert to be sent to the user by SMS. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_REMINDER_SMS "sms" #define GDATA_TYPE_GD_REMINDER (gdata_gd_reminder_get_type ()) @@ -69,7 +69,7 @@ typedef struct _GDataGDReminderPrivate GDataGDReminderPrivate; * All the fields in the #GDataGDReminder structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDReminderPrivate *priv; @@ -81,7 +81,7 @@ typedef struct { * All the fields in the #GDataGDReminderClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-when.c b/gdata/gd/gdata-gd-when.c index 52de500d..5b45aaae 100644 --- a/gdata/gd/gdata-gd-when.c +++ b/gdata/gd/gdata-gd-when.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -101,7 +101,7 @@ gdata_gd_when_class_init (GDataGDWhenClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_START_TIME, g_param_spec_int64 ("start-time", "Start time", "The name of the when.", @@ -117,7 +117,7 @@ gdata_gd_when_class_init (GDataGDWhenClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_END_TIME, g_param_spec_int64 ("end-time", "End time", "The title of a person within the when.", @@ -133,7 +133,7 @@ gdata_gd_when_class_init (GDataGDWhenClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_DATE, g_param_spec_boolean ("is-date", "Date?", "A programmatic value that identifies the type of when.", @@ -150,7 +150,7 @@ gdata_gd_when_class_init (GDataGDWhenClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VALUE_STRING, g_param_spec_string ("value-string", "Value string", "A simple string value used to name this when.", @@ -397,7 +397,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDWhen, or %NULL; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDWhen * gdata_gd_when_new (gint64 start_time, gint64 end_time, gboolean is_date) { @@ -416,7 +416,7 @@ gdata_gd_when_new (gint64 start_time, gint64 end_time, gboolean is_date) * Return value: the UNIX timestamp for the start time of the event * * Since: 0.4.0 - **/ + */ gint64 gdata_gd_when_get_start_time (GDataGDWhen *self) { @@ -432,7 +432,7 @@ gdata_gd_when_get_start_time (GDataGDWhen *self) * Sets the #GDataGDWhen:start-time property to @start_time. * * Since: 0.4.0 - **/ + */ void gdata_gd_when_set_start_time (GDataGDWhen *self, gint64 start_time) { @@ -455,7 +455,7 @@ gdata_gd_when_set_start_time (GDataGDWhen *self, gint64 start_time) * -1 * * Since: 0.4.0 - **/ + */ gint64 gdata_gd_when_get_end_time (GDataGDWhen *self) { @@ -473,7 +473,7 @@ gdata_gd_when_get_end_time (GDataGDWhen *self) * Set @end_time to -1 to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_when_set_end_time (GDataGDWhen *self, gint64 end_time) { @@ -493,7 +493,7 @@ gdata_gd_when_set_end_time (GDataGDWhen *self, gint64 end_time) * Return value: %TRUE if #GDataGDWhen:start-time and #GDataGDWhen:end-time are dates rather than times, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_gd_when_is_date (GDataGDWhen *self) { @@ -509,7 +509,7 @@ gdata_gd_when_is_date (GDataGDWhen *self) * Sets the #GDataGDWhen:is-date property to @is_date. * * Since: 0.4.0 - **/ + */ void gdata_gd_when_set_is_date (GDataGDWhen *self, gboolean is_date) { @@ -528,7 +528,7 @@ gdata_gd_when_set_is_date (GDataGDWhen *self, gboolean is_date) * Return value: the value string, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_when_get_value_string (GDataGDWhen *self) { @@ -546,7 +546,7 @@ gdata_gd_when_get_value_string (GDataGDWhen *self) * Set @value_string to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_when_set_value_string (GDataGDWhen *self, const gchar *value_string) { @@ -566,7 +566,7 @@ gdata_gd_when_set_value_string (GDataGDWhen *self, const gchar *value_string) * Return value: (element-type GData.GDReminder) (transfer none): a #GList of #GDataGDReminders, or %NULL * * Since: 0.4.0 - **/ + */ GList * gdata_gd_when_get_reminders (GDataGDWhen *self) { @@ -584,7 +584,7 @@ gdata_gd_when_get_reminders (GDataGDWhen *self) * Duplicate reminders will not be added to the list. * * Since: 0.7.0 - **/ + */ void gdata_gd_when_add_reminder (GDataGDWhen *self, GDataGDReminder *reminder) { diff --git a/gdata/gd/gdata-gd-when.h b/gdata/gd/gdata-gd-when.h index 0e670afc..6bf9f051 100644 --- a/gdata/gd/gdata-gd-when.h +++ b/gdata/gd/gdata-gd-when.h @@ -34,7 +34,7 @@ G_BEGIN_DECLS * The event has been canceled. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_STATUS_CANCELED "http://schemas.google.com/g/2005#event.canceled" /** @@ -43,7 +43,7 @@ G_BEGIN_DECLS * The event has been planned and confirmed. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_STATUS_CONFIRMED "http://schemas.google.com/g/2005#event.confirmed" /** @@ -52,7 +52,7 @@ G_BEGIN_DECLS * The event has been planned, but only tentatively scheduled. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_STATUS_TENTATIVE "http://schemas.google.com/g/2005#event.tentative" /** @@ -61,7 +61,7 @@ G_BEGIN_DECLS * The event is visible to only certain people. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_VISIBILITY_CONFIDENTIAL "http://schemas.google.com/g/2005#event.confidential" /** @@ -70,7 +70,7 @@ G_BEGIN_DECLS * The event's visibility is inherited from the preferences of its owner. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_VISIBILITY_DEFAULT "http://schemas.google.com/g/2005#event.default" /** @@ -79,7 +79,7 @@ G_BEGIN_DECLS * The event is visible to very few people. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_VISIBILITY_PRIVATE "http://schemas.google.com/g/2005#event.private" /** @@ -88,7 +88,7 @@ G_BEGIN_DECLS * The event is visible to most people. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_VISIBILITY_PUBLIC "http://schemas.google.com/g/2005#event.public" /** @@ -97,7 +97,7 @@ G_BEGIN_DECLS * The event consumes time in calendars; its time will be marked as busy in a free/busy search. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_TRANSPARENCY_OPAQUE "http://schemas.google.com/g/2005#event.opaque" /** @@ -106,7 +106,7 @@ G_BEGIN_DECLS * The event does not consume time in calendars; its time will be not marked as busy in a free/busy search. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_EVENT_TRANSPARENCY_TRANSPARENT "http://schemas.google.com/g/2005#event.transparent" #define GDATA_TYPE_GD_WHEN (gdata_gd_when_get_type ()) @@ -124,7 +124,7 @@ typedef struct _GDataGDWhenPrivate GDataGDWhenPrivate; * All the fields in the #GDataGDWhen structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDWhenPrivate *priv; @@ -136,7 +136,7 @@ typedef struct { * All the fields in the #GDataGDWhenClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-where.c b/gdata/gd/gdata-gd-where.c index 202ac429..ea299c02 100644 --- a/gdata/gd/gdata-gd-where.c +++ b/gdata/gd/gdata-gd-where.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -92,7 +92,7 @@ gdata_gd_where_class_init (GDataGDWhereClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "Specifies the relationship between the container and the containee.", @@ -108,7 +108,7 @@ gdata_gd_where_class_init (GDataGDWhereClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VALUE_STRING, g_param_spec_string ("value-string", "Value string", "A simple string representation of this location.", @@ -124,7 +124,7 @@ gdata_gd_where_class_init (GDataGDWhereClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "Specifies a user-readable label to distinguish this location from others.", @@ -283,7 +283,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDWhere; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDWhere * gdata_gd_where_new (const gchar *relation_type, const gchar *value_string, const gchar *label) { @@ -300,7 +300,7 @@ gdata_gd_where_new (const gchar *relation_type, const gchar *value_string, const * Return value: the relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_where_get_relation_type (GDataGDWhere *self) { @@ -318,7 +318,7 @@ gdata_gd_where_get_relation_type (GDataGDWhere *self) * Set @relation_type to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_where_set_relation_type (GDataGDWhere *self, const gchar *relation_type) { @@ -339,7 +339,7 @@ gdata_gd_where_set_relation_type (GDataGDWhere *self, const gchar *relation_type * Return value: the value string, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_where_get_value_string (GDataGDWhere *self) { @@ -357,7 +357,7 @@ gdata_gd_where_get_value_string (GDataGDWhere *self) * Set @value_string to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_where_set_value_string (GDataGDWhere *self, const gchar *value_string) { @@ -377,7 +377,7 @@ gdata_gd_where_set_value_string (GDataGDWhere *self, const gchar *value_string) * Return value: the label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_where_get_label (GDataGDWhere *self) { @@ -395,7 +395,7 @@ gdata_gd_where_get_label (GDataGDWhere *self) * Set @label to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_where_set_label (GDataGDWhere *self, const gchar *label) { diff --git a/gdata/gd/gdata-gd-where.h b/gdata/gd/gdata-gd-where.h index fa1e744e..a44cac41 100644 --- a/gdata/gd/gdata-gd-where.h +++ b/gdata/gd/gdata-gd-where.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The relation type URI for an event location. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHERE_EVENT "http://schemas.google.com/g/2005#event" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The relation type URI for an alternate event location, such as a video conference site. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHERE_EVENT_ALTERNATE "http://schemas.google.com/g/2005#event.alternate" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The relation type URI for an event's parking lot. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHERE_EVENT_PARKING "http://schemas.google.com/g/2005#event.parking" #define GDATA_TYPE_GD_WHERE (gdata_gd_where_get_type ()) @@ -69,7 +69,7 @@ typedef struct _GDataGDWherePrivate GDataGDWherePrivate; * All the fields in the #GDataGDWhere structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDWherePrivate *priv; @@ -81,7 +81,7 @@ typedef struct { * All the fields in the #GDataGDWhereClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gd/gdata-gd-who.c b/gdata/gd/gdata-gd-who.c index 4f45a17b..f637ee9a 100644 --- a/gdata/gd/gdata-gd-who.c +++ b/gdata/gd/gdata-gd-who.c @@ -27,7 +27,7 @@ * GData specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -92,7 +92,7 @@ gdata_gd_who_class_init (GDataGDWhoClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RELATION_TYPE, g_param_spec_string ("relation-type", "Relation type", "Specifies the relationship between the container and the containee.", @@ -108,7 +108,7 @@ gdata_gd_who_class_init (GDataGDWhoClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_VALUE_STRING, g_param_spec_string ("value-string", "Value string", "A simple string representation of this person.", @@ -124,7 +124,7 @@ gdata_gd_who_class_init (GDataGDWhoClass *klass) * GData specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EMAIL_ADDRESS, g_param_spec_string ("email-address", "E-mail address", "The e-mail address of the person represented by the #GDataGDWho.", @@ -288,7 +288,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataGDWho; unref with g_object_unref() * * Since: 0.2.0 - **/ + */ GDataGDWho * gdata_gd_who_new (const gchar *relation_type, const gchar *value_string, const gchar *email_address) { @@ -306,7 +306,7 @@ gdata_gd_who_new (const gchar *relation_type, const gchar *value_string, const g * Return value: the relation type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_who_get_relation_type (GDataGDWho *self) { @@ -324,7 +324,7 @@ gdata_gd_who_get_relation_type (GDataGDWho *self) * Set @relation_type to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_who_set_relation_type (GDataGDWho *self, const gchar *relation_type) { @@ -345,7 +345,7 @@ gdata_gd_who_set_relation_type (GDataGDWho *self, const gchar *relation_type) * Return value: the value string, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_who_get_value_string (GDataGDWho *self) { @@ -363,7 +363,7 @@ gdata_gd_who_get_value_string (GDataGDWho *self) * Set @value_string to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_who_set_value_string (GDataGDWho *self, const gchar *value_string) { @@ -383,7 +383,7 @@ gdata_gd_who_set_value_string (GDataGDWho *self, const gchar *value_string) * Return value: the e-mail address, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_gd_who_get_email_address (GDataGDWho *self) { @@ -401,7 +401,7 @@ gdata_gd_who_get_email_address (GDataGDWho *self) * Set @email_address to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_gd_who_set_email_address (GDataGDWho *self, const gchar *email_address) { diff --git a/gdata/gd/gdata-gd-who.h b/gdata/gd/gdata-gd-who.h index c5fe2780..00a5cc6f 100644 --- a/gdata/gd/gdata-gd-who.h +++ b/gdata/gd/gdata-gd-who.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * The relation type URI for a general meeting or event attendee. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHO_EVENT_ATTENDEE "http://schemas.google.com/g/2005#event.attendee" /** @@ -42,7 +42,7 @@ G_BEGIN_DECLS * The relation type URI for an event organizer (not necessarily an attendee). * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHO_EVENT_ORGANIZER "http://schemas.google.com/g/2005#event.organizer" /** @@ -51,7 +51,7 @@ G_BEGIN_DECLS * The relation type URI for an event performer, which is similar to %GDATA_GD_WHO_EVENT_SPEAKER, but with more emphasis on art rather than speaking. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHO_EVENT_PERFORMER "http://schemas.google.com/g/2005#event.performer" /** @@ -60,7 +60,7 @@ G_BEGIN_DECLS * The relation type URI for a speaker at an event. * * Since: 0.7.0 - **/ + */ #define GDATA_GD_WHO_EVENT_SPEAKER "http://schemas.google.com/g/2005#event.speaker" /* TODO: Message kind relation types (http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWho) */ @@ -80,7 +80,7 @@ typedef struct _GDataGDWhoPrivate GDataGDWhoPrivate; * All the fields in the #GDataGDWho structure are private and should never be accessed directly. * * Since: 0.2.0 - **/ + */ typedef struct { GDataParsable parent; GDataGDWhoPrivate *priv; @@ -92,7 +92,7 @@ typedef struct { * All the fields in the #GDataGDWhoClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gdata-access-handler.c b/gdata/gdata-access-handler.c index df0304fb..eb09e631 100644 --- a/gdata/gdata-access-handler.c +++ b/gdata/gdata-access-handler.c @@ -35,7 +35,7 @@ * #GDataAccessRules will be performed unauthorized (i.e. as if by a non-logged-in user). This will not usually work. * * Since: 0.3.0 - **/ + */ #include #include @@ -182,7 +182,7 @@ get_rules_thread (GSimpleAsyncResult *result, GDataAccessHandler *access_handler * to get the results of the operation. * * Since: 0.9.1 - **/ + */ void gdata_access_handler_get_rules_async (GDataAccessHandler *self, GDataService *service, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -232,7 +232,7 @@ gdata_access_handler_get_rules_async (GDataAccessHandler *self, GDataService *se * Return value: (transfer full): a #GDataFeed of access control rules, or %NULL; unref with g_object_unref() * * Since: 0.3.0 - **/ + */ GDataFeed * gdata_access_handler_get_rules (GDataAccessHandler *self, GDataService *service, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) diff --git a/gdata/gdata-access-handler.h b/gdata/gdata-access-handler.h index 37137cdb..eff96c39 100644 --- a/gdata/gdata-access-handler.h +++ b/gdata/gdata-access-handler.h @@ -39,7 +39,7 @@ G_BEGIN_DECLS * ACL specification. * * Since: 0.7.0 - **/ + */ #define GDATA_LINK_ACCESS_CONTROL_LIST "http://schemas.google.com/acl/2007#accessControlList" #define GDATA_TYPE_ACCESS_HANDLER (gdata_access_handler_get_type ()) @@ -54,7 +54,7 @@ G_BEGIN_DECLS * All the fields in the #GDataAccessHandler structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct _GDataAccessHandler GDataAccessHandler; /* dummy typedef */ /** diff --git a/gdata/gdata-access-rule.c b/gdata/gdata-access-rule.c index 2ee3e00c..ae501ec0 100644 --- a/gdata/gdata-access-rule.c +++ b/gdata/gdata-access-rule.c @@ -76,7 +76,7 @@ * * * Since: 0.3.0 - **/ + */ #include #include @@ -144,7 +144,7 @@ gdata_access_rule_class_init (GDataAccessRuleClass *klass) * their own namespaced roles. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ROLE, g_param_spec_string ("role", "Role", "The role of the person concerned by this ACL.", @@ -157,7 +157,7 @@ gdata_access_rule_class_init (GDataAccessRuleClass *klass) * Specifies to whom this access rule applies. For example, %GDATA_ACCESS_SCOPE_USER or %GDATA_ACCESS_SCOPE_DEFAULT. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SCOPE_TYPE, g_param_spec_string ("scope-type", "Scope type", "Specifies to whom this access rule applies.", @@ -173,7 +173,7 @@ gdata_access_rule_class_init (GDataAccessRuleClass *klass) * This must be %NULL if and only if #GDataAccessRule:scope-type is %GDATA_ACCESS_SCOPE_DEFAULT. * * Since: 0.3.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SCOPE_VALUE, g_param_spec_string ("scope-value", "Scope value", "The scope value for this access rule.", @@ -189,7 +189,7 @@ gdata_access_rule_class_init (GDataAccessRuleClass *klass) * Atom Publishing Protocol specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", "Edited", "The last time the access rule was edited.", @@ -509,7 +509,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: a new #GDataAccessRule; unref with g_object_unref() * * Since: 0.3.0 - **/ + */ GDataAccessRule * gdata_access_rule_new (const gchar *id) { @@ -526,7 +526,7 @@ gdata_access_rule_new (const gchar *id) * Set @role to %NULL to unset the property in the access rule. * * Since: 0.3.0 - **/ + */ void gdata_access_rule_set_role (GDataAccessRule *self, const gchar *role) { @@ -547,7 +547,7 @@ gdata_access_rule_set_role (GDataAccessRule *self, const gchar *role) * Return value: the access rule's role, or %NULL * * Since: 0.3.0 - **/ + */ const gchar * gdata_access_rule_get_role (GDataAccessRule *self) { @@ -572,7 +572,7 @@ gdata_access_rule_get_role (GDataAccessRule *self) * documentation for more information. * * Since: 0.3.0 - **/ + */ void gdata_access_rule_set_scope (GDataAccessRule *self, const gchar *type, const gchar *value) { @@ -601,7 +601,7 @@ gdata_access_rule_set_scope (GDataAccessRule *self, const gchar *type, const gch * Gets the #GDataAccessRule:scope-type and #GDataAccessRule:scope-value properties. * * Since: 0.3.0 - **/ + */ void gdata_access_rule_get_scope (GDataAccessRule *self, const gchar **type, const gchar **value) { @@ -621,7 +621,7 @@ gdata_access_rule_get_scope (GDataAccessRule *self, const gchar **type, const gc * Return value: the UNIX timestamp for the time the access rule was last edited, or -1 * * Since: 0.7.0 - **/ + */ gint64 gdata_access_rule_get_edited (GDataAccessRule *self) { diff --git a/gdata/gdata-access-rule.h b/gdata/gdata-access-rule.h index 62ef1364..34db2c84 100644 --- a/gdata/gdata-access-rule.h +++ b/gdata/gdata-access-rule.h @@ -34,7 +34,7 @@ G_BEGIN_DECLS * The #GDataAccessRule applies to a single individual, whose e-mail address is given in #GDataAccessRule:scope-value. * * Since: 0.7.0 - **/ + */ #define GDATA_ACCESS_SCOPE_USER "user" /** @@ -43,7 +43,7 @@ G_BEGIN_DECLS * The #GDataAccessRule applies to all users in a Google Apps For Your Domain domain, given in #GDataAccessRule:scope-value. * * Since: 0.7.0 - **/ + */ #define GDATA_ACCESS_SCOPE_DOMAIN "domain" /** @@ -52,7 +52,7 @@ G_BEGIN_DECLS * The #GDataAccessRule applies to all users. * * Since: 0.7.0 - **/ + */ #define GDATA_ACCESS_SCOPE_DEFAULT "default" /** @@ -61,7 +61,7 @@ G_BEGIN_DECLS * The users specified by the #GDataAccessRule have no rights. * * Since: 0.7.0 - **/ + */ #define GDATA_ACCESS_ROLE_NONE "none" #define GDATA_TYPE_ACCESS_RULE (gdata_access_rule_get_type ()) @@ -79,7 +79,7 @@ typedef struct _GDataAccessRulePrivate GDataAccessRulePrivate; * All the fields in the #GDataAccessRule structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { GDataEntry parent; GDataAccessRulePrivate *priv; @@ -91,7 +91,7 @@ typedef struct { * All the fields in the #GDataAccessRuleClass structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { /*< private >*/ GDataEntryClass parent; diff --git a/gdata/gdata-batch-feed.h b/gdata/gdata-batch-feed.h index 69660b42..3e50d653 100644 --- a/gdata/gdata-batch-feed.h +++ b/gdata/gdata-batch-feed.h @@ -42,7 +42,7 @@ typedef struct _GDataBatchFeedPrivate GDataBatchFeedPrivate; * All the fields in the #GDataBatchFeed structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataFeed parent; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataBatchFeedClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GDataFeedClass parent; diff --git a/gdata/gdata-batch-operation.c b/gdata/gdata-batch-operation.c index 94e63e8a..6e78c618 100644 --- a/gdata/gdata-batch-operation.c +++ b/gdata/gdata-batch-operation.c @@ -90,7 +90,7 @@ * * * Since: 0.7.0 - **/ + */ #include #include @@ -147,7 +147,7 @@ gdata_batch_operation_class_init (GDataBatchOperationClass *klass) * The service this batch operation is attached to. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SERVICE, g_param_spec_object ("service", "Service", "The service this batch operation is attached to.", @@ -177,7 +177,7 @@ gdata_batch_operation_class_init (GDataBatchOperationClass *klass) * The feed URI that this batch operation will be sent to. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FEED_URI, g_param_spec_string ("feed-uri", "Feed URI", "The feed URI that this batch operation will be sent to.", @@ -276,7 +276,7 @@ gdata_batch_operation_finalize (GObject *object) * Return value: (transfer none): the batch operation's attached service * * Since: 0.7.0 - **/ + */ GDataService * gdata_batch_operation_get_service (GDataBatchOperation *self) { @@ -311,7 +311,7 @@ gdata_batch_operation_get_authorization_domain (GDataBatchOperation *self) * Return value: the batch operation's feed URI * * Since: 0.7.0 - **/ + */ const gchar * gdata_batch_operation_get_feed_uri (GDataBatchOperation *self) { @@ -349,7 +349,7 @@ add_operation (GDataBatchOperation *self, GDataBatchOperationType type, GDataEnt * Return value: the relevant #BatchOperation, or %NULL * * Since: 0.7.0 - **/ + */ BatchOperation * _gdata_batch_operation_get_operation (GDataBatchOperation *self, guint id) { @@ -388,7 +388,7 @@ run_callback_cb (BatchOperation *op) * #GDataBatchOperation was run with gdata_batch_operation_run() or gdata_batch_operation_run_async(). * * Since: 0.7.0 - **/ + */ void _gdata_batch_operation_run_callback (GDataBatchOperation *self, BatchOperation *op, GDataEntry *entry, GError *error) { @@ -458,7 +458,7 @@ operation_free (BatchOperation *op) * Return value: operation ID for the added query, or 0 * * Since: 0.7.0 - **/ + */ guint gdata_batch_operation_add_query (GDataBatchOperation *self, const gchar *id, GType entry_type, GDataBatchOperationCallback callback, gpointer user_data) @@ -501,7 +501,7 @@ gdata_batch_operation_add_query (GDataBatchOperation *self, const gchar *id, GTy * Return value: operation ID for the added insertion, or 0 * * Since: 0.7.0 - **/ + */ guint gdata_batch_operation_add_insertion (GDataBatchOperation *self, GDataEntry *entry, GDataBatchOperationCallback callback, gpointer user_data) { @@ -531,7 +531,7 @@ gdata_batch_operation_add_insertion (GDataBatchOperation *self, GDataEntry *entr * Return value: operation ID for the added update, or 0 * * Since: 0.7.0 - **/ + */ guint gdata_batch_operation_add_update (GDataBatchOperation *self, GDataEntry *entry, GDataBatchOperationCallback callback, gpointer user_data) { @@ -561,7 +561,7 @@ gdata_batch_operation_add_update (GDataBatchOperation *self, GDataEntry *entry, * Return value: operation ID for the added deletion, or 0 * * Since: 0.7.0 - **/ + */ guint gdata_batch_operation_add_deletion (GDataBatchOperation *self, GDataEntry *entry, GDataBatchOperationCallback callback, gpointer user_data) { @@ -594,7 +594,7 @@ gdata_batch_operation_add_deletion (GDataBatchOperation *self, GDataEntry *entry * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gboolean gdata_batch_operation_run (GDataBatchOperation *self, GCancellable *cancellable, GError **error) { @@ -757,7 +757,7 @@ run_thread (GSimpleAsyncResult *result, GDataBatchOperation *operation, GCancell * the batch operation. * * Since: 0.7.0 - **/ + */ void gdata_batch_operation_run_async (GDataBatchOperation *self, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { @@ -793,7 +793,7 @@ gdata_batch_operation_run_async (GDataBatchOperation *self, GCancellable *cancel * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gboolean gdata_batch_operation_run_finish (GDataBatchOperation *self, GAsyncResult *async_result, GError **error) { diff --git a/gdata/gdata-batch-operation.h b/gdata/gdata-batch-operation.h index adad98a6..1626a282 100644 --- a/gdata/gdata-batch-operation.h +++ b/gdata/gdata-batch-operation.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * For more information, see the GData specification. * * Since: 0.7.0 - **/ + */ #define GDATA_LINK_BATCH "http://schemas.google.com/g/2005#batch" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * Indicates which type of batch operation caused the current #GDataBatchOperationCallback to be called. * * Since: 0.7.0 - **/ + */ typedef enum { GDATA_BATCH_OPERATION_QUERY = 0, GDATA_BATCH_OPERATION_INSERTION, @@ -83,7 +83,7 @@ typedef enum { * initiated synchronously). * * Since: 0.7.0 - **/ + */ typedef void (*GDataBatchOperationCallback) (guint operation_id, GDataBatchOperationType operation_type, GDataEntry *entry, GError *error, gpointer user_data); @@ -102,7 +102,7 @@ typedef struct _GDataBatchOperationPrivate GDataBatchOperationPrivate; * All the fields in the #GDataBatchOperation structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { GObject parent; GDataBatchOperationPrivate *priv; @@ -114,7 +114,7 @@ typedef struct { * All the fields in the #GDataBatchOperationClass structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GObjectClass parent; diff --git a/gdata/gdata-batchable.c b/gdata/gdata-batchable.c index 6389a4dc..763909e1 100644 --- a/gdata/gdata-batchable.c +++ b/gdata/gdata-batchable.c @@ -27,7 +27,7 @@ * creation of a #GDataBatchOperation for the service, which allows a set of batch operations to be run. * * Since: 0.7.0 - **/ + */ #include #include diff --git a/gdata/gdata-batchable.h b/gdata/gdata-batchable.h index a429f821..5dce9a15 100644 --- a/gdata/gdata-batchable.h +++ b/gdata/gdata-batchable.h @@ -41,7 +41,7 @@ G_BEGIN_DECLS * All the fields in the #GDataBatchable structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct _GDataBatchable GDataBatchable; /* dummy typedef */ /** @@ -57,7 +57,7 @@ typedef struct _GDataBatchable GDataBatchable; /* dummy typedef */ * All the fields in the #GDataBatchableIface structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct { /*< private >*/ GTypeInterface parent; diff --git a/gdata/gdata-buffer.c b/gdata/gdata-buffer.c index ce40f80f..ac426366 100644 --- a/gdata/gdata-buffer.c +++ b/gdata/gdata-buffer.c @@ -50,7 +50,7 @@ struct _GDataBufferChunk { * Return value: a new #GDataBuffer; free with gdata_buffer_free() * * Since: 0.5.0 - **/ + */ GDataBuffer * gdata_buffer_new (void) { @@ -70,7 +70,7 @@ gdata_buffer_new (void) * the EOF has been reached). * * Since: 0.5.0 - **/ + */ void gdata_buffer_free (GDataBuffer *self) { @@ -107,7 +107,7 @@ gdata_buffer_free (GDataBuffer *self) * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.5.0 - **/ + */ gboolean gdata_buffer_push_data (GDataBuffer *self, const guint8 *data, gsize length) { @@ -196,7 +196,7 @@ pop_cancelled_cb (GCancellable *cancellable, CancelledData *data) * Return value: the number of bytes returned in @data * * Since: 0.5.0 - **/ + */ gsize gdata_buffer_pop_data (GDataBuffer *self, guint8 *data, gsize length_requested, gboolean *reached_eof, GCancellable *cancellable) { @@ -332,7 +332,7 @@ done: * Return value: the number of bytes returned in @data (guaranteed to be more than 0 and at most @maximum_length) * * Since: 0.5.0 - **/ + */ gsize gdata_buffer_pop_data_limited (GDataBuffer *self, guint8 *data, gsize maximum_length, gboolean *reached_eof) { diff --git a/gdata/gdata-buffer.h b/gdata/gdata-buffer.h index 57696d77..0fbd14be 100644 --- a/gdata/gdata-buffer.h +++ b/gdata/gdata-buffer.h @@ -34,7 +34,7 @@ typedef struct _GDataBufferChunk GDataBufferChunk; * All the fields in the #GDataBuffer structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { /*< private >*/ GDataBufferChunk *head; diff --git a/gdata/gdata-comparable.c b/gdata/gdata-comparable.c index 7817f37d..d4c5d18a 100644 --- a/gdata/gdata-comparable.c +++ b/gdata/gdata-comparable.c @@ -31,7 +31,7 @@ * . * * Since: 0.7.0 - **/ + */ #include #include @@ -68,7 +68,7 @@ gdata_comparable_get_type (void) * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.7.0 - **/ + */ gint gdata_comparable_compare (GDataComparable *self, GDataComparable *other) { diff --git a/gdata/gdata-comparable.h b/gdata/gdata-comparable.h index f5b1f64c..7843afeb 100644 --- a/gdata/gdata-comparable.h +++ b/gdata/gdata-comparable.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * All the fields in the #GDataComparable structure are private and should never be accessed directly. * * Since: 0.7.0 - **/ + */ typedef struct _GDataComparable GDataComparable; /* dummy typedef */ /** @@ -50,7 +50,7 @@ typedef struct _GDataComparable GDataComparable; /* dummy typedef */ * The class structure for the #GDataComparable interface. * * Since: 0.7.0 - **/ + */ typedef struct { GTypeInterface parent; diff --git a/gdata/gdata-download-stream.c b/gdata/gdata-download-stream.c index 7613fd20..5bfd7048 100644 --- a/gdata/gdata-download-stream.c +++ b/gdata/gdata-download-stream.c @@ -98,7 +98,7 @@ * * * Since: 0.5.0 - **/ + */ #include #include @@ -209,7 +209,7 @@ gdata_download_stream_class_init (GDataDownloadStreamClass *klass) * The service which is used to authorize the download, and to which the download relates. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SERVICE, g_param_spec_object ("service", "Service", "The service which is used to authorize the download.", @@ -236,7 +236,7 @@ gdata_download_stream_class_init (GDataDownloadStreamClass *klass) * The URI of the file to download. This must be HTTPS. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DOWNLOAD_URI, g_param_spec_string ("download-uri", "Download URI", "The URI of the file to download.", @@ -254,7 +254,7 @@ gdata_download_stream_class_init (GDataDownloadStreamClass *klass) * or marshal the notification to the thread which owns the #GDataDownloadStream as appropriate. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT_TYPE, g_param_spec_string ("content-type", "Content type", "The content type of the file being downloaded.", @@ -272,7 +272,7 @@ gdata_download_stream_class_init (GDataDownloadStreamClass *klass) * or marshal the notification to the thread which owns the #GDataDownloadStream as appropriate. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT_LENGTH, g_param_spec_long ("content-length", "Content length", "The length (in bytes) of the file being downloaded.", @@ -293,7 +293,7 @@ gdata_download_stream_class_init (GDataDownloadStreamClass *klass) * call. The only way to cancel the download operation completely is using #GDataDownloadStream:cancellable. * * Since: 0.8.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CANCELLABLE, g_param_spec_object ("cancellable", "Cancellable", "An optional cancellable used to cancel the entire download operation.", @@ -946,7 +946,7 @@ reset_network_thread (GDataDownloadStream *self) * Return value: a new #GInputStream, or %NULL; unref with g_object_unref() * * Since: 0.9.0 - **/ + */ GInputStream * gdata_download_stream_new (GDataService *service, GDataAuthorizationDomain *domain, const gchar *download_uri, GCancellable *cancellable) { @@ -972,7 +972,7 @@ gdata_download_stream_new (GDataService *service, GDataAuthorizationDomain *doma * Return value: (transfer none): the #GDataService used to authorize the download * * Since: 0.5.0 - **/ + */ GDataService * gdata_download_stream_get_service (GDataDownloadStream *self) { @@ -1007,7 +1007,7 @@ gdata_download_stream_get_authorization_domain (GDataDownloadStream *self) * Return value: the URI of the file being downloaded * * Since: 0.5.0 - **/ + */ const gchar * gdata_download_stream_get_download_uri (GDataDownloadStream *self) { @@ -1025,7 +1025,7 @@ gdata_download_stream_get_download_uri (GDataDownloadStream *self) * Return value: the content type of the file being downloaded, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_download_stream_get_content_type (GDataDownloadStream *self) { @@ -1051,7 +1051,7 @@ gdata_download_stream_get_content_type (GDataDownloadStream *self) * Return value: the content length of the file being downloaded, or -1 * * Since: 0.5.0 - **/ + */ gssize gdata_download_stream_get_content_length (GDataDownloadStream *self) { @@ -1077,7 +1077,7 @@ gdata_download_stream_get_content_length (GDataDownloadStream *self) * Return value: (transfer none): the #GCancellable for the entire download operation * * Since: 0.8.0 - **/ + */ GCancellable * gdata_download_stream_get_cancellable (GDataDownloadStream *self) { diff --git a/gdata/gdata-download-stream.h b/gdata/gdata-download-stream.h index 141e3fcd..9086f2ad 100644 --- a/gdata/gdata-download-stream.h +++ b/gdata/gdata-download-stream.h @@ -43,7 +43,7 @@ typedef struct _GDataDownloadStreamPrivate GDataDownloadStreamPrivate; * All the fields in the #GDataDownloadStream structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { GInputStream parent; GDataDownloadStreamPrivate *priv; @@ -55,7 +55,7 @@ typedef struct { * All the fields in the #GDataDownloadStreamClass structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { /*< private >*/ GInputStreamClass parent; diff --git a/gdata/gdata-entry.c b/gdata/gdata-entry.c index b81e7cf1..1833e3d1 100644 --- a/gdata/gdata-entry.c +++ b/gdata/gdata-entry.c @@ -26,7 +26,7 @@ * #GDataEntry represents a single object on the online service, such as a playlist, video or calendar event. It is a snapshot of the * state of that object at the time of querying the service, so modifications made to a #GDataEntry will not be automatically or * magically propagated to the server. - **/ + */ #include #include @@ -127,7 +127,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * * For more information, see the Atom specification. - **/ + */ g_object_class_install_property (gobject_class, PROP_TITLE, g_param_spec_string ("title", "Title", "A human-readable title for the entry.", @@ -143,7 +143,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.summary">Atom specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SUMMARY, g_param_spec_string ("summary", "Summary", "A short summary, abstract, or excerpt of the entry.", @@ -158,7 +158,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * * For more information, see the * Atom specification. - **/ + */ g_object_class_install_property (gobject_class, PROP_ID, g_param_spec_string ("id", "ID", "A permanent, universally unique identifier for the entry, in IRI form.", @@ -175,7 +175,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * GData specification. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ETAG, g_param_spec_string ("etag", "ETag", "An identifier for a particular version of the entry.", @@ -189,7 +189,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * * For more information, see the Atom specification. - **/ + */ g_object_class_install_property (gobject_class, PROP_UPDATED, g_param_spec_int64 ("updated", "Updated", "The date and time when the entry was most recently updated significantly.", @@ -203,7 +203,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * * For more information, see the Atom specification. - **/ + */ g_object_class_install_property (gobject_class, PROP_PUBLISHED, g_param_spec_int64 ("published", "Published", "The date and time the entry was first published or made available.", @@ -217,7 +217,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * * For more information, see the Atom specification. - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT, g_param_spec_string ("content", "Content", "The content of the entry.", @@ -233,7 +233,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * Atom specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT_URI, g_param_spec_string ("content-uri", "Content URI", "A URI pointing to the location of the content of the entry.", @@ -245,7 +245,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * * Whether the entry has been inserted on the server. This is %FALSE for entries which have just been created using gdata_entry_new() and * %TRUE for entries returned from the server by queries. It is set to %TRUE when an entry is inserted using gdata_service_insert_entry(). - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_INSERTED, g_param_spec_boolean ("is-inserted", "Inserted?", "Whether the entry has been inserted on the server.", @@ -261,7 +261,7 @@ gdata_entry_class_init (GDataEntryClass *klass) * url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.rights">Atom specification. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RIGHTS, g_param_spec_string ("rights", "Rights", "The ownership rights pertaining to the entry.", @@ -696,7 +696,7 @@ get_json (GDataParsable *parsable, JsonBuilder *builder) * Creates a new #GDataEntry with the given ID and default properties. * * Return value: a new #GDataEntry; unref with g_object_unref() - **/ + */ GDataEntry * gdata_entry_new (const gchar *id) { @@ -715,7 +715,7 @@ gdata_entry_new (const gchar *id) * Returns the title of the entry. This will never be %NULL, but may be an empty string. * * Return value: the entry's title - **/ + */ const gchar * gdata_entry_get_title (GDataEntry *self) { @@ -729,7 +729,7 @@ gdata_entry_get_title (GDataEntry *self) * @title: (allow-none): the new entry title, or %NULL * * Sets the title of the entry. - **/ + */ void gdata_entry_set_title (GDataEntry *self, const gchar *title) { @@ -749,7 +749,7 @@ gdata_entry_set_title (GDataEntry *self, const gchar *title) * Return value: the entry's summary, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_entry_get_summary (GDataEntry *self) { @@ -765,7 +765,7 @@ gdata_entry_get_summary (GDataEntry *self) * Sets the summary of the entry. * * Since: 0.4.0 - **/ + */ void gdata_entry_set_summary (GDataEntry *self, const gchar *summary) { @@ -785,7 +785,7 @@ gdata_entry_set_summary (GDataEntry *self, const gchar *summary) * The ID may be %NULL if and only if the #GDataEntry has been newly created, and hasn't yet been inserted on the server. * * Return value: (nullable): the entry's ID, or %NULL - **/ + */ const gchar * gdata_entry_get_id (GDataEntry *self) { @@ -815,7 +815,7 @@ gdata_entry_get_id (GDataEntry *self) * Return value: (nullable): the entry's ETag, or %NULL * * Since: 0.2.0 - **/ + */ const gchar * gdata_entry_get_etag (GDataEntry *self) { @@ -859,7 +859,7 @@ _gdata_entry_set_etag (GDataEntry *self, const gchar *etag) * Gets the time the entry was last updated. * * Return value: the UNIX timestamp for the last update of the entry - **/ + */ gint64 gdata_entry_get_updated (GDataEntry *self) { @@ -924,7 +924,7 @@ _gdata_entry_set_id (GDataEntry *self, const gchar *id) * Gets the time the entry was originally published. * * Return value: the UNIX timestamp for the original publish time of the entry - **/ + */ gint64 gdata_entry_get_published (GDataEntry *self) { @@ -940,7 +940,7 @@ gdata_entry_get_published (GDataEntry *self) * Adds @category to the list of categories in the given #GDataEntry, and increments its reference count. * * Duplicate categories will not be added to the list. - **/ + */ void gdata_entry_add_category (GDataEntry *self, GDataCategory *category) { @@ -989,7 +989,7 @@ gdata_entry_add_category (GDataEntry *self, GDataCategory *category) * Return value: (element-type GData.Category) (transfer none): a #GList of #GDataCategorys * * Since: 0.2.0 - **/ + */ GList * gdata_entry_get_categories (GDataEntry *self) { @@ -1006,7 +1006,7 @@ gdata_entry_get_categories (GDataEntry *self) * Return value: (element-type GData.Author) (transfer none): a #GList of #GDataAuthors * * Since: 0.7.0 - **/ + */ GList * gdata_entry_get_authors (GDataEntry *self) { @@ -1022,7 +1022,7 @@ gdata_entry_get_authors (GDataEntry *self) * returned by gdata_entry_get_content_uri(). * * Return value: the entry's content, or %NULL - **/ + */ const gchar * gdata_entry_get_content (GDataEntry *self) { @@ -1036,7 +1036,7 @@ gdata_entry_get_content (GDataEntry *self) * @content: (allow-none): the new content for the entry, or %NULL * * Sets the entry's content to @content. This unsets #GDataEntry:content-uri. - **/ + */ void gdata_entry_set_content (GDataEntry *self, const gchar *content) { @@ -1062,7 +1062,7 @@ gdata_entry_set_content (GDataEntry *self, const gchar *content) * Return value: a URI pointing to the entry's content, or %NULL * * Since: 0.7.0 - **/ + */ const gchar * gdata_entry_get_content_uri (GDataEntry *self) { @@ -1078,7 +1078,7 @@ gdata_entry_get_content_uri (GDataEntry *self) * Sets the URI pointing to the entry's content to @content. This unsets #GDataEntry:content. * * Since: 0.7.0 - **/ + */ void gdata_entry_set_content_uri (GDataEntry *self, const gchar *content_uri) { @@ -1102,7 +1102,7 @@ gdata_entry_set_content_uri (GDataEntry *self, const gchar *content_uri) * Adds @_link to the list of links in the given #GDataEntry and increments its reference count. * * Duplicate links will not be added to the list. - **/ + */ void gdata_entry_add_link (GDataEntry *self, GDataLink *_link) { @@ -1165,7 +1165,7 @@ link_compare_cb (const GDataLink *_link, const gchar *rel) * Return value: (transfer none): a #GDataLink, or %NULL if one was not found * * Since: 0.1.1 - **/ + */ GDataLink * gdata_entry_look_up_link (GDataEntry *self, const gchar *rel) { @@ -1194,7 +1194,7 @@ gdata_entry_look_up_link (GDataEntry *self, const gchar *rel) * g_list_free() * * Since: 0.4.0 - **/ + */ GList * gdata_entry_look_up_links (GDataEntry *self, const gchar *rel) { @@ -1220,7 +1220,7 @@ gdata_entry_look_up_links (GDataEntry *self, const gchar *rel) * Adds @author to the list of authors in the given #GDataEntry and increments its reference count. * * Duplicate authors will not be added to the list. - **/ + */ void gdata_entry_add_author (GDataEntry *self, GDataAuthor *author) { @@ -1239,7 +1239,7 @@ gdata_entry_add_author (GDataEntry *self, GDataAuthor *author) * Returns whether the entry is marked as having been inserted on (uploaded to) the server already. * * Return value: %TRUE if the entry has been inserted already, %FALSE otherwise - **/ + */ gboolean gdata_entry_is_inserted (GDataEntry *self) { @@ -1259,7 +1259,7 @@ gdata_entry_is_inserted (GDataEntry *self) * Return value: the entry's rights information * * Since: 0.5.0 - **/ + */ const gchar * gdata_entry_get_rights (GDataEntry *self) { @@ -1275,7 +1275,7 @@ gdata_entry_get_rights (GDataEntry *self) * Sets the rights for this entry. * * Since: 0.5.0 - **/ + */ void gdata_entry_set_rights (GDataEntry *self, const gchar *rights) { diff --git a/gdata/gdata-entry.h b/gdata/gdata-entry.h index db5004e2..d3fd7483 100644 --- a/gdata/gdata-entry.h +++ b/gdata/gdata-entry.h @@ -43,7 +43,7 @@ typedef struct _GDataEntryPrivate GDataEntryPrivate; * GDataEntry: * * All the fields in the #GDataEntry structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataEntryPrivate *priv; @@ -57,7 +57,7 @@ typedef struct { * documentation on kinds) * * The class structure for the #GDataEntry type. - **/ + */ typedef struct { GDataParsableClass parent; diff --git a/gdata/gdata-feed.c b/gdata/gdata-feed.c index 66ec8a9a..14fe8a57 100644 --- a/gdata/gdata-feed.c +++ b/gdata/gdata-feed.c @@ -30,7 +30,7 @@ * * Each #GDataEntry represents a single object on the online service, such as a playlist, video or calendar entry, and the #GDataFeed * represents a collection of similar objects. - **/ + */ #include #include @@ -126,7 +126,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * * API reference: * atom:title - **/ + */ g_object_class_install_property (gobject_class, PROP_TITLE, g_param_spec_string ("title", "Title", "The title of the feed.", @@ -139,7 +139,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * The subtitle of the feed. * * API reference: atom:subtitle - **/ + */ g_object_class_install_property (gobject_class, PROP_SUBTITLE, g_param_spec_string ("subtitle", "Subtitle", "The subtitle of the feed.", @@ -152,7 +152,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * The unique and permanent URN ID for the feed. * * API reference: atom:id - **/ + */ g_object_class_install_property (gobject_class, PROP_ID, g_param_spec_string ("id", "ID", "The unique and permanent URN ID for the feed.", @@ -167,7 +167,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * more information. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ETAG, g_param_spec_string ("etag", "ETag", "The unique ETag for this version of the feed.", @@ -181,7 +181,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * * API reference: * atom:updated - **/ + */ g_object_class_install_property (gobject_class, PROP_UPDATED, g_param_spec_int64 ("updated", "Updated", "The time the feed was last updated.", @@ -194,7 +194,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * The URI of a logo for the feed. * * API reference: atom:logo - **/ + */ g_object_class_install_property (gobject_class, PROP_LOGO, g_param_spec_string ("logo", "Logo", "The URI of a logo for the feed.", @@ -210,7 +210,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * atom:icon * * Since: 0.6.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ICON, g_param_spec_string ("icon", "Icon", "The URI of an icon for the feed.", @@ -224,7 +224,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * * API reference: * atom:generator - **/ + */ g_object_class_install_property (gobject_class, PROP_GENERATOR, g_param_spec_object ("generator", "Generator", "Details of the software used to generate the feed.", @@ -240,7 +240,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.rights">Atom specification. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_RIGHTS, g_param_spec_string ("rights", "Rights", "The ownership rights pertaining to the entire feed.", @@ -255,7 +255,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * API reference: * * openSearch:itemsPerPage - **/ + */ g_object_class_install_property (gobject_class, PROP_ITEMS_PER_PAGE, g_param_spec_uint ("items-per-page", "Items per page", "The number of items per results page feed.", @@ -272,7 +272,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * * API reference: * openSearch:startIndex - **/ + */ g_object_class_install_property (gobject_class, PROP_START_INDEX, g_param_spec_uint ("start-index", "Start index", "The one-based index of the first item in the results feed.", @@ -290,7 +290,7 @@ gdata_feed_class_init (GDataFeedClass *klass) * API reference: * * openSearch:totalResults - **/ + */ g_object_class_install_property (gobject_class, PROP_TOTAL_RESULTS, g_param_spec_uint ("total-results", "Total results", "The total number of results in the feed.", @@ -752,7 +752,7 @@ _gdata_feed_new_from_json (GType feed_type, const gchar *json, gint length, GTyp * Returns a list of the entries contained in this feed. * * Return value: (element-type GData.Entry) (transfer none): a #GList of #GDataEntrys - **/ + */ GList * gdata_feed_get_entries (GDataFeed *self) { @@ -776,7 +776,7 @@ entry_compare_cb (const GDataEntry *entry, const gchar *id) * Return value: (transfer none): the #GDataEntry, or %NULL * * Since: 0.2.0 - **/ + */ GDataEntry * gdata_feed_look_up_entry (GDataFeed *self, const gchar *id) { @@ -798,7 +798,7 @@ gdata_feed_look_up_entry (GDataFeed *self, const gchar *id) * Returns a list of the categories listed in this feed. * * Return value: (element-type GData.Category) (transfer none): a #GList of #GDataCategorys - **/ + */ GList * gdata_feed_get_categories (GDataFeed *self) { @@ -819,7 +819,7 @@ _gdata_feed_add_category (GDataFeed *self, GDataCategory *category) * Returns a list of the links listed in this feed. * * Return value: (element-type GData.Link) (transfer none): a #GList of #GDataLinks - **/ + */ GList * gdata_feed_get_links (GDataFeed *self) { @@ -843,7 +843,7 @@ link_compare_cb (const GDataLink *_link, const gchar *rel) * Return value: (transfer none): a #GDataLink, or %NULL if one was not found * * Since: 0.1.1 - **/ + */ GDataLink * gdata_feed_look_up_link (GDataFeed *self, const gchar *rel) { @@ -871,7 +871,7 @@ _gdata_feed_add_link (GDataFeed *self, GDataLink *_link) * Returns a list of the authors listed in this feed. * * Return value: (element-type GData.Author) (transfer none): a #GList of #GDataAuthors - **/ + */ GList * gdata_feed_get_authors (GDataFeed *self) { @@ -892,7 +892,7 @@ _gdata_feed_add_author (GDataFeed *self, GDataAuthor *author) * Returns the title of the feed. * * Return value: the feed's title - **/ + */ const gchar * gdata_feed_get_title (GDataFeed *self) { @@ -907,7 +907,7 @@ gdata_feed_get_title (GDataFeed *self) * Returns the subtitle of the feed. * * Return value: the feed's subtitle, or %NULL - **/ + */ const gchar * gdata_feed_get_subtitle (GDataFeed *self) { @@ -922,7 +922,7 @@ gdata_feed_get_subtitle (GDataFeed *self) * Returns the feed's unique and permanent URN ID. * * Return value: the feed's ID - **/ + */ const gchar * gdata_feed_get_id (GDataFeed *self) { @@ -939,7 +939,7 @@ gdata_feed_get_id (GDataFeed *self) * Return value: the feed's ETag * * Since: 0.2.0 - **/ + */ const gchar * gdata_feed_get_etag (GDataFeed *self) { @@ -954,7 +954,7 @@ gdata_feed_get_etag (GDataFeed *self) * Gets the time the feed was last updated. * * Return value: the UNIX timestamp for the time the feed was last updated - **/ + */ gint64 gdata_feed_get_updated (GDataFeed *self) { @@ -969,7 +969,7 @@ gdata_feed_get_updated (GDataFeed *self) * Returns the logo URI of the feed. * * Return value: the feed's logo URI, or %NULL - **/ + */ const gchar * gdata_feed_get_logo (GDataFeed *self) { @@ -986,7 +986,7 @@ gdata_feed_get_logo (GDataFeed *self) * Return value: the feed's icon URI, or %NULL * * Since: 0.6.0 - **/ + */ const gchar * gdata_feed_get_icon (GDataFeed *self) { @@ -1001,7 +1001,7 @@ gdata_feed_get_icon (GDataFeed *self) * Returns details about the software which generated the feed. * * Return value: (transfer none): a #GDataGenerator, or %NULL - **/ + */ GDataGenerator * gdata_feed_get_generator (GDataFeed *self) { @@ -1018,7 +1018,7 @@ gdata_feed_get_generator (GDataFeed *self) * Return value: the feed's rights information * * Since: 0.7.0 - **/ + */ const gchar * gdata_feed_get_rights (GDataFeed *self) { @@ -1033,7 +1033,7 @@ gdata_feed_get_rights (GDataFeed *self) * Returns the number of items per results page feed. * * Return value: the number of items per results page feed, or 0 - **/ + */ guint gdata_feed_get_items_per_page (GDataFeed *self) { @@ -1048,7 +1048,7 @@ gdata_feed_get_items_per_page (GDataFeed *self) * Returns the one-based start index of the results feed in the result set. * * Return value: the one-based start index, or 0 - **/ + */ guint gdata_feed_get_start_index (GDataFeed *self) { @@ -1064,7 +1064,7 @@ gdata_feed_get_start_index (GDataFeed *self) * pages. If this is zero, the total number is unknown. * * Return value: the total number of results, or 0 - **/ + */ guint gdata_feed_get_total_results (GDataFeed *self) { diff --git a/gdata/gdata-feed.h b/gdata/gdata-feed.h index c94431fc..6a1e050a 100644 --- a/gdata/gdata-feed.h +++ b/gdata/gdata-feed.h @@ -43,7 +43,7 @@ typedef struct _GDataFeedPrivate GDataFeedPrivate; * GDataFeed: * * All the fields in the #GDataFeed structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataParsable parent; @@ -54,7 +54,7 @@ typedef struct { * GDataFeedClass: * * All the fields in the #GDataFeedClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/gdata-parsable.c b/gdata/gdata-parsable.c index e1822ec1..64fa1bfe 100644 --- a/gdata/gdata-parsable.c +++ b/gdata/gdata-parsable.c @@ -29,7 +29,7 @@ * It allows methods to be defined for handling the root XML node, each of its child nodes, and a method to be called after parsing is complete. * * Since: 0.3.0 - **/ + */ #include #include @@ -92,7 +92,7 @@ gdata_parsable_class_init (GDataParsableClass *klass) * Specifies whether the object was constructed by parsing XML or manually. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONSTRUCTED_FROM_XML, g_param_spec_boolean ("constructed-from-xml", "Constructed from XML?", @@ -306,7 +306,7 @@ get_content_type (void) { * Return value: a new #GDataParsable, or %NULL; unref with g_object_unref() * * Since: 0.4.0 - **/ + */ GDataParsable * gdata_parsable_new_from_xml (GType parsable_type, const gchar *xml, gint length, GError **error) { @@ -571,7 +571,7 @@ filter_namespaces_cb (gchar *prefix, gchar *href, GHashTable *canonical_namespac * Return value: the object's XML; free with g_free() * * Since: 0.4.0 - **/ + */ gchar * gdata_parsable_get_xml (GDataParsable *self) { diff --git a/gdata/gdata-parsable.h b/gdata/gdata-parsable.h index 9aa84bcd..2f16a8e7 100644 --- a/gdata/gdata-parsable.h +++ b/gdata/gdata-parsable.h @@ -33,7 +33,7 @@ G_BEGIN_DECLS * @GDATA_PARSER_ERROR_EMPTY_DOCUMENT: Empty document * * Error codes for XML or JSON parsing operations. - **/ + */ typedef enum { GDATA_PARSER_ERROR_PARSING_STRING = 1, GDATA_PARSER_ERROR_EMPTY_DOCUMENT @@ -57,7 +57,7 @@ typedef struct _GDataParsablePrivate GDataParsablePrivate; * All the fields in the #GDataParsable structure are private and should never be accessed directly. * * Since: 0.3.0 - **/ + */ typedef struct { GObject parent; GDataParsablePrivate *priv; @@ -85,7 +85,7 @@ typedef struct { * a given implementation of #GDataParsable is represented as exactly one of JSON and XML. * * Since: 0.3.0 - **/ + */ typedef struct { GObjectClass parent; diff --git a/gdata/gdata-private.h b/gdata/gdata-private.h index 62b16696..ecb4534e 100644 --- a/gdata/gdata-private.h +++ b/gdata/gdata-private.h @@ -39,7 +39,7 @@ G_BEGIN_DECLS * logs, and don't redact usernames, passwords and auth. tokens * * Logging level. - **/ + */ typedef enum { GDATA_LOG_NONE = 0, GDATA_LOG_MESSAGES = 1, diff --git a/gdata/gdata-query.c b/gdata/gdata-query.c index 84e6b458..e1f54468 100644 --- a/gdata/gdata-query.c +++ b/gdata/gdata-query.c @@ -40,7 +40,7 @@ * * For more information on the standard GData query parameters supported by #GDataQuery, see the online documentation. - **/ + */ #include #include @@ -135,7 +135,7 @@ gdata_query_class_init (GDataQueryClass *klass) * * Example: to search for all entries that contain the exact phrase "Elizabeth Bennet" and the word "Darcy" but don't contain the * word "Austen", use the following query: "Elizabeth Bennet" Darcy -Austen. - **/ + */ g_object_class_install_property (gobject_class, PROP_Q, g_param_spec_string ("q", "Query terms", "Query terms for which to search.", @@ -165,7 +165,7 @@ gdata_query_class_init (GDataQueryClass *klass) * that has no scheme, use an empty pair of curly braces. If you don't specify curly braces, then categories in any scheme will match. * * The above features can be combined. For example: A|-{urn:google.com}B/-C means (A OR (NOT B)) AND (NOT C). - **/ + */ g_object_class_install_property (gobject_class, PROP_CATEGORIES, g_param_spec_string ("categories", "Category string", "Category search string.", @@ -176,7 +176,7 @@ gdata_query_class_init (GDataQueryClass *klass) * GDataQuery:author: * * An entry author. The service returns entries where the author name and/or e-mail address match your query string. - **/ + */ g_object_class_install_property (gobject_class, PROP_AUTHOR, g_param_spec_string ("author", "Author", "Author search string.", @@ -187,7 +187,7 @@ gdata_query_class_init (GDataQueryClass *klass) * GDataQuery:updated-min: * * Lower bound on the entry update date, inclusive. - **/ + */ g_object_class_install_property (gobject_class, PROP_UPDATED_MIN, g_param_spec_int64 ("updated-min", "Minimum update date", "Minimum date for updates on returned entries.", @@ -198,7 +198,7 @@ gdata_query_class_init (GDataQueryClass *klass) * GDataQuery:updated-max: * * Upper bound on the entry update date, exclusive. - **/ + */ g_object_class_install_property (gobject_class, PROP_UPDATED_MAX, g_param_spec_int64 ("updated-max", "Maximum update date", "Maximum date for updates on returned entries.", @@ -209,7 +209,7 @@ gdata_query_class_init (GDataQueryClass *klass) * GDataQuery:published-min: * * Lower bound on the entry publish date, inclusive. - **/ + */ g_object_class_install_property (gobject_class, PROP_PUBLISHED_MIN, g_param_spec_int64 ("published-min", "Minimum publish date", "Minimum date for returned entries to be published.", @@ -220,7 +220,7 @@ gdata_query_class_init (GDataQueryClass *klass) * GDataQuery:published-max: * * Upper bound on the entry publish date, exclusive. - **/ + */ g_object_class_install_property (gobject_class, PROP_PUBLISHED_MAX, g_param_spec_int64 ("published-max", "Maximum publish date", "Maximum date for returned entries to be published.", @@ -234,7 +234,7 @@ gdata_query_class_init (GDataQueryClass *klass) * implement pagination, rather than manually changing #GDataQuery:start-index. * * Use 0 to not specify a start index. - **/ + */ g_object_class_install_property (gobject_class, PROP_START_INDEX, g_param_spec_uint ("start-index", "Start index", "One-based result start index.", @@ -248,7 +248,7 @@ gdata_query_class_init (GDataQueryClass *klass) * not recognised. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_STRICT, g_param_spec_boolean ("is-strict", "Strict?", "Should the server be strict about the query?", @@ -262,7 +262,7 @@ gdata_query_class_init (GDataQueryClass *klass) * to receive the entire feed, specify a large number such as %G_MAXUINT for this property. * * Use 0 to not specify a maximum number of results. - **/ + */ g_object_class_install_property (gobject_class, PROP_MAX_RESULTS, g_param_spec_uint ("max-results", "Maximum number of results", "The maximum number of entries to return.", @@ -279,7 +279,7 @@ gdata_query_class_init (GDataQueryClass *klass) * query, it must be set again using gdata_query_set_etag() after setting any other properties. * * Since: 0.2.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ETAG, g_param_spec_string ("etag", "ETag", "An ETag against which to check.", @@ -499,7 +499,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Creates a new #GDataQuery with its #GDataQuery:q property set to @q. * * Return value: a new #GDataQuery - **/ + */ GDataQuery * gdata_query_new (const gchar *q) { @@ -516,7 +516,7 @@ gdata_query_new (const gchar *q) * applied. * * Return value: a new #GDataQuery - **/ + */ GDataQuery * gdata_query_new_with_limits (const gchar *q, guint start_index, guint max_results) { @@ -538,7 +538,7 @@ gdata_query_new_with_limits (const gchar *q, guint start_index, guint max_result * The query URI is what functions like gdata_service_query() use to query the online service. * * Return value: a query URI; free with g_free() - **/ + */ gchar * gdata_query_get_query_uri (GDataQuery *self, const gchar *feed_uri) { @@ -613,7 +613,7 @@ _gdata_query_clear_q_internal (GDataQuery *self) * Gets the #GDataQuery:q property. * * Return value: the q property, or %NULL if it is unset - **/ + */ const gchar * gdata_query_get_q (GDataQuery *self) { @@ -629,7 +629,7 @@ gdata_query_get_q (GDataQuery *self) * Sets the #GDataQuery:q property of the #GDataQuery to the new query string, @q. * * Set @q to %NULL to unset the property in the query URI. - **/ + */ void gdata_query_set_q (GDataQuery *self, const gchar *q) { @@ -650,7 +650,7 @@ gdata_query_set_q (GDataQuery *self, const gchar *q) * Gets the #GDataQuery:categories property. * * Return value: the categories property, or %NULL if it is unset - **/ + */ const gchar * gdata_query_get_categories (GDataQuery *self) { @@ -666,7 +666,7 @@ gdata_query_get_categories (GDataQuery *self) * Sets the #GDataQuery:categories property of the #GDataQuery to the new category string, @categories. * * Set @categories to %NULL to unset the property in the query URI. - **/ + */ void gdata_query_set_categories (GDataQuery *self, const gchar *categories) { @@ -687,7 +687,7 @@ gdata_query_set_categories (GDataQuery *self, const gchar *categories) * Gets the #GDataQuery:author property. * * Return value: the author property, or %NULL if it is unset - **/ + */ const gchar * gdata_query_get_author (GDataQuery *self) { @@ -703,7 +703,7 @@ gdata_query_get_author (GDataQuery *self) * Sets the #GDataQuery:author property of the #GDataQuery to the new author string, @author. * * Set @author to %NULL to unset the property in the query URI. - **/ + */ void gdata_query_set_author (GDataQuery *self, const gchar *author) { @@ -724,7 +724,7 @@ gdata_query_set_author (GDataQuery *self, const gchar *author) * Gets the #GDataQuery:updated-min property. If the property is unset, -1 will be returned. * * Return value: the updated-min property, or -1 - **/ + */ gint64 gdata_query_get_updated_min (GDataQuery *self) { @@ -740,7 +740,7 @@ gdata_query_get_updated_min (GDataQuery *self) * Sets the #GDataQuery:updated-min property of the #GDataQuery to the new minimum update time, @updated_min. * * Set @updated_min to -1 to unset the property in the query URI. - **/ + */ void gdata_query_set_updated_min (GDataQuery *self, gint64 updated_min) { @@ -761,7 +761,7 @@ gdata_query_set_updated_min (GDataQuery *self, gint64 updated_min) * Gets the #GDataQuery:updated-max property. If the property is unset, -1 will be returned. * * Return value: the updated-max property, or -1 - **/ + */ gint64 gdata_query_get_updated_max (GDataQuery *self) { @@ -777,7 +777,7 @@ gdata_query_get_updated_max (GDataQuery *self) * Sets the #GDataQuery:updated-max property of the #GDataQuery to the new maximum update time, @updated_max. * * Set @updated_max to -1 to unset the property in the query URI. - **/ + */ void gdata_query_set_updated_max (GDataQuery *self, gint64 updated_max) { @@ -798,7 +798,7 @@ gdata_query_set_updated_max (GDataQuery *self, gint64 updated_max) * Gets the #GDataQuery:published-min property. If the property is unset, -1 will be returned. * * Return value: the published-min property, or -1 - **/ + */ gint64 gdata_query_get_published_min (GDataQuery *self) { @@ -814,7 +814,7 @@ gdata_query_get_published_min (GDataQuery *self) * Sets the #GDataQuery:published-min property of the #GDataQuery to the new minimum publish time, @published_min. * * Set @published_min to -1 to unset the property in the query URI. - **/ + */ void gdata_query_set_published_min (GDataQuery *self, gint64 published_min) { @@ -835,7 +835,7 @@ gdata_query_set_published_min (GDataQuery *self, gint64 published_min) * Gets the #GDataQuery:published-max property. If the property is unset, -1 will be returned. * * Return value: the published-max property, or -1 - **/ + */ gint64 gdata_query_get_published_max (GDataQuery *self) { @@ -851,7 +851,7 @@ gdata_query_get_published_max (GDataQuery *self) * Sets the #GDataQuery:published-max property of the #GDataQuery to the new maximum publish time, @published_max. * * Set @published_max to -1 to unset the property in the query URI. - **/ + */ void gdata_query_set_published_max (GDataQuery *self, gint64 published_max) { @@ -872,7 +872,7 @@ gdata_query_set_published_max (GDataQuery *self, gint64 published_max) * Gets the #GDataQuery:start-index property. * * Return value: the start index property, or 0 if it is unset - **/ + */ guint gdata_query_get_start_index (GDataQuery *self) { @@ -888,7 +888,7 @@ gdata_query_get_start_index (GDataQuery *self) * Sets the #GDataQuery:start-index property of the #GDataQuery to the new one-based start index, @start_index. * * Set @start_index to 0 to unset the property in the query URI. - **/ + */ void gdata_query_set_start_index (GDataQuery *self, guint start_index) { @@ -910,7 +910,7 @@ gdata_query_set_start_index (GDataQuery *self, guint start_index) * Return value: the strict property * * Since: 0.2.0 - **/ + */ gboolean gdata_query_is_strict (GDataQuery *self) { @@ -926,7 +926,7 @@ gdata_query_is_strict (GDataQuery *self) * Sets the #GDataQuery:is-strict property of the #GDataQuery to the new strict value, @is_strict. * * Since: 0.2.0 - **/ + */ void gdata_query_set_is_strict (GDataQuery *self, gboolean is_strict) { @@ -946,7 +946,7 @@ gdata_query_set_is_strict (GDataQuery *self, gboolean is_strict) * Gets the #GDataQuery:max-results property. * * Return value: the maximum results property, or 0 if it is unset - **/ + */ guint gdata_query_get_max_results (GDataQuery *self) { @@ -962,7 +962,7 @@ gdata_query_get_max_results (GDataQuery *self) * Sets the #GDataQuery:max-results property of the #GDataQuery to the new maximum results value, @max_results. * * Set @max_results to 0 to unset the property in the query URI. - **/ + */ void gdata_query_set_max_results (GDataQuery *self, guint max_results) { @@ -984,7 +984,7 @@ gdata_query_set_max_results (GDataQuery *self, guint max_results) * Return value: the ETag property, or %NULL if it is unset * * Since: 0.2.0 - **/ + */ const gchar * gdata_query_get_etag (GDataQuery *self) { @@ -1002,7 +1002,7 @@ gdata_query_get_etag (GDataQuery *self) * Set @etag to %NULL to not check against the server-side ETag. * * Since: 0.2.0 - **/ + */ void gdata_query_set_etag (GDataQuery *self, const gchar *etag) { @@ -1074,7 +1074,7 @@ _gdata_query_set_previous_uri_end (GDataQuery *self) * gdata_query_next_page() will fall back to using #GDataQuery:start-index to emulate true pagination if this fails. * * You should not implement pagination manually using #GDataQuery:start-index. - **/ + */ void gdata_query_next_page (GDataQuery *self) { @@ -1105,7 +1105,7 @@ gdata_query_next_page (GDataQuery *self) * See the documentation for gdata_query_next_page() for an explanation of how query URIs from the feeds are used to this end. * * Return value: %TRUE if there is a previous page and it has been switched to, %FALSE otherwise - **/ + */ gboolean gdata_query_previous_page (GDataQuery *self) { diff --git a/gdata/gdata-query.h b/gdata/gdata-query.h index 69bf2343..f80cc8c0 100644 --- a/gdata/gdata-query.h +++ b/gdata/gdata-query.h @@ -38,7 +38,7 @@ typedef struct _GDataQueryPrivate GDataQueryPrivate; * GDataQuery: * * All the fields in the #GDataQuery structure are private and should never be accessed directly. - **/ + */ typedef struct { GObject parent; GDataQueryPrivate *priv; @@ -48,7 +48,7 @@ typedef struct { * GDataQueryClass: * * All the fields in the #GDataQueryClass structure are private and should never be accessed directly. - **/ + */ typedef struct { /*< private >*/ GObjectClass parent; diff --git a/gdata/gdata-service.c b/gdata/gdata-service.c index 64943a5b..1e6feebe 100644 --- a/gdata/gdata-service.c +++ b/gdata/gdata-service.c @@ -135,7 +135,7 @@ gdata_service_class_init (GDataServiceClass *klass) * * Since: 0.2.0 * Deprecated: 0.15.0: Use #GDataService:proxy-resolver instead, which gives more flexibility over the proxy used. - **/ + */ g_object_class_install_property (gobject_class, PROP_PROXY_URI, g_param_spec_boxed ("proxy-uri", "Proxy URI", "The proxy URI used internally for all network requests.", @@ -153,7 +153,7 @@ gdata_service_class_init (GDataServiceClass *klass) * Note that if a #GDataAuthorizer is being used with this #GDataService, the authorizer might also need its timeout setting. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TIMEOUT, g_param_spec_uint ("timeout", "Timeout", "A timeout, in seconds, for network operations.", @@ -172,7 +172,7 @@ gdata_service_class_init (GDataServiceClass *klass) * The server-side behaviour is undefined if it doesn't support a given locale. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LOCALE, g_param_spec_string ("locale", "Locale", "The locale to use for network requests, in Unix locale format.", @@ -196,7 +196,7 @@ gdata_service_class_init (GDataServiceClass *klass) * video to YouTube does. It's an unnecessary overhead to require the user to authorize against a service when not strictly required. * * Since: 0.9.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_AUTHORIZER, g_param_spec_object ("authorizer", "Authorizer", "An authorizer object to provide an authorization token for each request.", @@ -851,7 +851,7 @@ query_thread (GSimpleAsyncResult *result, GDataService *service, GCancellable *c * to get the results of the operation. * * Since: 0.9.1 - **/ + */ void gdata_service_query_async (GDataService *self, GDataAuthorizationDomain *domain, const gchar *feed_uri, GDataQuery *query, GType entry_type, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, @@ -892,7 +892,7 @@ gdata_service_query_async (GDataService *self, GDataAuthorizationDomain *domain, * Finishes an asynchronous query operation started with gdata_service_query_async(). * * Return value: (transfer full): a #GDataFeed of query results, or %NULL; unref with g_object_unref() - **/ + */ GDataFeed * gdata_service_query_finish (GDataService *self, GAsyncResult *async_result, GError **error) { @@ -1082,7 +1082,7 @@ real_parse_feed (GDataService *self, * Return value: (transfer full): a #GDataFeed of query results, or %NULL; unref with g_object_unref() * * Since: 0.9.0 - **/ + */ GDataFeed * gdata_service_query (GDataService *self, GDataAuthorizationDomain *domain, const gchar *feed_uri, GDataQuery *query, GType entry_type, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) @@ -1119,7 +1119,7 @@ gdata_service_query (GDataService *self, GDataAuthorizationDomain *domain, const * Return value: (transfer full): a #GDataEntry, or %NULL; unref with g_object_unref() * * Since: 0.9.0 - **/ + */ GDataEntry * gdata_service_query_single_entry (GDataService *self, GDataAuthorizationDomain *domain, const gchar *entry_id, GDataQuery *query, GType entry_type, GCancellable *cancellable, GError **error) @@ -1227,7 +1227,7 @@ query_single_entry_thread (GSimpleAsyncResult *result, GDataService *service, GC * to get the results of the operation. * * Since: 0.9.0 - **/ + */ void gdata_service_query_single_entry_async (GDataService *self, GDataAuthorizationDomain *domain, const gchar *entry_id, GDataQuery *query, GType entry_type, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -1266,7 +1266,7 @@ gdata_service_query_single_entry_async (GDataService *self, GDataAuthorizationDo * Return value: (transfer full): a #GDataEntry, or %NULL; unref with g_object_unref() * * Since: 0.7.0 - **/ + */ GDataEntry * gdata_service_query_single_entry_finish (GDataService *self, GAsyncResult *async_result, GError **error) { @@ -1345,7 +1345,7 @@ insert_entry_thread (GSimpleAsyncResult *result, GDataService *service, GCancell * to get the results of the operation. * * Since: 0.9.0 - **/ + */ void gdata_service_insert_entry_async (GDataService *self, GDataAuthorizationDomain *domain, const gchar *upload_uri, GDataEntry *entry, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -1381,7 +1381,7 @@ gdata_service_insert_entry_async (GDataService *self, GDataAuthorizationDomain * * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref() * * Since: 0.3.0 - **/ + */ GDataEntry * gdata_service_insert_entry_finish (GDataService *self, GAsyncResult *async_result, GError **error) { @@ -1555,7 +1555,7 @@ update_entry_thread (GSimpleAsyncResult *result, GDataService *service, GCancell * to get the results of the operation. * * Since: 0.9.0 - **/ + */ void gdata_service_update_entry_async (GDataService *self, GDataAuthorizationDomain *domain, GDataEntry *entry, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -1589,7 +1589,7 @@ gdata_service_update_entry_async (GDataService *self, GDataAuthorizationDomain * * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref() * * Since: 0.3.0 - **/ + */ GDataEntry * gdata_service_update_entry_finish (GDataService *self, GAsyncResult *async_result, GError **error) { @@ -1637,7 +1637,7 @@ gdata_service_update_entry_finish (GDataService *self, GAsyncResult *async_resul * Return value: (transfer full): an updated #GDataEntry, or %NULL; unref with g_object_unref() * * Since: 0.9.0 - **/ + */ GDataEntry * gdata_service_update_entry (GDataService *self, GDataAuthorizationDomain *domain, GDataEntry *entry, GCancellable *cancellable, GError **error) { @@ -1757,7 +1757,7 @@ delete_entry_thread (GSimpleAsyncResult *result, GDataService *service, GCancell * to get the results of the operation. * * Since: 0.9.0 - **/ + */ void gdata_service_delete_entry_async (GDataService *self, GDataAuthorizationDomain *domain, GDataEntry *entry, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) @@ -1791,7 +1791,7 @@ gdata_service_delete_entry_async (GDataService *self, GDataAuthorizationDomain * * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.3.0 - **/ + */ gboolean gdata_service_delete_entry_finish (GDataService *self, GAsyncResult *async_result, GError **error) { @@ -1833,7 +1833,7 @@ gdata_service_delete_entry_finish (GDataService *self, GAsyncResult *async_resul * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.9.0 - **/ + */ gboolean gdata_service_delete_entry (GDataService *self, GDataAuthorizationDomain *domain, GDataEntry *entry, GCancellable *cancellable, GError **error) { @@ -1915,7 +1915,7 @@ _get_proxy_uri (GDataService *self) * * Since: 0.2.0 * Deprecated: 0.15.0: Use gdata_service_get_proxy_resolver() instead, which gives more flexibility over the proxy used. - **/ + */ SoupURI * gdata_service_get_proxy_uri (GDataService *self) { @@ -1945,7 +1945,7 @@ _set_proxy_uri (GDataService *self, SoupURI *proxy_uri) * * Since: 0.2.0 * Deprecated: 0.15.0: Use gdata_service_set_proxy_resolver() instead, which gives more flexibility over the proxy used. - **/ + */ void gdata_service_set_proxy_uri (GDataService *self, SoupURI *proxy_uri) { @@ -2012,7 +2012,7 @@ notify_timeout_cb (GObject *gobject, GParamSpec *pspec, GObject *self) * Return value: the timeout, or 0 * * Since: 0.7.0 - **/ + */ guint gdata_service_get_timeout (GDataService *self) { @@ -2037,7 +2037,7 @@ gdata_service_get_timeout (GDataService *self) * Note that if a #GDataAuthorizer is being used with this #GDataService, the authorizer might also need its timeout setting. * * Since: 0.7.0 - **/ + */ void gdata_service_set_timeout (GDataService *self, guint timeout) { @@ -2329,7 +2329,7 @@ soup_log_printer (SoupLogger *logger, SoupLoggerLogLevel level, char direction, * Return value: the log level * * Since: 0.7.0 - **/ + */ GDataLogLevel _gdata_service_get_log_level (void) { @@ -2434,7 +2434,7 @@ _gdata_service_build_session (void) * Return value: the current locale * * Since: 0.7.0 - **/ + */ const gchar * gdata_service_get_locale (GDataService *self) { @@ -2453,7 +2453,7 @@ gdata_service_get_locale (GDataService *self) * unexpectedly. The only supported use of this function is after creation of a service, but before any network requests are made. * * Since: 0.7.0 - **/ + */ void gdata_service_set_locale (GDataService *self, const gchar *locale) { diff --git a/gdata/gdata-service.h b/gdata/gdata-service.h index 84a6bde1..4b34ba59 100644 --- a/gdata/gdata-service.h +++ b/gdata/gdata-service.h @@ -44,7 +44,7 @@ G_BEGIN_DECLS * Representations of the different operations performed by the library. * * Since: 0.6.0 - **/ + */ typedef enum { GDATA_OPERATION_QUERY = 1, GDATA_OPERATION_INSERTION, @@ -76,7 +76,7 @@ typedef enum { * Try again later. (Since: 0.16.0.) * * Error codes for #GDataService operations. - **/ + */ typedef enum { GDATA_SERVICE_ERROR_UNAVAILABLE = 1, GDATA_SERVICE_ERROR_PROTOCOL_ERROR, @@ -104,7 +104,7 @@ typedef enum { * It is called in the main thread, so there is no guarantee on the order in which the callbacks are executed, * or whether they will be called in a timely manner. It is, however, guaranteed that they will all be called before * the #GAsyncReadyCallback which signals the completion of the query is called. - **/ + */ typedef void (*GDataQueryProgressCallback) (GDataEntry *entry, guint entry_key, guint entry_count, gpointer user_data); #define GDATA_TYPE_SERVICE (gdata_service_get_type ()) @@ -122,7 +122,7 @@ typedef struct _GDataServicePrivate GDataServicePrivate; * GDataService: * * All the fields in the #GDataService structure are private and should never be accessed directly. - **/ + */ typedef struct { GObject parent; GDataServicePrivate *priv; diff --git a/gdata/gdata-types.c b/gdata/gdata-types.c index ba7fd143..fd367052 100644 --- a/gdata/gdata-types.c +++ b/gdata/gdata-types.c @@ -25,7 +25,7 @@ * * The structures here are used haphazardly across the library, describing * various small data types. - **/ + */ #include #include @@ -67,7 +67,7 @@ gdata_color_get_type (void) * and bb is blue. The hash is optional. * * Return value: %TRUE on success, %FALSE otherwise - **/ + */ gboolean gdata_color_from_hexadecimal (const gchar *hexadecimal, GDataColor *color) { @@ -125,7 +125,7 @@ gdata_color_from_hexadecimal (const gchar *hexadecimal, GDataColor *color) * Return value: the color string; free with g_free() * * Since: 0.3.0 - **/ + */ gchar * gdata_color_to_hexadecimal (const GDataColor *color) { diff --git a/gdata/gdata-types.h b/gdata/gdata-types.h index 1e662435..8b7e68c2 100644 --- a/gdata/gdata-types.h +++ b/gdata/gdata-types.h @@ -32,7 +32,7 @@ G_BEGIN_DECLS * * Describes a color, such as used in the Google Calendar interface to * differentiate calendars. - **/ + */ typedef struct { /*< public >*/ guint16 red; diff --git a/gdata/gdata-upload-stream.c b/gdata/gdata-upload-stream.c index c8340be4..85807fec 100644 --- a/gdata/gdata-upload-stream.c +++ b/gdata/gdata-upload-stream.c @@ -142,7 +142,7 @@ * * * Since: 0.5.0 - **/ + */ /* * We have a network thread which does all the uploading work. We send the message encoded as chunks, but cannot use the SoupMessageBody as a @@ -270,7 +270,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The service which is used to authorize the upload, and to which the upload relates. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SERVICE, g_param_spec_object ("service", "Service", "The service which is used to authorize the upload.", @@ -297,7 +297,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The HTTP request method to use when uploading the file. * * Since: 0.7.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_METHOD, g_param_spec_string ("method", "Method", "The HTTP request method to use when uploading the file.", @@ -310,7 +310,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The URI to upload the data and metadata to. This must be HTTPS. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_UPLOAD_URI, g_param_spec_string ("upload-uri", "Upload URI", "The URI to upload the data and metadata to.", @@ -323,7 +323,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The entry used for metadata to upload. * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ENTRY, g_param_spec_object ("entry", "Entry", "The entry used for metadata to upload.", @@ -336,7 +336,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The slug of the file being uploaded. This is usually the display name of the file (i.e. as returned by g_file_info_get_display_name()). * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SLUG, g_param_spec_string ("slug", "Slug", "The slug of the file being uploaded.", @@ -365,7 +365,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The content type of the file being uploaded (i.e. as returned by g_file_info_get_content_type()). * * Since: 0.5.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT_TYPE, g_param_spec_string ("content-type", "Content type", "The content type of the file being uploaded.", @@ -386,7 +386,7 @@ gdata_upload_stream_class_init (GDataUploadStreamClass *klass) * The only way to cancel the upload operation completely is using #GDataUploadStream:cancellable. * * Since: 0.8.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CANCELLABLE, g_param_spec_object ("cancellable", "Cancellable", "An optional cancellable used to cancel the entire upload operation.", @@ -1338,7 +1338,7 @@ create_network_thread (GDataUploadStream *self, GError **error) * Return value: a new #GOutputStream, or %NULL; unref with g_object_unref() * * Since: 0.9.0 - **/ + */ GOutputStream * gdata_upload_stream_new (GDataService *service, GDataAuthorizationDomain *domain, const gchar *method, const gchar *upload_uri, GDataEntry *entry, const gchar *slug, const gchar *content_type, GCancellable *cancellable) @@ -1457,7 +1457,7 @@ gdata_upload_stream_new_resumable (GDataService *service, GDataAuthorizationDoma * Return value: the server's response to the upload, or %NULL * * Since: 0.5.0 - **/ + */ const gchar * gdata_upload_stream_get_response (GDataUploadStream *self, gssize *length) { @@ -1498,7 +1498,7 @@ gdata_upload_stream_get_response (GDataUploadStream *self, gssize *length) * Return value: (transfer none): the #GDataService used to authorize the upload * * Since: 0.5.0 - **/ + */ GDataService * gdata_upload_stream_get_service (GDataUploadStream *self) { @@ -1533,7 +1533,7 @@ gdata_upload_stream_get_authorization_domain (GDataUploadStream *self) * Return value: the HTTP request method in use * * Since: 0.7.0 - **/ + */ const gchar * gdata_upload_stream_get_method (GDataUploadStream *self) { @@ -1550,7 +1550,7 @@ gdata_upload_stream_get_method (GDataUploadStream *self) * Return value: the URI which the file is being uploaded to * * Since: 0.5.0 - **/ + */ const gchar * gdata_upload_stream_get_upload_uri (GDataUploadStream *self) { @@ -1567,7 +1567,7 @@ gdata_upload_stream_get_upload_uri (GDataUploadStream *self) * Return value: (transfer none): the entry used for metadata, or %NULL * * Since: 0.5.0 - **/ + */ GDataEntry * gdata_upload_stream_get_entry (GDataUploadStream *self) { @@ -1584,7 +1584,7 @@ gdata_upload_stream_get_entry (GDataUploadStream *self) * Return value: the slug of the file being uploaded * * Since: 0.5.0 - **/ + */ const gchar * gdata_upload_stream_get_slug (GDataUploadStream *self) { @@ -1601,7 +1601,7 @@ gdata_upload_stream_get_slug (GDataUploadStream *self) * Return value: the content type of the file being uploaded * * Since: 0.5.0 - **/ + */ const gchar * gdata_upload_stream_get_content_type (GDataUploadStream *self) { @@ -1636,7 +1636,7 @@ gdata_upload_stream_get_content_length (GDataUploadStream *self) * Return value: (transfer none): the #GCancellable for the entire upload operation * * Since: 0.8.0 - **/ + */ GCancellable * gdata_upload_stream_get_cancellable (GDataUploadStream *self) { diff --git a/gdata/gdata-upload-stream.h b/gdata/gdata-upload-stream.h index 4c8db419..36784aeb 100644 --- a/gdata/gdata-upload-stream.h +++ b/gdata/gdata-upload-stream.h @@ -70,7 +70,7 @@ typedef struct _GDataUploadStreamPrivate GDataUploadStreamPrivate; * All the fields in the #GDataUploadStream structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { GOutputStream parent; GDataUploadStreamPrivate *priv; @@ -82,7 +82,7 @@ typedef struct { * All the fields in the #GDataUploadStreamClass structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { /*< private >*/ GOutputStreamClass parent; diff --git a/gdata/georss/gdata-georss-where.c b/gdata/georss/gdata-georss-where.c index e03ab079..8673c261 100644 --- a/gdata/georss/gdata-georss-where.c +++ b/gdata/georss/gdata-georss-where.c @@ -151,7 +151,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: the latitude of this position, or %G_MAXDOUBLE if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_georss_where_get_latitude (GDataGeoRSSWhere *self) { @@ -168,7 +168,7 @@ gdata_georss_where_get_latitude (GDataGeoRSSWhere *self) * Return value: the longitude of this position, or %G_MAXDOUBLE if unknown * * Since: 0.5.0 - **/ + */ gdouble gdata_georss_where_get_longitude (GDataGeoRSSWhere *self) { @@ -187,7 +187,7 @@ gdata_georss_where_get_longitude (GDataGeoRSSWhere *self) * Set @latitude to %G_MAXDOUBLE to unset it. * * Since: 0.5.0 - **/ + */ void gdata_georss_where_set_latitude (GDataGeoRSSWhere *self, gdouble latitude) { @@ -210,7 +210,7 @@ gdata_georss_where_set_latitude (GDataGeoRSSWhere *self, gdouble latitude) * Set @longitude to %G_MAXDOUBLE to unset it. * * Since: 0.5.0 - **/ + */ void gdata_georss_where_set_longitude (GDataGeoRSSWhere *self, gdouble longitude) { diff --git a/gdata/georss/gdata-georss-where.h b/gdata/georss/gdata-georss-where.h index b735b011..a949bb0b 100644 --- a/gdata/georss/gdata-georss-where.h +++ b/gdata/georss/gdata-georss-where.h @@ -42,7 +42,7 @@ typedef struct _GDataGeoRSSWherePrivate GDataGeoRSSWherePrivate; * All the fields in the #GDataGeoRSSWhere structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { GDataParsable parent; GDataGeoRSSWherePrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataGeoRSSWhereClass structure are private and should never be accessed directly. * * Since: 0.5.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/media/gdata-media-category.c b/gdata/media/gdata-media-category.c index 66d4215d..da7e1564 100644 --- a/gdata/media/gdata-media-category.c +++ b/gdata/media/gdata-media-category.c @@ -27,7 +27,7 @@ * Media RSS specification. * * Since: 0.4.0 - **/ + */ #include #include @@ -88,7 +88,7 @@ gdata_media_category_class_init (GDataMediaCategoryClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CATEGORY, g_param_spec_string ("category", "Category", "The category name.", @@ -103,7 +103,7 @@ gdata_media_category_class_init (GDataMediaCategoryClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SCHEME, g_param_spec_string ("scheme", "Scheme", "A URI that identifies the categorization scheme.", @@ -118,7 +118,7 @@ gdata_media_category_class_init (GDataMediaCategoryClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_LABEL, g_param_spec_string ("label", "Label", "A human-readable label that can be displayed in end-user applications.", @@ -261,7 +261,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * url="http://search.yahoo.com/mrss/">Media RSS specification. * * Return value: a new #GDataMediaCategory, or %NULL; unref with g_object_unref() - **/ + */ GDataMediaCategory * gdata_media_category_new (const gchar *category, const gchar *scheme, const gchar *label) { @@ -279,7 +279,7 @@ gdata_media_category_new (const gchar *category, const gchar *scheme, const gcha * Return value: the actual category * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_category_get_category (GDataMediaCategory *self) { @@ -295,7 +295,7 @@ gdata_media_category_get_category (GDataMediaCategory *self) * Sets the #GDataMediaCategory:category property to @category. * * Since: 0.4.0 - **/ + */ void gdata_media_category_set_category (GDataMediaCategory *self, const gchar *category) { @@ -316,7 +316,7 @@ gdata_media_category_set_category (GDataMediaCategory *self, const gchar *catego * Return value: the category's scheme, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_category_get_scheme (GDataMediaCategory *self) { @@ -334,7 +334,7 @@ gdata_media_category_get_scheme (GDataMediaCategory *self) * Set @scheme to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_media_category_set_scheme (GDataMediaCategory *self, const gchar *scheme) { @@ -358,7 +358,7 @@ gdata_media_category_set_scheme (GDataMediaCategory *self, const gchar *scheme) * Return value: the category's label, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_category_get_label (GDataMediaCategory *self) { @@ -376,7 +376,7 @@ gdata_media_category_get_label (GDataMediaCategory *self) * Set @label to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_media_category_set_label (GDataMediaCategory *self, const gchar *label) { diff --git a/gdata/media/gdata-media-category.h b/gdata/media/gdata-media-category.h index d331ae5c..0715fe3f 100644 --- a/gdata/media/gdata-media-category.h +++ b/gdata/media/gdata-media-category.h @@ -40,7 +40,7 @@ typedef struct _GDataMediaCategoryPrivate GDataMediaCategoryPrivate; * GDataMediaCategory: * * All the fields in the #GDataMediaCategory structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataMediaCategoryPrivate *priv; @@ -52,7 +52,7 @@ typedef struct { * All the fields in the #GDataMediaCategoryClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/media/gdata-media-content.c b/gdata/media/gdata-media-content.c index 4180d2ea..50a35d34 100644 --- a/gdata/media/gdata-media-content.c +++ b/gdata/media/gdata-media-content.c @@ -29,7 +29,7 @@ * The class only implements parsing, not XML output, at the moment. * * Since: 0.4.0 - **/ + */ #include #include @@ -97,7 +97,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "The direct URI to the media object.", @@ -112,7 +112,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_FILESIZE, g_param_spec_ulong ("filesize", "Filesize", "The number of bytes of the media object.", @@ -127,7 +127,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CONTENT_TYPE, g_param_spec_string ("content-type", "Content type", "The standard MIME type of the object.", @@ -143,7 +143,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_MEDIUM, g_param_spec_enum ("medium", "Medium", "The type of object.", @@ -158,7 +158,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_IS_DEFAULT, g_param_spec_boolean ("is-default", "Default?", "Determines if this is the default content for the media group.", @@ -173,7 +173,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_EXPRESSION, g_param_spec_enum ("expression", "Expression", "Determines if the object is a sample or the full version of the object.", @@ -188,7 +188,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_DURATION, g_param_spec_int64 ("duration", "Duration", "The number of seconds for which the media object plays.", @@ -203,7 +203,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_HEIGHT, g_param_spec_uint ("height", "Height", "The height of the media object.", @@ -218,7 +218,7 @@ gdata_media_content_class_init (GDataMediaContentClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_WIDTH, g_param_spec_uint ("width", "Width", "The width of the media object.", @@ -390,7 +390,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: the content's URI * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_content_get_uri (GDataMediaContent *self) { @@ -407,7 +407,7 @@ gdata_media_content_get_uri (GDataMediaContent *self) * Return value: the number of bytes in the content, or 0 * * Since: 0.4.0 - **/ + */ gsize gdata_media_content_get_filesize (GDataMediaContent *self) { @@ -424,7 +424,7 @@ gdata_media_content_get_filesize (GDataMediaContent *self) * Return value: the content's content (MIME) type, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_content_get_content_type (GDataMediaContent *self) { @@ -441,7 +441,7 @@ gdata_media_content_get_content_type (GDataMediaContent *self) * Return value: the type of the content, or %GDATA_MEDIA_UNKNOWN * * Since: 0.4.0 - **/ + */ GDataMediaMedium gdata_media_content_get_medium (GDataMediaContent *self) { @@ -458,7 +458,7 @@ gdata_media_content_get_medium (GDataMediaContent *self) * Return value: %TRUE if the #GDataMediaContent is the default content for the media group, %FALSE otherwise * * Since: 0.4.0 - **/ + */ gboolean gdata_media_content_is_default (GDataMediaContent *self) { @@ -475,7 +475,7 @@ gdata_media_content_is_default (GDataMediaContent *self) * Return value: the content's expression, or %GDATA_MEDIA_EXPRESSION_FULL * * Since: 0.4.0 - **/ + */ GDataMediaExpression gdata_media_content_get_expression (GDataMediaContent *self) { @@ -492,7 +492,7 @@ gdata_media_content_get_expression (GDataMediaContent *self) * Return value: the content's duration in seconds, or 0 * * Since: 0.4.0 - **/ + */ gint64 gdata_media_content_get_duration (GDataMediaContent *self) { @@ -509,7 +509,7 @@ gdata_media_content_get_duration (GDataMediaContent *self) * Return value: the content's height in pixels, or 0 * * Since: 0.4.0 - **/ + */ guint gdata_media_content_get_height (GDataMediaContent *self) { @@ -526,7 +526,7 @@ gdata_media_content_get_height (GDataMediaContent *self) * Return value: the content's width in pixels, or 0 * * Since: 0.4.0 - **/ + */ guint gdata_media_content_get_width (GDataMediaContent *self) { @@ -554,7 +554,7 @@ gdata_media_content_get_width (GDataMediaContent *self) * Return value: (transfer full): a #GDataDownloadStream to download the content with, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDownloadStream * gdata_media_content_download (GDataMediaContent *self, GDataService *service, GCancellable *cancellable, GError **error) { diff --git a/gdata/media/gdata-media-content.h b/gdata/media/gdata-media-content.h index adce38ac..c7c49544 100644 --- a/gdata/media/gdata-media-content.h +++ b/gdata/media/gdata-media-content.h @@ -36,7 +36,7 @@ G_BEGIN_DECLS * @GDATA_MEDIA_EXPRESSION_NONSTOP: the media is a continuous stream * * An enum representing the possible values of #GDataMediaContent:expression. - **/ + */ typedef enum { GDATA_MEDIA_EXPRESSION_SAMPLE, GDATA_MEDIA_EXPRESSION_FULL, @@ -55,7 +55,7 @@ typedef enum { * An enum representing the possible values of #GDataMediaContent:medium. * * Since: 0.4.0 - **/ + */ typedef enum { GDATA_MEDIA_UNKNOWN, GDATA_MEDIA_IMAGE, @@ -78,7 +78,7 @@ typedef struct _GDataMediaContentPrivate GDataMediaContentPrivate; * GDataMediaContent: * * All the fields in the #GDataMediaContent structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataMediaContentPrivate *priv; @@ -90,7 +90,7 @@ typedef struct { * All the fields in the #GDataMediaContentClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/media/gdata-media-credit.c b/gdata/media/gdata-media-credit.c index 896693b9..de206779 100644 --- a/gdata/media/gdata-media-credit.c +++ b/gdata/media/gdata-media-credit.c @@ -29,7 +29,7 @@ * The class only implements parsing, not XML output, at the moment. * * Since: 0.4.0 - **/ + */ #include #include @@ -84,7 +84,7 @@ gdata_media_credit_class_init (GDataMediaCreditClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_CREDIT, g_param_spec_string ("credit", "Credit", "The credited entity's name.", @@ -99,7 +99,7 @@ gdata_media_credit_class_init (GDataMediaCreditClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_SCHEME, g_param_spec_string ("scheme", "Scheme", "A URI that identifies the role scheme.", @@ -114,7 +114,7 @@ gdata_media_credit_class_init (GDataMediaCreditClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_ROLE, g_param_spec_string ("role", "Role", "The role the credited entity played in the production of the media.", @@ -225,7 +225,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: the name of the credited entity * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_credit_get_credit (GDataMediaCredit *self) { @@ -242,7 +242,7 @@ gdata_media_credit_get_credit (GDataMediaCredit *self) * Return value: the credit's role scheme, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_credit_get_scheme (GDataMediaCredit *self) { @@ -259,7 +259,7 @@ gdata_media_credit_get_scheme (GDataMediaCredit *self) * Return value: the credited entity's role, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_credit_get_role (GDataMediaCredit *self) { diff --git a/gdata/media/gdata-media-credit.h b/gdata/media/gdata-media-credit.h index a44d925b..a8b054ec 100644 --- a/gdata/media/gdata-media-credit.h +++ b/gdata/media/gdata-media-credit.h @@ -40,7 +40,7 @@ typedef struct _GDataMediaCreditPrivate GDataMediaCreditPrivate; * GDataMediaCredit: * * All the fields in the #GDataMediaCredit structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataMediaCreditPrivate *priv; @@ -52,7 +52,7 @@ typedef struct { * All the fields in the #GDataMediaCreditClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/media/gdata-media-group.c b/gdata/media/gdata-media-group.c index 42d628bf..1ab5be71 100644 --- a/gdata/media/gdata-media-group.c +++ b/gdata/media/gdata-media-group.c @@ -368,7 +368,7 @@ get_namespaces (GDataParsable *parsable, GHashTable *namespaces) * Return value: the group's title, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_group_get_title (GDataMediaGroup *self) { @@ -386,7 +386,7 @@ gdata_media_group_get_title (GDataMediaGroup *self) * Set @title to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_media_group_set_title (GDataMediaGroup *self, const gchar *title) { @@ -404,7 +404,7 @@ gdata_media_group_set_title (GDataMediaGroup *self, const gchar *title) * Return value: the group's description, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_group_get_description (GDataMediaGroup *self) { @@ -422,7 +422,7 @@ gdata_media_group_get_description (GDataMediaGroup *self) * Set @description to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_media_group_set_description (GDataMediaGroup *self, const gchar *description) { @@ -440,7 +440,7 @@ gdata_media_group_set_description (GDataMediaGroup *self, const gchar *descripti * Return value: (array zero-terminated=1): a %NULL-terminated array of the group's keywords, or %NULL * * Since: 0.4.0 - **/ + */ const gchar * const * gdata_media_group_get_keywords (GDataMediaGroup *self) { @@ -458,7 +458,7 @@ gdata_media_group_get_keywords (GDataMediaGroup *self) * Set @keywords to %NULL to unset the property. * * Since: 0.4.0 - **/ + */ void gdata_media_group_set_keywords (GDataMediaGroup *self, const gchar * const *keywords) { @@ -474,7 +474,7 @@ gdata_media_group_set_keywords (GDataMediaGroup *self, const gchar * const *keyw * Gets the #GDataMediaGroup:category property. * * Return value: a #GDataMediaCategory giving the group's category, or %NULL - **/ + */ GDataMediaCategory * gdata_media_group_get_category (GDataMediaGroup *self) { @@ -488,7 +488,7 @@ gdata_media_group_get_category (GDataMediaGroup *self) * @category: (allow-none): a new #GDataMediaCategory, or %NULL * * Sets the #GDataMediaGroup:category property to @category, and increments its reference count. - **/ + */ void gdata_media_group_set_category (GDataMediaGroup *self, GDataMediaCategory *category) { @@ -515,7 +515,7 @@ content_compare_cb (const GDataMediaContent *content, const gchar *type) * a list of URIs to various formats of the group content itself, such as the SWF URI or RTSP stream for a video. * * Return value: (transfer none): a #GDataMediaContent matching @type, or %NULL - **/ + */ GDataMediaContent * gdata_media_group_look_up_content (GDataMediaGroup *self, const gchar *type) { @@ -538,7 +538,7 @@ gdata_media_group_look_up_content (GDataMediaGroup *self, const gchar *type) * Returns a list of #GDataMediaContents, giving the content enclosed by the group. * * Return value: (element-type GData.MediaContent) (transfer none): a #GList of #GDataMediaContents, or %NULL - **/ + */ GList * gdata_media_group_get_contents (GDataMediaGroup *self) { @@ -561,7 +561,7 @@ _gdata_media_group_add_content (GDataMediaGroup *self, GDataMediaContent *conten * Gets the #GDataMediaGroup:credit property. * * Return value: a #GDataMediaCredit giving information on whom to credit for the media group, or %NULL - **/ + */ GDataMediaCredit * gdata_media_group_get_credit (GDataMediaGroup *self) { @@ -587,7 +587,7 @@ _gdata_media_group_set_credit (GDataMediaGroup *self, GDataMediaCredit *credit) * Gets the #GDataMediaGroup:player-uri property. * * Return value: a URI where the media group is playable in a web browser, or %NULL - **/ + */ const gchar * gdata_media_group_get_player_uri (GDataMediaGroup *self) { @@ -604,7 +604,7 @@ gdata_media_group_get_player_uri (GDataMediaGroup *self) * The return value from this function is purely informational, and no obligation is assumed. * * Return value: %TRUE if the media is restricted in @country, %FALSE otherwise - **/ + */ gboolean gdata_media_group_is_restricted_in_country (GDataMediaGroup *self, const gchar *country) { @@ -656,7 +656,7 @@ gdata_media_group_get_media_rating (GDataMediaGroup *self, const gchar *rating_t * Gets a list of the thumbnails available for the group. * * Return value: (element-type GData.MediaThumbnail) (transfer none): a #GList of #GDataMediaThumbnails, or %NULL - **/ + */ GList * gdata_media_group_get_thumbnails (GDataMediaGroup *self) { diff --git a/gdata/media/gdata-media-group.h b/gdata/media/gdata-media-group.h index b1942d7d..0845ba15 100644 --- a/gdata/media/gdata-media-group.h +++ b/gdata/media/gdata-media-group.h @@ -44,7 +44,7 @@ typedef struct _GDataMediaGroupPrivate GDataMediaGroupPrivate; * GDataMediaGroup: * * All the fields in the #GDataMediaGroup structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataMediaGroupPrivate *priv; @@ -56,7 +56,7 @@ typedef struct { * All the fields in the #GDataMediaGroupClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; diff --git a/gdata/media/gdata-media-thumbnail.c b/gdata/media/gdata-media-thumbnail.c index e358bbe4..e8b48066 100644 --- a/gdata/media/gdata-media-thumbnail.c +++ b/gdata/media/gdata-media-thumbnail.c @@ -27,7 +27,7 @@ * Media RSS specification. * * The class only implements parsing, not XML output, at the moment. - **/ + */ #include #include @@ -88,7 +88,7 @@ gdata_media_thumbnail_class_init (GDataMediaThumbnailClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_URI, g_param_spec_string ("uri", "URI", "The URI of the thumbnail.", @@ -103,7 +103,7 @@ gdata_media_thumbnail_class_init (GDataMediaThumbnailClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_HEIGHT, g_param_spec_uint ("height", "Height", "The height of the thumbnail, in pixels.", @@ -118,7 +118,7 @@ gdata_media_thumbnail_class_init (GDataMediaThumbnailClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_WIDTH, g_param_spec_uint ("width", "Width", "The width of the thumbnail, in pixels.", @@ -133,7 +133,7 @@ gdata_media_thumbnail_class_init (GDataMediaThumbnailClass *klass) * For more information, see the Media RSS specification. * * Since: 0.4.0 - **/ + */ g_object_class_install_property (gobject_class, PROP_TIME, g_param_spec_int64 ("time", "Time", "The time offset of the thumbnail in relation to the media object, in ms.", @@ -227,7 +227,7 @@ parse_time (const gchar *time_string) * of a media stream. * * Return value: an NTP-format string describing @_time; free with g_free() - **/ + */ /*static gchar * build_time (gint64 _time) { @@ -336,7 +336,7 @@ parse_json (GDataParsable *parsable, JsonReader *reader, gpointer user_data, * Return value: the thumbnail's URI * * Since: 0.4.0 - **/ + */ const gchar * gdata_media_thumbnail_get_uri (GDataMediaThumbnail *self) { @@ -353,7 +353,7 @@ gdata_media_thumbnail_get_uri (GDataMediaThumbnail *self) * Return value: the thumbnail's height in pixels, or 0 * * Since: 0.4.0 - **/ + */ guint gdata_media_thumbnail_get_height (GDataMediaThumbnail *self) { @@ -370,7 +370,7 @@ gdata_media_thumbnail_get_height (GDataMediaThumbnail *self) * Return value: the thumbnail's width in pixels, or 0 * * Since: 0.4.0 - **/ + */ guint gdata_media_thumbnail_get_width (GDataMediaThumbnail *self) { @@ -387,7 +387,7 @@ gdata_media_thumbnail_get_width (GDataMediaThumbnail *self) * Return value: the thumbnail's time offset in the media, or -1 * * Since: 0.4.0 - **/ + */ gint64 gdata_media_thumbnail_get_time (GDataMediaThumbnail *self) { @@ -415,7 +415,7 @@ gdata_media_thumbnail_get_time (GDataMediaThumbnail *self) * Return value: (transfer full): a #GDataDownloadStream to download the thumbnail with, or %NULL; unref with g_object_unref() * * Since: 0.8.0 - **/ + */ GDataDownloadStream * gdata_media_thumbnail_download (GDataMediaThumbnail *self, GDataService *service, GCancellable *cancellable, GError **error) { diff --git a/gdata/media/gdata-media-thumbnail.h b/gdata/media/gdata-media-thumbnail.h index f60f663b..ee05c10a 100644 --- a/gdata/media/gdata-media-thumbnail.h +++ b/gdata/media/gdata-media-thumbnail.h @@ -42,7 +42,7 @@ typedef struct _GDataMediaThumbnailPrivate GDataMediaThumbnailPrivate; * GDataMediaThumbnail: * * All the fields in the #GDataMediaThumbnail structure are private and should never be accessed directly. - **/ + */ typedef struct { GDataParsable parent; GDataMediaThumbnailPrivate *priv; @@ -54,7 +54,7 @@ typedef struct { * All the fields in the #GDataMediaThumbnailClass structure are private and should never be accessed directly. * * Since: 0.4.0 - **/ + */ typedef struct { /*< private >*/ GDataParsableClass parent; 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); * * - **/ + */ #include #include @@ -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: reference. - **/ + */ 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 * 0. - **/ + */ 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 0. - **/ + */ 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 -1 * Deprecated: 0.17.2: Unsupported by the online API any more. There is no * replacement; this will always return -1. - **/ + */ 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); * * - **/ + */ #include #include @@ -181,7 +181,7 @@ gdata_calendar_event_class_init (GDataCalendarEventClass *klass) * * For more information, see the * Atom Publishing Protocol specification. - **/ + */ 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. * * 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 * GData specification. - **/ + */ 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 * GData specification. - **/ + */ 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 RFC 2445. - **/ + */ 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 RFC 2445. - **/ + */ 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 * * GData specification. - **/ + */ 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 GData specification. - **/ + */ 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 * * GData specification. - **/ + */ 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, -1 will be returned. * * Return value: the UNIX timestamp for the time the event was last edited, or -1 - **/ + */ 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 0 * * 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 #GDataGDWhos, 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 #GDataGDWheres, 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 #GDataGDWhens, 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 #include @@ -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); * * - **/ + */ #include #include @@ -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 lastmodified and * starttime. - **/ + */ 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 ascending and * descending. - **/ + */ 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 1970-01-01. - **/ + */ 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 2031-01-01. - **/ + */ 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, -1 will be returned. * * Return value: the UNIX timestamp for the recurrence-expansion-start property, or -1 - **/ + */ 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 -1 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, -1 will be returned. * * Return value: the UNIX timestamp for the recurrence-expansion-end property, or -1 - **/ + */ 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 -1 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, -1 will be returned. * * Return value: the UNIX timestamp for the start-min property, or -1 - **/ + */ 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 -1 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, -1 will be returned. * * Return value: the UNIX timestamp for the start-max property, or -1 - **/ + */ 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 -1 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 #include @@ -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 @@ * * * Since: 0.2.0 - **/ + */ #include #include @@ -267,7 +267,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Atom Publishing Protocol specification. * * 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 -1 * * 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 #GDataGDEmailAddresses, 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 #GDataGDIMAddresses, 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 #GDataGDPhoneNumbers, 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 #GDataGDPostalAddresses, 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 #GDataGDOrganizations, 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 #GDataGContactJots, 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 #GDataGContactRelations, 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 #GDataGContactWebsites, 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 #GDataGContactEvents, 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 #GDataGContactCalendars, 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 #GDataGContactExternalIDs, 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 #GDataGContactLanguages, 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 @@ * * * Since: 0.7.0 - **/ + */ #include #include @@ -161,7 +161,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * Atom Publishing Protocol specification. * * 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 -1 * * 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 @@ * * * Since: 0.2.0 - **/ + */ #include #include @@ -126,7 +126,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * Sorting criterion. The only supported value is lastmodified. * * 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 ascending or descending. * * 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 @@ * * * Since: 0.2.0 - **/ + */ #include #include @@ -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 @@ * * * Since: 0.7.0 - **/ + */ #include #include @@ -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 @@ * online documentation. * * Since: 0.13.1 - **/ + */ #include #include @@ -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. * * Since: 0.13.1 - **/ + */ #define GDATA_DOCUMENTS_DRAWING_PDF "pdf" /** @@ -65,7 +65,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.13.1 - **/ + */ #define GDATA_DOCUMENTS_DRAWING_PNG "png" /** @@ -78,7 +78,7 @@ G_BEGIN_DECLS * GData protocol specification. * * 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 @@ * * * Since: 0.4.0 - **/ + */ #include #include @@ -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 -1 * * 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 #include 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 @@ * * * Since: 0.4.0 - **/ + */ #include #include @@ -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 @@ * online documentation. * * Since: 0.13.3 - **/ + */ #include #include @@ -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 @@ * online documentation. * * Since: 0.4.0 - **/ + */ #include #include @@ -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. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_PRESENTATION_PDF "pdf" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_PRESENTATION_PNG "png" /** @@ -63,7 +63,7 @@ G_BEGIN_DECLS * GData protocol specification. * * 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. * * 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 @@ * * * Since: 0.4.0 - **/ + */ #include #include @@ -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 @@ * * * Since: 0.4.0 - **/ + */ #include #include @@ -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 @@ * * * Since: 0.4.0 - **/ + */ #include #include @@ -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. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_CSV "csv" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_ODS "ods" /** @@ -63,7 +63,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_PDF "pdf" /** @@ -76,7 +76,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_TSV "tsv" /** @@ -89,7 +89,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_SPREADSHEET_XLS "xls" /** @@ -102,7 +102,7 @@ G_BEGIN_DECLS * GData protocol specification. * * 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 @@ * online documentation. * * Since: 0.4.0 - **/ + */ #include #include @@ -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. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_DOC "doc" /** @@ -50,7 +50,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_HTML "html" /** @@ -76,7 +76,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_ODT "odt" /** @@ -89,7 +89,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_PDF "pdf" /** @@ -102,7 +102,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_PNG "png" /** @@ -115,7 +115,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_RTF "rtf" /** @@ -128,7 +128,7 @@ G_BEGIN_DECLS * GData protocol specification. * * Since: 0.7.0 - **/ + */ #define GDATA_DOCUMENTS_TEXT_TXT "txt" /** @@ -141,7 +141,7 @@ G_BEGIN_DECLS * GData protocol specification. * * 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. * * 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 @@ * * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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 -1 * * 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 -1 * * 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 -1 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 -1 * * 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 #GDataMediaThumbnails, 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 * online documentation. * * 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 #include 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 @@ * * * Since: 0.4.0 - **/ + */ #include #include @@ -216,7 +216,7 @@ gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass) * gphoto specification. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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. * * 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 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. * * 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. * * 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. * * 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. * * 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 -1 * * 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 -1 * * 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 -1, 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 #GDataMediaThumbnails, 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 -1 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 0 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 -1 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 0 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 -1 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. * * Since: 0.4.0 - **/ + */ #include #include @@ -98,7 +98,7 @@ gdata_picasaweb_query_class_init (GDataPicasaWebQueryClass *klass) * online documentation. * * 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) * online documentation. * * 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) * online documentation. * * 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 0 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 0 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 #include @@ -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 #include @@ -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 -1 * * 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 -1 * * 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 -1 * * 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. * * Since: 0.7.0 - **/ + */ #include #include @@ -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 #include @@ -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 #include @@ -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. * * Since: 0.3.0 - **/ + */ #include #include @@ -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. * * 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. * * 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. * * 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. * * 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 * online documentation. * * 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); * * - **/ + */ #include #include @@ -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 * online * documentation. - **/ + */ typedef enum { GDATA_YOUTUBE_TOP_RATED_FEED, GDATA_YOUTUBE_TOP_FAVORITES_FEED, @@ -101,7 +101,7 @@ typedef enum { * https://www.youtube.com/create_channel * * 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 @@ * YouTube namespace. * * Since: 0.4.0 - **/ + */ #include @@ -78,7 +78,7 @@ gdata_youtube_state_class_init (GDataYouTubeStateClass *klass) * online documentation. * * 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) * online documentation. * * 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) * online documentation. * * 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) * online documentation. * * 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); * * - **/ + */ #include #include @@ -191,7 +191,7 @@ gdata_youtube_video_class_init (GDataYouTubeVideoClass *klass) * * For more information, see the online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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. * * 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 online documentation. - **/ + */ 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. * * 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. * * 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. * * 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 online documentation. - **/ + */ 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 online documentation. - **/ + */ 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 #GDataMediaThumbnails, 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 0 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, -1 will be returned. * * Return value: the UNIX timestamp for the time the video was uploaded, or -1 - **/ + */ 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. * * 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 -1 * * 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 -1 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. * * 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; -- cgit v1.2.1