diff options
| -rw-r--r-- | rest/oauth-proxy.c | 13 | ||||
| -rw-r--r-- | rest/rest-param.c | 15 | ||||
| -rw-r--r-- | rest/rest-params.c | 2 | ||||
| -rw-r--r-- | rest/rest-proxy-call.c | 6 | ||||
| -rw-r--r-- | rest/rest-proxy-call.h | 4 | ||||
| -rw-r--r-- | 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) |