Skip to content

Commit

Permalink
Update docs for setting verbose/quiet in config file or env var
Browse files Browse the repository at this point in the history
Co-authored-by: Paul Moore <p.f.moore@gmail.com>
Co-authored-by: Prashant Sharma <prashantsharma161198@gmail.com>
Co-authored-by: Xavier Fernandez <xav.fernandez@gmail.com>
  • Loading branch information
4 people committed Jul 28, 2020
1 parent 2439d80 commit 7a0061d
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions docs/html/user_guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -442,6 +442,15 @@ and ``--no-cache-dir``, falsy values have to be used:
no-compile = no
no-warn-script-location = false
For options which can be repeated like ``--verbose`` and ``--quiet``,
a non-negative integer can be used to represent the level to be specified:

.. code-block:: ini
[global]
quiet = 0
verbose = 2
It is possible to append values to a section within a configuration file such as the pip.ini file.
This is applicable to appending options like ``--find-links`` or ``--trusted-host``,
which can be written on multiple lines:
Expand Down Expand Up @@ -488,6 +497,15 @@ is the same as calling::

pip install --find-links=http://mirror1.example.com --find-links=http://mirror2.example.com

Options that do not take a value, but can be repeated (such as ``--verbose``)
can be specified using the number of repetitions, so::

export PIP_VERBOSE=3

is the same as calling::

pip install -vvv

.. note::

Environment variables set to be empty string will not be treated as false.
Expand Down

0 comments on commit 7a0061d

Please sign in to comment.