[glib/gdbus-merge] Add some more details to the long description

[Matthias Clasen <matthiasc src gnome org>]

commit e72f7f52de9e482eb9d5dd1c47eb0d1bea5f4631
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu May 13 21:45:18 2010 -0400

    Add some more details to the long description

 gio/gdbusproxy.c |   14 ++++++++++++++
 1 files changed, 14 insertions(+), 0 deletions(-)
---
diff --git a/gio/gdbusproxy.c b/gio/gdbusproxy.c
index 7399ee6..911c659 100644
--- a/gio/gdbusproxy.c
+++ b/gio/gdbusproxy.c
@@ -53,6 +53,20 @@
  * for unique name bus and does not track whether the name
  * vanishes. Use g_bus_watch_proxy() to construct #GDBusProxy proxies
  * for owners of a well-known names.
+ *
+ * By default, #GDBusProxy will cache all properties (and listen for
+ * their changes) of the remote object, and proxy all signals that gets
+ * emitted. This behaviour can be changed by passing suitable
+ * #GDBusProxyFlags when the proxy is created.
+ *
+ * The generic #GDBusProxy::g-properties-changed and #GDBusProxy::g-signal
+ * signals are not very convenient to work with. Therefore, the recommended
+ * way of working with proxies is to subclass #GDBusProxy, and have
+ * more natural properties and signals in your derived class. The
+ * @interface_type argument of g_bus_watch_proxy() lets you obtain
+ * instances of your derived class when using the high-level API.
+ *
+ * See <xref linkend="gdbus-example-proxy-subclass"/> for an example.
  */
 
 struct _GDBusProxyPrivate