[libgdata/libgdata-0-6] introspection: Add missing annotations to GDataService

[Philip Withnall <pwithnall src gnome org>]

commit d2e9651352833fa5ccebaba727ad9bd13b530f4b
Author: Philip Withnall <philip tecnocode co uk>
Date:   Mon Aug 2 22:22:17 2010 +0100

    introspection: Add missing annotations to GDataService

 gdata/gdata-service.c |   18 +++++++++---------
 1 files changed, 9 insertions(+), 9 deletions(-)
---
diff --git a/gdata/gdata-service.c b/gdata/gdata-service.c
index 3445b95..d64ece1 100644
--- a/gdata/gdata-service.c
+++ b/gdata/gdata-service.c
@@ -185,7 +185,7 @@ gdata_service_class_init (GDataServiceClass *klass)
 	 * program should display this to the user, and return their response (the text displayed in the
 	 * image). There is no timeout imposed by the library for the response.
 	 *
-	 * Return value: the text in the CAPTCHA image
+	 * Return value: a newly allocated string containing the text in the CAPTCHA image
 	 **/
 	service_signals[SIGNAL_CAPTCHA_CHALLENGE] = g_signal_new ("captcha-challenge",
 				G_TYPE_FROM_CLASS (klass),
@@ -801,9 +801,9 @@ general_error:
  * Other #GDataAuthenticationError errors can be returned for other conditions.
  *
  * If the service requires a CAPTCHA to be completed, the #GDataService::captcha-challenge signal will be emitted. The return value from
- * a signal handler for the signal should be the text from the image. If the text is %NULL or empty, authentication will fail with a
- * %GDATA_AUTHENTICATION_ERROR_CAPTCHA_REQUIRED error. Otherwise, authentication will be automatically and transparently restarted with
- * the new CAPTCHA details.
+ * a signal handler for the signal should be a newly allocated string containing the text from the image. If the text is %NULL or empty,
+ * authentication will fail with a %GDATA_AUTHENTICATION_ERROR_CAPTCHA_REQUIRED error. Otherwise, authentication will be automatically and
+ * transparently restarted with the new CAPTCHA details.
  *
  * A %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be returned if the server's responses were invalid. Subclasses of #GDataService can override
  * parsing the authentication response, and may return their own error codes. See their documentation for more details.
@@ -906,10 +906,10 @@ query_thread (GSimpleAsyncResult *result, GDataService *service, GCancellable *c
  * gdata_service_query_async:
  * @self: a #GDataService
  * @feed_uri: the feed URI to query, including the host name and protocol
- * @query: a #GDataQuery with the query parameters, or %NULL
+ * @query: (allow-none): a #GDataQuery with the query parameters, or %NULL
  * @entry_type: a #GType for the #GDataEntry<!-- -->s to build from the XML
  * @cancellable: optional #GCancellable object, or %NULL
- * @progress_callback: a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL
+ * @progress_callback: (scope async): a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL
  * @progress_user_data: (closure): data to pass to the @progress_callback function
  * @callback: a #GAsyncReadyCallback to call when the query is finished
  * @user_data: (closure): data to pass to the @callback function
@@ -1034,7 +1034,7 @@ _gdata_service_query (GDataService *self, const gchar *feed_uri, GDataQuery *que
  * gdata_service_query:
  * @self: a #GDataService
  * @feed_uri: the feed URI to query, including the host name and protocol
- * @query: a #GDataQuery with the query parameters, or %NULL
+ * @query: (allow-none): a #GDataQuery with the query parameters, or %NULL
  * @entry_type: a #GType for the #GDataEntry<!-- -->s to build from the XML
  * @cancellable: optional #GCancellable object, or %NULL
  * @progress_callback: a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL
@@ -1654,7 +1654,7 @@ notify_proxy_uri_cb (GObject *gobject, GParamSpec *pspec, GObject *self)
  *
  * Gets the proxy URI on the #GDataService's #SoupSession.
  *
- * Return value: the proxy URI, or %NULL
+ * Return value: (transfer none): the proxy URI, or %NULL
  *
  * Since: 0.2.0
  **/
@@ -1674,7 +1674,7 @@ gdata_service_get_proxy_uri (GDataService *self)
 /**
  * gdata_service_set_proxy_uri:
  * @self: a #GDataService
- * @proxy_uri: the proxy URI
+ * @proxy_uri: (allow-none): the proxy URI, or %NULL
  *
  * Sets the proxy URI on the #SoupSession used internally by the given #GDataService.
  * This forces all requests through the given proxy.