summaryrefslogtreecommitdiffstats
path: root/avahi-common
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2010-06-25 06:06:28 +0200
committerLennart Poettering <lennart@poettering.net>2010-06-25 06:06:28 +0200
commit06d83a3a2b90ede6093284c99659418886cc562a (patch)
tree2bf49f4e219044b4e6ae17006be5ca88de76a016 /avahi-common
parent7280ca0c4ff392134133e9c008be74a35a417af2 (diff)
docs: document what to do on AVAHI_ERR_DISCONNECTED (see #278)
Diffstat (limited to 'avahi-common')
-rw-r--r--avahi-common/defs.h10
1 files changed, 6 insertions, 4 deletions
diff --git a/avahi-common/defs.h b/avahi-common/defs.h
index f228f82..bb73a9d 100644
--- a/avahi-common/defs.h
+++ b/avahi-common/defs.h
@@ -180,13 +180,15 @@
* avahi_client_new(). If the client is forced to disconnect from the
* server it will enter AVAHI_CLIENT_FAILURE state with
* avahi_client_errno() == AVAHI_ERR_DISCONNECTED. Free the
- * AvahiClient object in that case and reconnect to the server anew -
- * again with passing AVAHI_CLIENT_NO_FAIL to avahi_client_new().
+ * AvahiClient object in that case (and all its associated objects
+ * such as entry groups and browser objects prior to that) and
+ * reconnect to the server anew - again with passing
+ * AVAHI_CLIENT_NO_FAIL to avahi_client_new().
*
* We encourage implementing this in all software where service
* discovery is not an integral part of application. e.g. use it in
- * all kinds of background daemons, but not in software like iChat
- * compatible IM software.
+ * all kinds of background daemons, but not necessarily in software
+ * like iChat compatible IM software.
*
* For now AVAHI_CLIENT_NO_FAIL cannot deal with D-Bus daemon restarts.
*