Skip to content

Commit 264f6e2

Browse files
DOC: Clarify lack of index priority
* Specifically mention the --index-url and --extra-index-url both provide locations for pip to look for packages in the 'Finding Packages' section. However, explicitly state that there is no priority ordering for the search locations. * This is a recurring point of confusion on the pip GitHub issue tracker as well as on https://github.com/pypa/packaging-problems/issues/, so additional clarification could help here. Co-authored-by: Henry Schreiner <[email protected]>
1 parent 52d7296 commit 264f6e2

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

docs/html/cli/pip_install.rst

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -212,11 +212,12 @@ and `there <https://www.python.org/dev/peps/pep-0503/>`_.
212212
pip offers a number of package index options for modifying how packages are
213213
found.
214214

215-
pip looks for packages in a number of places: on PyPI (if not disabled via
216-
``--no-index``), in the local filesystem, and in any additional repositories
217-
specified via ``--find-links`` or ``--index-url``. There is no ordering in
218-
the locations that are searched. Rather they are all checked, and the "best"
219-
match for the requirements (in terms of version number - see the
215+
pip looks for packages in a number of places: on PyPI (or the index given as
216+
``--index-url``, if not disabled via ``--no-index``), in the local filesystem,
217+
and in any additional repositories specified via ``--find-links`` or
218+
``--extra-index-url``. There is no priority in the locations that are searched.
219+
Rather they are all checked, and the "best" match for the requirements (in
220+
terms of version number - see the
220221
:ref:`specification <pypug:version-specifiers>` for details) is selected.
221222

222223
See the :ref:`pip install Examples<pip install Examples>`.

0 commit comments

Comments
 (0)