Update tt commands reference for tt 1.3

Author: p7nov

doc/reference/tooling/tt_cli/install.rst

@@ -5,7 +5,7 @@ Installing Tarantool software
 
 ..  code-block:: console
 
-    $ tt install PROGRAM_NAME [VERSION] [OPTION ...]
+    $ tt install PROGRAM_NAME [VERSION|COMMIT_OR_PR] [OPTION ...]
 
 ``tt install`` installs the latest or an explicitly specified version of Tarantool
 or ``tt``. The possible values of ``PROGRAM_NAME`` are:
@@ -21,6 +21,11 @@ or ``tt``. The possible values of ``PROGRAM_NAME`` are:
     (see the :ref:`ee section <tt-config_file_ee>` of the configuration file) or
     provide them interactively.
 
+Additionally, ``tt install`` can build open source programs ``tarantool`` and ``tt``
+from a specific commit or a pull request on their GitHub repositories.
+
+To uninstall a Tarantool or ``tt`` version, use :doc:`tt uninstall <uninstall>`.
+
 Options
 -------
 
@@ -66,16 +71,42 @@ dependencies, such as a C compiler. Make sure they are available in the system.
 
 Tarantool Enterprise Edition is installed from prebuilt packages.
 
+Development versions
+~~~~~~~~~~~~~~~~~~~~
+
+``tt install`` can be used to build custom Tarantool and ``tt`` versions for
+development purposes. The sources for such version can be either stored locally
+or exist on GitHub (specific commits or pull requests).
+
+To build Tarantool from a local source, use the ``tarantool-dev`` program name and
+provide a path to the source:
+
+..  code-block:: console
+
+    $ tt install tarantool-dev ~/src/tarantool/build
+
+To build Tarantool or ``tt`` from a specific commit on their GitHub repository,
+pass the commit hash (7 or more characters) after the program name. If you want to use
+a PR as a source, provide a ``pr/<PR_ID>`` argument:
+
+
+..  code-block:: console
+
+    $ tt install tarantool 03c184d
+    $ tt install tt pr/50
+
+
+Local repositories
+~~~~~~~~~~~~~~~~~~
+
 You can also set up a local repository with installation files you need.
 To use it, specify its location in the :ref:`repo section <tt-config_file_repo>`
 of the ``tt`` configuration file and run ``tt install`` with the ``--local-repo`` flag.
 
-To uninstall a Tarantool or ``tt`` version, use :doc:`tt uninstall <uninstall>`.
-
 Example
 --------
 
-*   Install the latest available version of Tarantool:
+*   Install the latest available version of Tarantool CE:
 
     ..  code-block:: console
 
@@ -98,3 +129,16 @@ Example
     ..  code-block:: console
 
         $ tt install tarantool-dev ~/src/tarantool/build
+
+
+*   Install Tarantool from a PR #1234 on the `tarantool/tarantool GitHub repository <https://github.com/tarantool/tarantool>`__:
+
+    ..  code-block:: console
+
+        $ tt install tarantool pr/1234
+
+*   Install ``tt`` from a commit with hash ``00a9e59`` on the `tarantool/tt GitHub repository <https://github.com/tarantool/tt>`__:
+
+    ..  code-block:: console
+
+        $ tt install tt 40e696e

doc/reference/tooling/tt_cli/pack.rst

@@ -126,9 +126,16 @@ Options
 
         $ tt pack deb --postinst post.sh
 
+..  option:: --tarantool-version
+
+    Specify a Tarantool version for packaging in a Docker container.
+    For use with ``--use-docker`` only.
+
 ..  option:: --use-docker
 
-    Build a package in an Ubuntu 18.04 Docker container.
+    Build a package in an Ubuntu 18.04 Docker container. To specify a Tarantool
+    version to use in the container, add the ``--tarantool-version option``.
+
     Before executing ``tt pack`` with this option, make sure Docker is running.
 
 ..  option:: --version PACKAGE_VERSION

doc/reference/tooling/tt_cli/rocks.rst

@@ -72,6 +72,8 @@ Commands
         :widths: 20 80
         :header-rows: 0
 
+        *   -   ``admin``
+            -   Use the `luarocks-admin <https://github.com/luarocks/luarocks/wiki/luarocks-admin>`__ tool
         *   -   ``build``
             -   Build and compile a rock
         *   -   ``config``