From d9fc9cd0aea0a7d5ab7fecc6e6bde3163443f19d Mon Sep 17 00:00:00 2001
From: "Roger A. Light" <roger@atchoo.org>
Date: Tue, 25 Sep 2018 14:32:43 +0100
Subject: [PATCH] Add allow_zero_length_clientid, auto_id_prefix documentation.

Closes #600.
---
 ChangeLog.txt            |  2 +-
 man/mosquitto.conf.5.xml | 22 ++++++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/ChangeLog.txt b/ChangeLog.txt
index bf7e0fb2..18f21359 100644
--- a/ChangeLog.txt
+++ b/ChangeLog.txt
@@ -6,7 +6,7 @@ Broker:
 - Remove requirement to use `user root` in snap package config files.
 - Fix retained messages not sent by bridges on outgoing topics at the first
   connection. Closes #701.
-- Minor documentation fixes. Closes #520.
+- Documentation fixes. Closes #520, #600.
 - Fix duplicate clients being added to by_id hash before the old client was
   removed. Closes #645.
 
diff --git a/man/mosquitto.conf.5.xml b/man/mosquitto.conf.5.xml
index e5901c77..a6bf0c99 100644
--- a/man/mosquitto.conf.5.xml
+++ b/man/mosquitto.conf.5.xml
@@ -195,6 +195,17 @@
 					<para>Reloaded on reload signal.</para>
 				</listitem>
 			</varlistentry>
+			<varlistentry>
+				<term><option>allow_zero_length_clientid</option> [ true | false ]</term>
+				<listitem>
+					<para>MQTT 3.1.1 allows clients to connect with a zero
+						length client id and have the broker generate a client
+						id for them. Use this option to allow/disallow this
+						behaviour. Defaults to true.</para>
+					<para>See also the <option>auto_id_prefix</option> option.</para>
+					<para>Reloaded on reload signal.</para>
+				</listitem>
+			</varlistentry>
 			<varlistentry>
 				<term><option>auth_opt_*</option> <replaceable>value</replaceable></term>
 				<listitem>
@@ -244,6 +255,17 @@
 					<para>Not currently reloaded on reload signal.</para>
 				</listitem>
 			</varlistentry>
+			<varlistentry>
+				<term><option>auto_id_prefix</option> <replaceable>prefix</replaceable></term>
+				<listitem>
+					<para>If <option>allow_zero_length_clientid</option> is
+						<replaceable>true</replaceable>, this option allows you
+						to set a string that will be prefixed to the
+						automatically generated client ids to aid visibility in
+						logs. Defaults to no prefix.</para>
+					<para>Reloaded on reload signal.</para>
+				</listitem>
+			</varlistentry>
 			<varlistentry>
 				<term><option>autosave_interval</option> <replaceable>seconds</replaceable></term>
 				<listitem>