Fixes gh-1136 Document proctitle changes

doc/sphinx/book/app/b_proctitle.rst

@@ -9,20 +9,23 @@ which otherwise contains the program name. Tarantool uses this feature to help
 meet the needs of system administration, such as figuring out what services are
 running on a host, their status, and so on.
 
-A Tarantool server process title follows the following naming scheme:
-**program_name: role[@** :confval:`custom_proc_title` **]**
-
-**program_name** is typically **tarantool**. The role can be one of the following:
-
-* **running** -- ordinary node "ready to accept requests",
-* **loading** -- ordinary node recovering from old snap and wal files,
-* **orphan** -- not in a cluster,
-* **hot_standby** -- see section :ref:`local hot standby <book-cfg-local_hot_standy>`,
-* **dumper + process-id** -- saving a snapshot,
+A Tarantool server's process title has these components: |br|
+**program_name** [**initialization_file_name**] **<role_name>** [**custom_proc_title**]
+
+**program_name** is typically "tarantool". |br|
+**initialization_file_name** is the name of an :ref:`initialization file <init-label>` if one was specified. |br|
+**role_name** is:
+"running" (ordinary node "ready to accept requests"),
+"loading" (ordinary node recovering from old snap and wal files),
+"orphan" (not in a cluster),
+"hot_standby" (see section :ref:`local hot standby <book-cfg-local_hot_standy>`), or
+"dumper" + process-id (saving a snapshot). |br|
+**custom_proc_title** is taken from the :confval:`custom_proc_title` configuration parameter, if one was specified.
 
 For example:
 
 .. code-block:: console
 
-    $ ps -A -f | grep tarantool
-    1000     17701  2778  0 08:27 pts/0    00:00:00 tarantool: running
+    $ ps -AF | grep tarantool
+    1000     17337 16716  1 91362  6916   0 11:07 pts/5    00:00:13 tarantool script.lua <running> 
+

doc/sphinx/book/configuration/cfg-basic.rst

@@ -96,31 +96,27 @@
 
 .. confval:: custom_proc_title
 
-    Inject the given string into :ref:`server process title <book-proctitle>`
-    (what’s shown in the COMMAND column for :samp:`ps` and :samp:`top` commands).
+    Add the given string to the server's :ref:`Process title <book-proctitle>`
+    (what’s shown in the COMMAND column for :samp:`ps -ef` and :samp:`top -c` commands).
 
-    .. NOTE::
+    For example, ordinarily :samp:`ps` shows the Tarantool server process thus:
 
-        For example, ordinarily ps shows the Tarantool server process thus:
+    .. code-block:: console
 
-        .. code-block:: console
+        $ ps -ef | grep tarantool
+        1000     14939 14188  1 10:53 pts/2    00:00:13 tarantool <running>
 
-            $ ps -ef | grep tarantool
-            1000     22364  2778  0 09:14 pts/0    00:00:00 tarantool: running
-            1000     22394 22364  0 09:14 pts/0    00:00:00 tarantool: spawner
-            tarantool: primary pri: 3301 adm: 3313
+    But if the configuration parameters include
+    ``custom_proc_title='sessions'`` then the output looks like:
 
-        But if the configuration parameters include
-        ``custom_proc_title='sessions'`` then the output looks like:
+    .. code-block:: console
 
-            $ ps -ef | grep tarantool
-            1000     22364  2778  0 09:14 pts/0    00:00:00 tarantool: running@sessions
-            1000     22394 22364  0 09:14 pts/0    00:00:00 tarantool: spawner@sessions
-            tarantool: primary pri: 3301 adm: 3313
+        $ ps -ef | grep tarantool
+        1000     14939 14188  1 10:53 pts/2    00:00:16 tarantool <running>: sessions
 
     Type: string |br|
     Default: null |br|
-    Dynamic: no |br|
+    Dynamic: yes |br|
 
 .. confval:: background
 

doc/sphinx/reference/console.rst

@@ -100,7 +100,7 @@ host/port.
     **Example:**
 
     A special use of ``console.start()`` is with
-    :ref:`initialization files <URI>`.
+    :ref:`initialization files <init-label>`.
     Normally, if one starts the tarantool server with
     :samp:`tarantool {initialization file}`
     there is no console. This can be remedied by adding