summaryrefslogtreecommitdiff
path: root/telepathy-glib
diff options
context:
space:
mode:
authorDanielle Madeley <danielle.madeley@collabora.co.uk>2011-10-31 22:36:51 +1100
committerDanielle Madeley <danielle.madeley@collabora.co.uk>2011-10-31 22:36:51 +1100
commite93e8889e7b75fa25911419a757e24ae23bcd4d6 (patch)
treea7efb9540a4dee114a21605967011cc1a4a6cced /telepathy-glib
parentfdfaadecfe8ae955c3c227eb58e43c4161b5009e (diff)
parent3f095ac75873015fc6758f1da7c21f955d5b5ab4 (diff)
Merge branch 'telepathy-glib-0.16'
Diffstat (limited to 'telepathy-glib')
-rw-r--r--telepathy-glib/proxy.c8
1 files changed, 8 insertions, 0 deletions
diff --git a/telepathy-glib/proxy.c b/telepathy-glib/proxy.c
index ae7fbec3..0a0b6dce 100644
--- a/telepathy-glib/proxy.c
+++ b/telepathy-glib/proxy.c
@@ -1383,6 +1383,14 @@ tp_proxy_class_init (TpProxyClass *klass)
*
* Emitted when this proxy has been become invalid for
* whatever reason. Any more specific signal should be emitted first.
+ *
+ * An invalidated proxy is one which can make no more method calls and will
+ * emit no more D-Bus signals. This is typically because the D-Bus object
+ * represented by the proxy ceased to exist, or there was some error
+ * obtaining the initial state.
+ *
+ * Any pending or future method calls made on this proxy will fail gracefully
+ * with the same error as returned by tp_proxy_get_invalidated().
*/
signals[SIGNAL_INVALIDATED] = g_signal_new ("invalidated",
G_OBJECT_CLASS_TYPE (klass),