diff options
Diffstat (limited to 'gdata/gdata-query.c')
| -rw-r--r-- | gdata/gdata-query.c | 78 |
1 files changed, 39 insertions, 39 deletions
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 <ulink type="http" * url="http://code.google.com/apis/gdata/docs/2.0/reference.html#Queries">online documentation</ulink>. - **/ + */ #include <glib.h> #include <string.h> @@ -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: <userinput>"Elizabeth Bennet" Darcy -Austen</userinput>. - **/ + */ 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: <userinput>A|-{urn:google.com}B/-C</userinput> 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 <code class="literal">0</code> 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 <code class="literal">0</code> 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, <code class="literal">-1</code> will be returned. * * Return value: the updated-min property, or <code class="literal">-1</code> - **/ + */ 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 <code class="literal">-1</code> 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, <code class="literal">-1</code> will be returned. * * Return value: the updated-max property, or <code class="literal">-1</code> - **/ + */ 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 <code class="literal">-1</code> 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, <code class="literal">-1</code> will be returned. * * Return value: the published-min property, or <code class="literal">-1</code> - **/ + */ 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 <code class="literal">-1</code> 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, <code class="literal">-1</code> will be returned. * * Return value: the published-max property, or <code class="literal">-1</code> - **/ + */ 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 <code class="literal">-1</code> 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 <code class="literal">0</code> 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 <code class="literal">0</code> 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 <code class="literal">0</code> 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 <code class="literal">0</code> 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 <emphasis>should not</emphasis> 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) { |