doc: document new command buffering scheme

Fixup for c0b5faf222dfa6e8db94838c18331e7147a37128.

diff --git a/doc/upgrading.rst b/doc/upgrading.rst
index 09ec979dfcc592fadae43f6006f24320d0b3ff9a..2c6d14e14b56b3c02fe7700cbf4a00f45847429c 100644 (file)
--- a/doc/upgrading.rst
+++ b/doc/upgrading.rst
@@ -18,9 +18,6 @@ Following section provides information about selected changes in not-yet-release
 We advise users to prepare for these changes sooner rather than later to make it easier to upgrade to
 newer versions when they are released.
 
-* Users of :ref:`control-sockets` API need to terminate each command sent to resolver with newline
-  character (ASCII ``\n``). Correct usage: ``cache.stats()\n``.
-  Newline terminated commands are accepted by all resolver versions >= 1.0.0.
 * Human readable output from :ref:`control-sockets` is not stable and changes from time to time.
   Users who need machine readable output for scripts should use Lua function
   ``tojson()`` to convert Lua values into standard JSON format instead of attempting to parse
@@ -38,6 +35,13 @@ newer versions when they are released.
 5.1 to 5.2
 ==========
 
+Users
+~~~~~
+
+* Users of :ref:`control-sockets` API need to terminate each command sent to resolver with newline
+  character (ASCII ``\n``). Correct usage: ``cache.stats()\n``.
+  Newline terminated commands are accepted by all resolver versions >= 1.0.0.
+
 Module changes
 --------------
 * Reply packet :c:type:`kr_request.answer`