pip command update

This commit is contained in:
Chris Holdgraf
2018-09-28 12:00:07 -07:00
parent 8a7ab7bc78
commit c48988afcb

View File

@@ -59,21 +59,20 @@ living document that grows over time, so feel free to add to it / change it!
Our entire documentation does not yet fully conform to these conventions yet, Our entire documentation does not yet fully conform to these conventions yet,
so help in making it so would be appreciated! so help in making it so would be appreciated!
``pip`` invocations ``pip`` invocation
------------------- ------------------
There are three ways to invoke a ``pip`` command: There are many ways to invoke a ``pip`` command, we recommend the following
approach:
1. ``pip`` ```
This points to python3 pip if you are in an appropriate environment, python3 -m pip
but in some cases it can actually point to a python2 pip. ```
2. ``pip3`` This invokes pip explicitly using the python3 binary that you are
When present, this always points to a python3 pip, most likely in currently using. This is the **recommended way** to invoke pip
the same environment as your python3. in our documentation, since it is least likely to cause problems
with python3 and pip being from different environments.
3. ``python3 -m pip`` For more information on how to invoke ``pip`` commands, see
This invokes pip explicitly using the python3 binary that you are `the pip documentation <https://pip.pypa.io/en/stable/>`_.
currently using. This is the **recommended way** to invoke pip
in our documentation, since it is least likely to cause problems
with python3 and pip being from different environments.