Add default timeout in module http (#3076)

Fixes #3074 

* Add timeout
* Fix formatting
* Fix dashes
* Update .po files

Author: xuniq

doc/reference/reference_lua/http.rst

@@ -74,7 +74,7 @@ Below is a list of all ``http`` functions.
        to be free, and close it, in order to avoid exceeding the ``max_connections`` cache size.
        In the worst case, libcurl will create a new socket for every request,
        even if all requests are going to the same host.
-       See `this Tarantool issue on github <https://github.com/tarantool/tarantool/issues/3945>`_
+       See `this Tarantool issue on Github <https://github.com/tarantool/tarantool/issues/3945>`_
        for details.
 
     :return: a new HTTP client instance
@@ -104,43 +104,43 @@ Below is a list of all ``http`` functions.
         :param table opts: table of connection options, with any of these
          components:
 
-          * ``ca_file`` - path to an SSL certificate file to verify the peer with
-          * ``ca_path`` - path to a directory holding one or more certificates to
-            verify the peer with
-          * ``headers`` - table of HTTP headers
-          * ``keepalive_idle`` - delay, in seconds, that the operating system
+          * ``ca_file`` -- path to an SSL certificate file to verify the peer with.
+          * ``ca_path`` -- path to a directory holding one or more certificates to
+            verify the peer with.
+          * ``headers`` -- table of HTTP headers.
+          * ``keepalive_idle`` -- delay, in seconds, that the operating system
             will wait while the connection is idle before sending keepalive
             probes. See also
             `CURLOPT_TCP_KEEPIDLE <https://curl.haxx.se/libcurl/c/CURLOPT_TCP_KEEPIDLE.html>`_
             and the note below about keepalive_interval.
-          * ``keepalive_interval`` - the interval, in seconds, that the operating
+          * ``keepalive_interval`` -- the interval, in seconds, that the operating
             system will wait between sending keepalive probes. See also
             `CURLOPT_TCP_KEEPINTVL <https://curl.haxx.se/libcurl/c/CURLOPT_TCP_KEEPINTVL.html>`_.
             If both ``keepalive_idle`` and ``keepalive_interval`` are set, then
             Tarantool will also set HTTP keepalive headers: ``Connection:Keep-Alive``
             and ``Keep-Alive:timeout=<keepalive_idle>``.
-            Otherwise Tarantool will send ``Connection:close``
-          * ``low_speed_limit`` - set the "low speed limit" -- the average
+            Otherwise Tarantool will send ``Connection:close``.
+          * ``low_speed_limit`` -- set the "low speed limit" -- the average
             transfer speed in bytes per second that the transfer should be below
             during "low speed time" seconds for the library to consider it to be
             too slow and abort. See also
-            `CURLOPT_LOW_SPEED_LIMIT <https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_LIMIT.html>`_
-          * ``low_speed_time`` - set the "low speed time" -- the time that the
+            `CURLOPT_LOW_SPEED_LIMIT <https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_LIMIT.html>`_.
+          * ``low_speed_time`` -- set the "low speed time" -- the time that the
             transfer speed should be below the "low speed limit" for the library
             to consider it too slow and abort. See also
-            `CURLOPT_LOW_SPEED_TIME <https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_TIME.html>`_
-          * ``max_header_name_len`` - the maximal length of a header name. If a header
+            `CURLOPT_LOW_SPEED_TIME <https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_TIME.html>`_.
+          * ``max_header_name_len`` -- the maximal length of a header name. If a header
             name is bigger than this value, it is truncated to this length.
             The default value is '32'.
-          * ``follow_location`` - when the option is set to ``true`` (default)
+          * ``follow_location`` -- when the option is set to ``true`` (default)
             and the response has a 3xx code, the HTTP client will automatically issue
             another request to a location that a server sends in the ``Location``
             header. If the new response is 3xx again, the HTTP client will
             issue still another request and so on in a loop until a non-3xx response
             will be received. This last response will be returned as a result.
             Setting this option to ``false`` allows to disable this behavior.
             In this case, the HTTP client will return a 3xx response itself.
-          * ``no_proxy`` - a comma-separated list of hosts that do not require proxies, or '*', or ''.
+          * ``no_proxy`` -- a comma-separated list of hosts that do not require proxies, or '*', or ''.
             Set :samp:`no_proxy = {host} [, {host} ...]` to specify
             hosts that can be reached without requiring a proxy, even if ``proxy`` has
             been set to a non-blank value and/or if a proxy-related environment variable
@@ -152,44 +152,44 @@ Below is a list of all ``http`` functions.
             (HTTP_PROXY) is used.
             If ``no_proxy`` is not set, then a proxy-related environment variable
             (HTTP_PROXY) may be used. See also
-            `CURLOPT_NOPROXY <https://curl.haxx.se/libcurl/c/CURLOPT_NOPROXY.html>`_
+            `CURLOPT_NOPROXY <https://curl.haxx.se/libcurl/c/CURLOPT_NOPROXY.html>`_.
           * ``proxy`` - a proxy server host or IP address, or ''.
             If ``proxy`` is a host or IP address, then it may begin with a scheme,
             for example ``https://`` for an https proxy or ``http://`` for an http proxy.
-            If ``proxy`` is set to '' an empty string, then proxy use is disabled,
+            If ``proxy`` is set to '' -- an empty string, then proxy use is disabled,
             and no proxy-related environment variable will be used.
             If ``proxy`` is not set, then a proxy-related environment variable may be used, such as
             HTTP_PROXY or HTTPS_PROXY or FTP_PROXY, or ALL_PROXY if the
             protocol can be any protocol. See also
-            `CURLOPT_PROXY <https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html>`_
+            `CURLOPT_PROXY <https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html>`_.
           * ``proxy_port`` -- a proxy server port.
             The default is 443 for an https proxy and 1080 for a non-https proxy.
             See also
-            `CURLOPT_PROXYPORT <https://curl.haxx.se/libcurl/c/CURLOPT_PROXYPORT.html>`_
+            `CURLOPT_PROXYPORT <https://curl.haxx.se/libcurl/c/CURLOPT_PROXYPORT.html>`_.
           * ``proxy_user_pwd`` -- a proxy server user name and/or password.
             Format: :samp:`proxy_user_pwd = {user_name}:`
             or :samp:`proxy_user_pwd = :{password}`
             or :samp:`proxy_user_pwd = {user_name}:{password}`. See also
-            `CURLOPT_USERPWD <https://curl.haxx.se/libcurl/c/CURLOPT_USERPWD.html>`_
-          * ``ssl_cert`` - path to a SSL client certificate file. See also
-            `CURLOPT_SSLCERT <https://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html>`_
-          * ``ssl_key`` - path to a private key file for a TLS and SSL client
+            `CURLOPT_USERPWD <https://curl.haxx.se/libcurl/c/CURLOPT_USERPWD.html>`_.
+          * ``ssl_cert`` -- path to a SSL client certificate file. See also
+            `CURLOPT_SSLCERT <https://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html>`_.
+          * ``ssl_key`` -- path to a private key file for a TLS and SSL client
             certificate. See also
-            `CURLOPT_SSLKEY <https://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html>`_
-          * ``timeout`` - number of seconds to wait for a curl API read request
-            before timing out
-          * ``unix_socket`` - a socket name to use instead of an Internet address,
+            `CURLOPT_SSLKEY <https://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html>`_.
+          * ``timeout`` -- number of seconds to wait for a curl API read request
+            before timing out. The default timeout is set to infinity (36586400100 seconds).
+          * ``unix_socket`` -- a socket name to use instead of an Internet address,
             for a local connection. The Tarantool server must be built with
             ``libcurl`` 7.40 or later. See the :ref:`second example <http-example2>`
             later in this section.
-          * ``verbose`` - set on/off verbose mode
-          * ``verify_host`` - set on/off verification of the certificate's name
+          * ``verbose`` -- set on/off verbose mode.
+          * ``verify_host`` -- set on/off verification of the certificate's name
             (CN) against host. See also
-            `CURLOPT_SSL_VERIFYHOST <https://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html>`_
-          * ``verify_peer`` - set on/off verification of the peer's SSL
+            `CURLOPT_SSL_VERIFYHOST <https://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html>`_.
+          * ``verify_peer`` -- set on/off verification of the peer's SSL
             certificate. See also
-            `CURLOPT_SSL_VERIFYPEER <https://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html>`_
-          * ``accept_encoding`` - enables automatic decompression of HTTP responses
+            `CURLOPT_SSL_VERIFYPEER <https://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html>`_.
+          * ``accept_encoding`` -- enables automatic decompression of HTTP responses
             by setting the contents of the `Accept-Encoding: header` sent in an 
             HTTP request and enabling decoding of a response when the `Content-Encoding: header` 
             is received. This option specifies what encoding to use.
@@ -199,15 +199,15 @@ Below is a list of all ``http`` functions.
             response using the zlib algorithm, `gzip` which requests the gzip algorithm and `br` 
             which is brotli. Provide them in the string as a comma-separated list of accepted 
             encodings, like: ``"br, gzip, deflate"``. 
-            For details of the option, refer to `CURLOPT_ACCEPT_ENCODING <https://curl.haxx.se/libcurl/c/CURLOPT_ACCEPT_ENCODING.html>`_
+            For details of the option, refer to `CURLOPT_ACCEPT_ENCODING <https://curl.haxx.se/libcurl/c/CURLOPT_ACCEPT_ENCODING.html>`_.
 
         :return: connection information, with all of these components:
 
-          * ``status`` - HTTP response status
-          * ``reason`` - HTTP response status text
-          * ``headers`` - a Lua table with normalized HTTP headers
-          * ``body`` - response body
-          * ``proto`` - protocol version
+          * ``status`` -- HTTP response status
+          * ``reason`` -- HTTP response status text
+          * ``headers`` -- a Lua table with normalized HTTP headers
+          * ``body`` -- response body
+          * ``proto`` -- protocol version
 
         :rtype: table
 
@@ -256,23 +256,23 @@ Below is a list of all ``http`` functions.
 
         The following "shortcuts" exist for requests:
 
-        * ``http_client:get(url, options)`` - shortcut for
+        * ``http_client:get(url, options)`` -- shortcut for
           ``http_client:request("GET", url, nil, opts)``
-        * ``http_client:post (url, body, options)`` - shortcut for
+        * ``http_client:post (url, body, options)`` -- shortcut for
           ``http_client:request("POST", url, body, opts)``
-        * ``http_client:put(url, body, options)`` - shortcut for
+        * ``http_client:put(url, body, options)`` -- shortcut for
           ``http_client:request("PUT", url, body, opts)``
-        * ``http_client:patch(url, body, options)`` - shortcut for
+        * ``http_client:patch(url, body, options)`` -- shortcut for
           ``http_client:request("PATCH", url, body, opts)``
-        * ``http_client:options(url, options)`` - shortcut for
+        * ``http_client:options(url, options)`` -- shortcut for
           ``http_client:request("OPTIONS", url, nil, opts)``
-        * ``http_client:head(url, options)`` - shortcut for
+        * ``http_client:head(url, options)`` -- shortcut for
           ``http_client:request("HEAD", url, nil, opts)``
-        * ``http_client:delete(url, options)`` - shortcut for
+        * ``http_client:delete(url, options)`` -- shortcut for
           ``http_client:request("DELETE", url, nil, opts)``
-        * ``http_client:trace(url, options)`` - shortcut for
+        * ``http_client:trace(url, options)`` -- shortcut for
           ``http_client:request("TRACE", url, nil, opts)``
-        * ``http_client:connect:(url, options)`` - shortcut for
+        * ``http_client:connect:(url, options)`` -- shortcut for
           ``http_client:request("CONNECT", url, nil, opts)``
 
         Requests may be influenced by environment variables, for example
@@ -288,15 +288,15 @@ Below is a list of all ``http`` functions.
 
         The ``http_client:stat()`` function returns a table with statistics:
 
-        * ``active_requests`` - number of currently executing requests
-        * ``sockets_added`` - total number of sockets added into an event loop
-        * ``sockets_deleted`` - total number of sockets sockets from an event loop
-        * ``total_requests`` - total number of requests
-        * ``http_200_responses`` - total number of requests which have returned
+        * ``active_requests`` -- number of currently executing requests
+        * ``sockets_added`` -- total number of sockets added into an event loop
+        * ``sockets_deleted`` -- total number of sockets sockets from an event loop
+        * ``total_requests`` -- total number of requests
+        * ``http_200_responses`` -- total number of requests which have returned
           code HTTP 200
-        * ``http_other_responses`` - total number of requests which have not
+        * ``http_other_responses`` -- total number of requests which have not
           returned code HTTP 200
-        * ``failed_requests`` - total number of requests which have failed
+        * ``failed_requests`` -- total number of requests which have failed
           including system errors, curl errors, and HTTP errors
 
 .. _http-example1:

doc/reference/reference_lua/net_box.rst

@@ -16,13 +16,13 @@ network.
 
 You can call the following methods:
 
-* ``require('net.box')`` to get a ``net.box`` object
-  (named ``net_box`` for examples in this section),
-* ``net_box.connect()`` to connect and get a connection object
-  (named ``conn`` for examples in this section),
+* ``require('net.box')`` -- to get a ``net.box`` object
+  (named ``net_box`` for examples in this section)
+* ``net_box.connect()`` -- to connect and get a connection object
+  (named ``conn`` for examples in this section)
 * other ``net.box()`` routines, passing ``conn:``, to execute requests on
-  the remote database system,
-* ``conn:close`` to disconnect.
+  the remote database system
+* ``conn:close`` -- to disconnect
 
 All ``net.box`` methods are fiber-safe, that is, it is safe to share and use the
 same connection object across multiple concurrent fibers. In fact that is perhaps