--- a/xml/en/docs/stream/ngx_stream_mqtt_filter_module.xml	Thu Jul 06 18:12:53 2023 +0100
+++ b/xml/en/docs/stream/ngx_stream_mqtt_filter_module.xml	Tue Aug 15 12:36:26 2023 +0100
@@ -62,12 +62,37 @@
 
 </directive>
 
+
+<directive name="mqtt_buffers">
+<syntax><value>number</value> <value>size</value></syntax>
+<default>100 1k</default>
+<context>stream</context>
+<context>server</context>
+<appeared-in>1.25.1</appeared-in>
+
+<para>
+Sets the <value>number</value> and <value>size</value> of the buffers
+used for handling MQTT messages,
+for a single connection.
+</para>
+
+</directive>
+
+
 <directive name="mqtt_rewrite_buffer_size">
 <syntax><value>size</value></syntax>
 <default>4k|8k</default>
 <context>server</context>
 
 <para>
+<note>
+This directive is obsolete since version 1.25.1.
+The <link id="mqtt_buffers"/>
+directive should be used instead.
+</note>
+</para>
+
+<para>
 Sets the <value>size</value> of the buffer
 used for writing a modified message.
 By default, the buffer size is equal to one memory page.
@@ -77,6 +102,7 @@
 
 </directive>
 
+
 <directive name="mqtt_set_connect">
 <syntax><literal>field</literal> <value>value</value></syntax>
 <default/>