Doc improvements for websockets_header_size.

man/mosquitto.conf.5.xml

@@ -987,11 +987,12 @@
 					<listitem>
                         <para>Change the websockets headers size. This is a
 							global option, it is not possible to set per
-							listener. This is the value passed to libwebsockets
+							listener. This option sets the size of the buffer
-							max_http_header_data which is used for the buffer size
+							used in the libwebsockets library when reading HTTP
-							to process HTTP headers. See the libwebsockets documention
+							headers. If you are passing large header data such
-							for more details. A value of 0 (the default) means to
+							as cookies then you may need to increase this
-							use libwebsockets' default (which is 1024).</para>
+							value. If left unset, or set to 0, then the default
+							of 1024 bytes will be used.</para>
 					</listitem>
 				</varlistentry>
 			</variablelist>

mosquitto.conf

@@ -595,14 +595,13 @@
 # libwebsockets documentation for more details. "log_type websockets" must also
 # be enabled.
 #websockets_log_level 0
-#
+
 # Change the websockets headers size. This is a global option, it is not
-# possible to set per listener. This is the value passed to libwebsockets
+# possible to set per listener. This option sets the size of the buffer used in
-# max_http_header_data which is used for the buffer size to process HTTP
+# the libwebsockets library when reading HTTP headers. If you are passing large
-# headers. See the libwebsockets documentation for more details.
+# header data such as cookies then you may need to increase this value. If left
-# A value of 0 (the default) means to use libwebsockets' default (which is
+# unset, or set to 0, then the default of 1024 bytes will be used.
-# 1024).
+#websockets_headers_size
-#websockets_headers_size 0
 
 # If set to true, client connection and disconnection messages will be included
 # in the log.