diff --git a/doc/xml/reference.xml b/doc/xml/reference.xml
index 4cd2bdb96..a79d654d5 100644
--- a/doc/xml/reference.xml
+++ b/doc/xml/reference.xml
@@ -110,7 +110,9 @@
 
                         <text>Set the buffer size used for copy, compress, and uncompress functions.  A maximum of 3 buffers will be in use at a time per process.  An additional maximum of 256K per process may be used for zlib buffers.
 
-                        Size can be entered in bytes (default) or KB, MB, GB, TB, or PB where the multiplier is a power of 1024.</text>
+                        Size can be entered in bytes (default) or KB, MB, GB, TB, or PB where the multiplier is a power of 1024. For example, the case-insensitive value 32k (or 32KB) can be used instead of 32768.
+
+                        Allowed values, in bytes, are <id>16384</id>, <id>32768</id>, <id>65536</id>, <id>131072</id>, <id>262144</id>, <id>524288</id>, <id>1048576</id>, <id>2097152</id>, <id>4194304</id>, <id>8388608</id>, and <id>16777216</id>.</text>
 
                         <example>32K</example>
                     </config-key>
diff --git a/doc/xml/release.xml b/doc/xml/release.xml
index b803cb0d8..9fec3ec52 100644
--- a/doc/xml/release.xml
+++ b/doc/xml/release.xml
@@ -70,6 +70,19 @@
                 </release-development-list>
             </release-core-list>
 
+            <release-doc-list>
+                <release-improvement-list>
+                    <release-item>
+                        <release-item-contributor-list>
+                            <release-item-ideator id="stephane.schildknecht"/>
+                            <release-item-contributor id="cynthia.shang"/>
+                        </release-item-contributor-list>
+
+                        <p>List allowable values for the <br-option>buffer-size</br-option> option in the configuration reference.</p>
+                    </release-item>
+                </release-improvement-list>
+            </release-doc-list>
+
             <release-test-list>
                 <release-development-list>
                     <release-item>
@@ -5478,6 +5491,11 @@
             <contributor-id type="github">slardiere</contributor-id>
         </contributor>
 
+        <contributor id="stephane.schildknecht">
+            <contributor-name-display>St&amp;eacute;phane Schildknecht</contributor-name-display>
+            <contributor-id type="github">saspg</contributor-id>
+        </contributor>
+
         <contributor id="stephen.frost">
             <contributor-name-display>Stephen Frost</contributor-name-display>
             <contributor-id type="github">sfrost</contributor-id>