[librest] assorted introspection fixes

[Evan Nemerson <evann src gnome org>]

commit 8ea1394b7bf9338ad0a8f504920e43698afb97d3
Author: Evan Nemerson <evan coeus-group com>
Date:   Thu May 3 18:36:46 2012 -0700

    assorted introspection fixes
    
    Fixes: https://bugzilla.gnome.org/show_bug.cgi?id=675213

 rest/oauth-proxy.c     |   13 +++++++++++++
 rest/rest-param.c      |   15 +++++++++------
 rest/rest-params.c     |    2 +-
 rest/rest-proxy-call.c |    6 +++---
 rest/rest-proxy-call.h |    4 ++--
 rest/rest-proxy.c      |    2 +-
 6 files changed, 29 insertions(+), 13 deletions(-)
---
diff --git a/rest/oauth-proxy.c b/rest/oauth-proxy.c
index 076ce8c..389742a 100644
--- a/rest/oauth-proxy.c
+++ b/rest/oauth-proxy.c
@@ -756,6 +756,19 @@ oauth_proxy_set_signature_host (OAuthProxy *proxy,
   priv->signature_host = g_strdup (signature_host);
 }
 
+/**
+ * oauth_proxy_new_echo_proxy:
+ * @proxy: an #OAuthProxy
+ * @service_url: the service URL
+ * @url_format: the URL format
+ * @binding_required: whether a binding is required
+ *
+ * Create a new <ulink
+ * url="http://www.scribd.com/doc/26707268/OAuth-Echo-Identity-Veri%EF%AC%81cation-Delegation-Draft";>OAuth
+ * Echo</ulink> proxy.
+ *
+ * Returns: (transfer full): a new OAuth Echo proxy
+ */
 RestProxy *
 oauth_proxy_new_echo_proxy (OAuthProxy  *proxy,
                             /* TODO: should this be a function on the base url? */
diff --git a/rest/rest-param.c b/rest/rest-param.c
index 7a4f25d..c71afc6 100644
--- a/rest/rest-param.c
+++ b/rest/rest-param.c
@@ -58,7 +58,8 @@ G_DEFINE_BOXED_TYPE (RestParam, rest_param, rest_param_ref, rest_param_unref)
  * rest_param_new_full:
  * @name: the parameter name
  * @use: the #RestMemoryUse describing how the memory can be used
- * @data: a pointer to the start of the data
+ * @data: (array length=length) (element-type guint8): a pointer to
+ *   the start of the data
  * @length: the length of the data
  * @content_type: the content type of the data
  * @filename: the original filename, or %NULL
@@ -109,12 +110,14 @@ rest_param_new_full (const char    *name,
 /**
  * rest_param_new_with_owner:
  * @name: the parameter name
- * @data: a pointer to the start of the data
+ * @data: (array length=length) (element-type guint8): a pointer to
+ *   the start of the data
  * @length: the length of the data
  * @content_type: the content type of the data
- * @filename: the original filename, or %NULL
- * @owner: pointer to an object that owns @data
- * @owner_dnotify: a function to free/unref @owner when the buffer is freed
+ * @filename: (allow-none): the original filename, or %NULL
+ * @owner: (transfer full): pointer to an object that owns @data
+ * @owner_dnotify: (allow-none): a function to free/unref @owner when
+ *   the buffer is freed
  *
  * Create a new #RestParam called @name with @length bytes of @data as the
  * value.  @content_type is the type of the data as a MIME type, for example
@@ -260,7 +263,7 @@ rest_param_is_string (RestParam *param)
  * Get the content of @param.  The content should be treated as read-only and
  * not modified in any way.
  *
- * Returns: the content.
+ * Returns: (transfer none): the content.
  **/
 gconstpointer
 rest_param_get_content (RestParam *param)
diff --git a/rest/rest-params.c b/rest/rest-params.c
index 38c1554..a5666fa 100644
--- a/rest/rest-params.c
+++ b/rest/rest-params.c
@@ -170,7 +170,7 @@ rest_params_are_strings (RestParams *params)
  * The values are owned by the #RestParams, so don't destroy the #RestParams
  * before the hash table.
  *
- * Returns: a new #GHashTable.
+ * Returns: (element-type utf8 Rest.Param) (transfer container): a new #GHashTable.
  **/
 GHashTable *
 rest_params_as_string_hash_table (RestParams *params)
diff --git a/rest/rest-proxy-call.c b/rest/rest-proxy-call.c
index e175baa..4af8dbc 100644
--- a/rest/rest-proxy-call.c
+++ b/rest/rest-proxy-call.c
@@ -1390,9 +1390,9 @@ rest_proxy_call_lookup_response_header (RestProxyCall *call,
  * rest_proxy_call_get_response_headers:
  * @call: The #RestProxyCall
  *
- * Returns:  pointer to a hash table of headers. This hash table must not be
- * changed. You should call g_hash_table_unref() when you have finished with
- * it.
+ * Returns: (transfer container): pointer to a hash table of
+ * headers. This hash table must not be changed. You should call
+ * g_hash_table_unref() when you have finished with it.
  */
 GHashTable *
 rest_proxy_call_get_response_headers (RestProxyCall *call)
diff --git a/rest/rest-proxy-call.h b/rest/rest-proxy-call.h
index b2603f9..1e96afd 100644
--- a/rest/rest-proxy-call.h
+++ b/rest/rest-proxy-call.h
@@ -179,7 +179,7 @@ typedef void (*RestProxyCallContinuousCallback) (RestProxyCall *call,
                                                  gpointer       userdata);
 
 gboolean rest_proxy_call_continuous (RestProxyCall                    *call,
-                                     RestProxyCallContinuousCallback   cb,
+                                     RestProxyCallContinuousCallback   callback,
                                      GObject                          *weak_object,
                                      gpointer                          userdata,
                                      GError                          **error);
@@ -192,7 +192,7 @@ typedef void (*RestProxyCallUploadCallback) (RestProxyCall *call,
                                              gpointer       userdata);
 
 gboolean rest_proxy_call_upload (RestProxyCall                *call,
-                                 RestProxyCallUploadCallback   cb,
+                                 RestProxyCallUploadCallback   callback,
                                  GObject                      *weak_object,
                                  gpointer                      userdata,
                                  GError                      **error);
diff --git a/rest/rest-proxy.c b/rest/rest-proxy.c
index a84a53e..4ac8375 100644
--- a/rest/rest-proxy.c
+++ b/rest/rest-proxy.c
@@ -467,7 +467,7 @@ _rest_proxy_new_call (RestProxy *proxy)
  * Create a new #RestProxyCall for making a call to the web service.  This call
  * is one-shot and should not be re-used for making multiple calls.
  *
- * Returns: a new #RestProxyCall.
+ * Returns: (transfer full): a new #RestProxyCall.
  */
 RestProxyCall *
 rest_proxy_new_call (RestProxy *proxy)