diff options
author | Lennart Poettering <lennart@poettering.net> | 2010-06-25 06:06:28 +0200 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2010-06-25 06:06:28 +0200 |
commit | 06d83a3a2b90ede6093284c99659418886cc562a (patch) | |
tree | 2bf49f4e219044b4e6ae17006be5ca88de76a016 /avahi-common/defs.h | |
parent | 7280ca0c4ff392134133e9c008be74a35a417af2 (diff) |
docs: document what to do on AVAHI_ERR_DISCONNECTED (see #278)
Diffstat (limited to 'avahi-common/defs.h')
-rw-r--r-- | avahi-common/defs.h | 10 |
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. * |