[librest/wip/baedert/fixes: 4/7] RestProxyCall: Add documentation for _sync

[Timm Bäder <baedert src gnome org>]

commit f4ff5d82271729569919761377433ff49d2e4a27
Author: Timm Bäder <mail baedert org>
Date:   Mon Jul 18 10:35:33 2016 +0200

    RestProxyCall: Add documentation for _sync

 rest/rest-proxy-call.c |   18 ++++++++++++++++--
 1 files changed, 16 insertions(+), 2 deletions(-)
---
diff --git a/rest/rest-proxy-call.c b/rest/rest-proxy-call.c
index 9384b5b..348b7f2 100644
--- a/rest/rest-proxy-call.c
+++ b/rest/rest-proxy-call.c
@@ -1212,9 +1212,23 @@ rest_proxy_call_cancel (RestProxyCall *call)
   return TRUE;
 }
 
+/**
+ * rest_proxy_call_sync:
+ * @call: a #RestProxycall
+ * @error_out: a #GError or %NULL
+ *
+ * Synchronously invokes @call. After this function has returned,
+ * rest_proxy_call_get_payload() will return the result of this call.
+ *
+ * Note that this will block an undefined amount of time, so
+ * rest_proxy_call_invoke_async() is generally recommended.
+ *
+ * Returns: %TRUE on success, %FALSE if a failure occurred,
+ *   in which case @error_out will be set.
+ */
 gboolean
-rest_proxy_call_sync (RestProxyCall *call,
-                      GError       **error_out)
+rest_proxy_call_sync (RestProxyCall  *call,
+                      GError        **error_out)
 {
   RestProxyCallPrivate *priv = GET_PRIVATE (call);
   SoupMessage *message;