X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=avahi-common%2Fdefs.h;h=100c9f5f6768ff7bad24f40922151f2b6c038f46;hb=a534996c7f304b219c3c3c41d97f6c20051871f2;hp=9ad69beaf0fc5a0ff39b52f5f438061583f6bb8c;hpb=e285034f90e0856d13a441b0e8d355f9b34aa95b;p=catta

diff --git a/avahi-common/defs.h b/avahi-common/defs.h
index 9ad69be..100c9f5 100644
--- a/avahi-common/defs.h
+++ b/avahi-common/defs.h
@@ -118,9 +118,16 @@
  * avahi_alternative_service_name()) and commit again. Please do not
  * free the entry group and create a new one. This would inhibit some
  * traffic limiting algorithms in mDNS.
- * - When you need to modify your services, use the AVAHI_PUBLISH_UPDATE flag. Please do not
- * free the entry group and create a new one. This would inhibit some
- * traffic limiting algorithms in mDNS.
+ * - When you need to modify your services (i.e. change the TXT data
+ * or the port number), use the AVAHI_PUBLISH_UPDATE flag. Please do
+ * not free the entry group and create a new one. This would inhibit
+ * some traffic limiting algorithms in mDNS. When changing just the
+ * TXT data avahi_entry_group_update_txt() is a shortcut for
+ * AVAHI_PUBLISH_UPDATE. Please note that you cannot use
+ * AVAHI_PUBLISH_UPDATE when changing the service name! Renaming a
+ * DNS-SD service is identical to deleting and creating a new one, and
+ * that's exactly what you should do in that case. First call
+ * avahi_entry_group_reset() to remove it and than readd it normally.
  *
  * The linked functions belong to avahi-client. They all have counterparts in the DBUS API and avahi-core.
  *