Update pages

Author: xuniq

doc/dev_guide/internals/iproto/format.rst

@@ -68,6 +68,8 @@ Read the source code file `net_box.c <https://github.com/tarantool/tarantool/blo
 where the function ``decode_metadata_optional`` is an example of how Tarantool
 itself decodes extra items.
 
+..  _box_protocol-body:
+
 Body
 ----
 

doc/reference/reference_lua/box_iproto.rst

@@ -6,9 +6,9 @@ Submodule box.iproto
 Since :doc:`2.11.0 </release/2.11.0>`.
 
 The ``box.iproto`` submodule provides the ability to work with the network subsystem of Tarantool.
-The submodule is important for backward compatibility and enables to
+It enables to extend the :ref:`binary protocol <box_protocol>` functionality from the Lua libraries.
+With this submodule, you can:
 
-*   extend the :ref:`binary protocol <box_protocol>` functionality from the Lua libraries
 *   parse the unknown IPROTO requests
 *   send arbitrary IPROTO packets
 *   override the behavior of the existing request types in binary protocol
@@ -35,13 +35,13 @@ For example:
 
 ..  code-block:: lua
 
-    box.iproto.key.SYNC = 1
+    box.iproto.key.SYNC = 0x01
     -- ...
     box.iproto.type.SELECT = 1
     -- ...
-    box.iproto.flag.COMMIT = 1
+    box.iproto.flag.COMMIT = 0x01
     -- ...
-    box.iproto.ballot_key.VCLOCK = 2
+    box.iproto.ballot_key.VCLOCK = 0x02
     -- ...
     box.iproto.metadata_key.IS_NULLABLE = 3
     -- ...
@@ -57,7 +57,7 @@ The submodule exports:
 
 *   the current IPROTO protocol version (:ref:`box.iproto.protocol_version <reference_lua-box_iproto_version>`)
 *   the set of IPROTO protocol features supported by the server (:ref:`box.iproto.protocol_features <reference_lua-box_iproto_protocol-features>`)
-*   the IPROTO protocol features with the corresponding code (:ref:`box.iproto.feature <reference_lua-box_iproto_feature>`)
+*   IPROTO protocol features with the corresponding code (:ref:`box.iproto.feature <reference_lua-box_iproto_feature>`)
 
 ..  _box_iproto-reference:
 

doc/reference/reference_lua/box_iproto/ballot.rst

@@ -7,8 +7,8 @@ box.iproto.ballot_key
 
     ..  data:: ballot_key
 
-    The ``box.iproto.ballot_key`` namespace contains the keys from the :ref:`IPROTO_BALLOT <box_protocol-ballots>` requests.
-    Learn more: :ref:`IPROTO_BALLOT keys <internals-iproto-keys-ballot>`.
+        The ``box.iproto.ballot_key`` namespace contains the keys from the :ref:`IPROTO_BALLOT <box_protocol-ballots>` requests.
+        Learn more: :ref:`IPROTO_BALLOT keys <internals-iproto-keys-ballot>`.
 
     Available keys:
 
@@ -55,3 +55,13 @@ box.iproto.ballot_key
         *   -   REGISTERED_REPLICA_UUIDS
             -   :ref:`IPROTO_BALLOT_REGISTERED_REPLICA_UUIDS <internals-iproto-keys-ballot>`
             -   0x09
+
+
+**Example**
+
+..  code-block:: lua
+
+    box.iproto.ballot_key.IS_RO_CFG = 0x01
+    -- ...
+    box.iproto.ballot_key.VCLOCK = 0x02
+    -- ...

doc/reference/reference_lua/box_iproto/flag.rst

@@ -7,8 +7,8 @@ box.iproto.flag
 
     ..  data:: flag
 
-    The ``box.iproto.flag`` namespace contains the flags from the ``IPROTO_FLAGS`` key.
-    Learn more: :ref:`IPROTO_FLAGS key <box_protocol-flags>`.
+        The ``box.iproto.flag`` namespace contains the flags from the ``IPROTO_FLAGS`` key.
+        Learn more: :ref:`IPROTO_FLAGS key <box_protocol-flags>`.
 
     Available flags:
 
@@ -31,3 +31,13 @@ box.iproto.flag
         *   -   WAIT_ACK
             -   :ref:`IPROTO_FLAG_WAIT_ACK <internals-iproto-keys-flags>`
             -   0x03
+
+
+**Example**
+
+..  code-block:: lua
+
+    box.iproto.flag.COMMIT = 0x01
+    -- ...
+    box.iproto.flag.WAIT_SYNC = 0x02
+    -- ...