[next] telepathy-glib: document TpProxyWrapperFunc

[Simon McVittie]

Module: telepathy-glib
Branch: next
Commit: 46c59bb915f360a5ae256c1e5aa2199058efcde0
URL:    http://cgit.freedesktop.org/telepathy/telepathy-glib/commit/?id=46c59bb915f360a5ae256c1e5aa2199058efcde0

Author: Simon McVittie <simon.mcvittie at collabora.co.uk>
Date:   Tue Mar 18 17:59:41 2014 +0000

document TpProxyWrapperFunc

---

 telepathy-glib/proxy-methods.c |   16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/telepathy-glib/proxy-methods.c b/telepathy-glib/proxy-methods.c
index bd4d14a..4c1d731 100644
--- a/telepathy-glib/proxy-methods.c
+++ b/telepathy-glib/proxy-methods.c
@@ -34,6 +34,22 @@
 #endif
 
 /**
+ * TpProxyWrapperFunc:
+ * @self: a proxy
+ * @error: (allow-none): an error, or %NULL for a successful reply
+ * @args: (allow-none): the arguments of a successful reply, or %NULL
+ *  on error
+ * @callback: the callback to call
+ * @user_data: user data to pass to the callback
+ * @weak_object: object to pass to the callback
+ *
+ * A simplified reinvention of #GClosureMarshal for #TpProxy subclasses.
+ * Functions with this signature are intended to be
+ * programmatically-generated; there should be no need to use it in
+ * hand-written code, other than the implementation of #TpProxy.
+ */
+
+/**
  * TpProxyPendingCall:
  *
  * Opaque structure representing a pending D-Bus call.