Fix build warnings (tarantool#3757)

Author: andreyaksenov

doc/book/admin/_includes/upgrade_storages.rst

@@ -1,5 +1,7 @@
-.. // this instruction does not include the final step (calling box.snapshot())
-.. // because we need to add a warning after step 5 in one use of this instruction
+..
+    This instruction does not include the final step (calling box.snapshot())
+    because we need to add a warning after step 5 in one use of this instruction.
+
 Upgrade storage instances by performing the following steps for each replica set:
 
 .. note::
@@ -25,5 +27,3 @@ Upgrade storage instances by performing the following steps for each replica set
     This will update the Tarantool system spaces to match the currently installed
     version of Tarantool. The changes will be propagated to other nodes via the
     replication mechanism later.
-
-

doc/book/admin/upgrades/upgrade_standalone.rst

@@ -30,7 +30,7 @@ Upgrading a standalone instance
     using a package manager or the :ref:`tt utility <tt-cli>`.
     See the installation instructions at Tarantool `download page <http://tarantool.org/download.html>`_
     and in the :ref:`tt install reference <tt-install>`.
-   To check that the target Tarantool version is installed, run ``tarantool -v``.
+    To check that the target Tarantool version is installed, run ``tarantool -v``.
 
 #.  Start your application on the target version.
 

doc/contributing/docs/_includes/confval_template.rst

@@ -179,9 +179,12 @@ Configuration parameters
 
 Example:
 
-..  literalinclude:: ./_includes/confval_template.rst
+..  literalinclude:: /reference/configuration/cfg_basic.rst
     :language: rst
+    :lines: 219-231
 
 Result:
 
-..  include:: ./_includes/confval_template.rst
+..  include:: /reference/configuration/cfg_basic.rst
+    :start-line: 219
+    :end-line: 231

doc/contributing/docs/api.rst

@@ -9,8 +9,7 @@
 .. c:enum:: box_error_code
 
     For a complete list of errors, refer to the Tarantool
-    `error code header file <https://github.com/tarantool/tarantool/blob/2.10/src/box/errcode.h>`__
-    (provided for version 2.10).
+    `error code header file <https://github.com/tarantool/tarantool/blob/master/src/box/errcode.h>`__.
 
 .. c:type:: box_error_t
 

doc/dev_guide/reference_capi/error.rst

@@ -2,15 +2,15 @@
                        Module fiber
 ===========================================================
 
-.. c:type:: struct fiber
+.. c:type:: fiber
 
     Fiber - contains information about a :ref:`fiber <application_server_fibers>`.
 
-.. c:type:: typedef int (*fiber_func)(va_list)
+.. c:type:: int (*fiber_func)(va_list)
 
     Function to run inside a fiber.
 
-.. c:function:: struct fiber *fiber_new(const char *name, fiber_func f)
+.. c:function:: fiber *fiber_new(const char *name, fiber_func f)
 
     Create a new fiber.
 
@@ -25,7 +25,7 @@
 
     See also: :ref:`fiber_start()<c_api-fiber-fiber_start>`
 
-.. c:function:: struct fiber *fiber_new_ex(const char *name, const struct fiber_attr *fiber_attr, fiber_func f)
+.. c:function:: fiber *fiber_new_ex(const char *name, const struct fiber_attr *fiber_attr, fiber_func f)
 
     Create a new fiber with defined attributes.
 
@@ -147,17 +147,17 @@
 
     Reschedule fiber to end of event loop cycle.
 
-.. c:type:: struct slab_cache
+.. c:type:: slab_cache
 
 .. c:function:: struct slab_cache *cord_slab_cache(void)
 
     Return ``slab_cache`` suitable to use with ``tarantool/small`` library
 
-.. c:function:: struct fiber *fiber_self(void)
+.. c:function:: fiber *fiber_self(void)
 
     Return the current fiber.
 
-.. c:type:: struct fiber_attr
+.. c:type:: fiber_attr
 
 .. c:function:: void fiber_attr_new(void)
 
@@ -196,7 +196,7 @@
 
 .. _c_api-fiber_cond:
 
-.. c:type:: struct fiber_cond
+.. c:type:: fiber_cond
 
     A conditional variable: a synchronization primitive that allow fibers in
     Tarantool's :ref:`cooperative multitasking <app-cooperative_multitasking>`
@@ -212,7 +212,7 @@
 
     Create a new conditional variable.
 
-.. c:function:: void fiber_cond_delete(struct fiber_cond *cond)
+.. c:function:: void fiber_cond_delete(fiber_cond *cond)
 
     Delete the conditional variable.
 
@@ -254,7 +254,7 @@
     on every iteration.
 
     :param struct fiber_cond* cond: conditional variable
-    :param struct double timeout: timeout in seconds
+    :param double timeout: timeout in seconds
 
     :return: 0 on :ref:`fiber_cond_signal() <c_api-fiber_cond_signal>` call or a
              spurious wake up

doc/dev_guide/reference_capi/fiber.rst

@@ -154,7 +154,7 @@
 
 .. _capi-tuple_key_def:
 
-.. c:type:: typedef struct key_def box_key_def_t
+.. c:type:: box_key_def_t
 
     Key definition
 

doc/dev_guide/reference_capi/tuple.rst

@@ -139,7 +139,7 @@
     | Dynamic: yes
 
     Setting ``read_only == true`` affects spaces differently depending on the
-    :ref:`options <box_schema-space_create-options>` that were used during
+    :ref:`options <space_opts_object>` that were used during
     :doc:`box.schema.space.create </reference/reference_lua/box_schema/space_create>`,
     as summarized by this chart:
 

doc/reference/configuration/cfg_basic.rst

@@ -37,7 +37,7 @@ box.session.push()
             * If the result is not an error, then the return is the boolean value ``true``.
             * When the return is ``true``, the message has gone to the network
               buffer as a :ref:`packet <box_protocol-iproto_protocol>`
-              with a different :ref:`header code <box_protocol-responses_out_of_band>`
+              with a different header code
               so the client can distinguish from an ordinary Okay response.
 
     The server's sole job is to call ``box.session.push()``, there is no