Add tt console docs

Author: p7nov

doc/reference/tooling/tt_cli/connect.rst

@@ -34,12 +34,13 @@ Options
 
 ..  option:: -l LANGUAGE, --language LANGUAGE
 
-    The input language of the :ref:`tt-interactive-console`: ``lua`` (default) or ``sql``.
+    The input language of the :ref:`tt interactive console <tt-interactive-console>`:
+    ``lua`` (default) or ``sql``.
 
 ..  option:: -x FORMAT, --outputformat FORMAT
 
-    The output format of the :ref:`tt-interactive-console`: ``yaml`` (default),
-    ``lua``, ``table``, ``ttable``.
+    The output format of the :ref:`tt interactive console <tt-interactive-console>`:
+    ``yaml`` (default), ``lua``, ``table``, ``ttable``.
 
 Details
 -------

doc/reference/tooling/tt_cli/tt_interactive_console.rst

@@ -3,12 +3,11 @@
 tt interactive console
 ======================
 
-Intro: tt connect. + take some desc from tarantool console page
-
-The ``tt`` utility features an command-line console that allows working interactively
-in the connected Tarantool instances. It is pretty similar to the :ref:`Tarantool interactive console <interactive_console>`,
-but allows connecting to any available instance (both local and remote) and provides
-wider formatting capabilities.
+The ``tt`` utility features an command-line console that allows executing requests
+and Lua code interactively on the connected Tarantool instances.
+It is similar to the :ref:`Tarantool interactive console <interactive_console>` with
+one key difference: the ``tt`` console allows connecting to any available instance,
+both local and remote. Additionally, it offers more flexible output formatting capabilities.
 
 .. _tt-interactive-console-enter:
 
@@ -27,8 +26,8 @@ in the corresponding options.
 
     192.168.10.10:3301>
 
-When connecting to an instance from the same ``tt`` environment, you can use the ``<application>:<instance>``
-string instead of the URI:
+When connecting to an instance from the same ``tt`` environment, you can use the
+``<application>:<instance>`` string instead of the URI:
 
 ..  code-block:: console
 
@@ -77,7 +76,7 @@ language, run ``\set language <language>``, for example:
 .. note::
 
     You can also specify the input language in the ``tt connect`` call using the
-    ``-l``/``--language`` option.
+    ``-l``/``--language`` option:
 
     ..  code-block:: console
 
@@ -93,7 +92,7 @@ Console output
 --------------
 
 By default, the ``tt`` console prints the output data in the YAML format, each
-tuple on the new line.
+tuple on the new line:
 
 ..  code-block:: console
 
@@ -104,8 +103,8 @@ tuple on the new line.
       - [3, 'Ace of Base', 1987]
     ...
 
-You can switch to alternative output formats: Lua or human-readable tables using
-the ``\set output`` console command:
+You can switch to alternative output formats -- Lua or human-readable tables --
+using the ``\set output`` console command:
 
 ..  code-block:: console
 
@@ -127,7 +126,7 @@ the ``\set output`` console command:
 The table output can be printed in the transposed format, where an object's fields
 are arranged in columns instead of rows:
 
-.. code-block::console
+..  code-block:: console
 
     app:storage001> \set output ttable
     app:storage001> box.space.bands:select { }
@@ -142,7 +141,7 @@ are arranged in columns instead of rows:
 .. note::
 
     You can also specify the output format in the ``tt connect`` call using the
-    ``-x``/``--outputformat`` option.
+    ``-x``/``--outputformat`` option:
 
     ..  code-block:: console
 
@@ -153,10 +152,10 @@ following commands:
 
 *   ``\set table_format`` -- table format: default (pseudographics, or ASCII table), Markdown,
     or Jira-compatible format.
-*   ``\set grahpics`` -- enable or disable graphics for table cells.
+*   ``\set grahpics`` -- enable or disable graphics for table cells in the default format.
 *   ``\set table_column_width`` -- maximum column width.
 
-.. code-block::console
+..  code-block:: console
 
     app:storage001> \set table_format jira
     app:storage001> box.space.bands:select {}
@@ -196,15 +195,18 @@ Quit the ``tt`` console.
 \\shortcuts
 ~~~~~~~~~~~
 
-Show available keyboard shortcuts
+Show available keyboard shortcuts.
 
 \\set language {lua|sql}
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-Set the input language: Lua or SQL.
-Possible values: ``lua`` (default), ``sql``.
+Set the input language.
+Possible values:
 
-An analog of the :ref:``tt connect <tt-connect>`` option ``-l``/``--language``
+*   ``lua`` (default)
+*   ``sql``.
+
+An analog of the :ref:`tt connect <tt-connect>` option ``-l``/``--language``
 
 \\set output FORMAT, \\x{l|t|T|y}, \\x
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -226,10 +228,10 @@ Possible ``FORMAT`` values:
     The ``\x`` command switches the output format cyclically in the order
     ``yaml`` > ``lua`` > ``table`` > ``ttable``.
 
-The format of ``table`` and ``ttable`` output can be adjusted using the :ref:`\set table_format <>`,
-:ref:`\set graphics <>`, and :ref:`\set table_colum_width` commands.
+The format of ``table`` and ``ttable`` output can be adjusted using the ``\set table_format``,
+``\set graphics`, and ``\set table_colum_width`` commands.
 
-An analog of the :ref:``tt connect <tt-connect>`` option ``-x``/``--outputformat``
+An analog of the :ref:`tt connect <tt-connect>` option ``-x``/``--outputformat``
 
 \\set table_format
 ~~~~~~~~~~~~~~~~~~
@@ -238,8 +240,8 @@ Set the table format if the output format is ``table`` or ``ttable``.
 Possible values:
 
 *   ``default`` -- a pseudographics (ASCII) table.
-*   ``markdown`` -- a table in the Markdown format
-*   ``jira`` -- a Jira-compatible table
+*   ``markdown`` -- a table in the Markdown format.
+*   ``jira`` -- a Jira-compatible table.
 
 \\set graphics {true|false}, \\x{g|G}
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -259,8 +261,3 @@ Set maximum printed width of a table cell content. If the length exceeds this va
 it continues on the next line starting from +
 
 Shorthand: ``\xw``
-
-.. _tt-interactive-console-shortcuts:
-
-Shortcuts
----------