Add v4 support to docs

Gauvain Pocentek · Gauvain Pocentek · commit f2b94a7f2cef · 2017-05-24T08:20:41.000+02:00
diff --git a/docs/api-usage.rst b/docs/api-usage.rst
@@ -40,6 +40,20 @@ You can also use configuration files to create ``gitlab.Gitlab`` objects:
 See the :ref:`cli_configuration` section for more information about
 configuration files.
 
+**GitLab v4 support**
+
+``python-gitlab`` uses the v3 GitLab API by default. Use the ``api_version``
+parameter to switch to v4:
+
+.. code-block:: python
+
+   import gitlab
+
+   gl = gitlab.Gitlab('http://10.0.0.1', 'JVNSESs8EwWRx5yDxM5q', api_version=4)
+
+.. warning::
+
+   The v4 support is experimental.
 
 Managers
 ========
diff --git a/docs/cli.rst b/docs/cli.rst
@@ -36,10 +36,12 @@ The configuration file uses the ``INI`` format. It contains at least a
    default = somewhere
    ssl_verify = true
    timeout = 5
+   api_version = 3
 
    [somewhere]
    url = https://some.whe.re
    private_token = vTbFeqJYCY3sibBP7BZM
+   api_version = 4
 
    [elsewhere]
    url = http://else.whe.re:8080
@@ -78,6 +80,8 @@ section.
      - URL for the GitLab server
    * - ``private_token``
      - Your user token. Login/password is not supported.
+   * - ``api_version``
+     - API version to use (``3`` or ``4``), defaults to ``3``
    * - ``http_username``
      - Username for optional HTTP authentication
    * - ``http_password``
