Skip to content

Commit be41d87

Browse files
committed
docs: Emphasize that pip may break existing packages
Related to #7744 .
1 parent d89ab78 commit be41d87

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

docs/html/user_guide.rst

+5-4
Original file line numberDiff line numberDiff line change
@@ -198,7 +198,7 @@ In practice, there are 4 common uses of Requirements files:
198198
py -m pip install -r requirements.txt
199199
200200
2. Requirements files are used to force pip to properly resolve dependencies.
201-
As it is now, pip `doesn't have true dependency resolution
201+
pip 20.2 and earlier `doesn't have true dependency resolution
202202
<https://github.com/pypa/pip/issues/988>`_, but instead simply uses the first
203203
specification it finds for a project. E.g. if ``pkg1`` requires
204204
``pkg3>=1.0`` and ``pkg2`` requires ``pkg3>=1.0,<=2.0``, and if ``pkg1`` is
@@ -1430,12 +1430,13 @@ time to fix the underlying problem in the packages, because pip will
14301430
be stricter from here on out.
14311431

14321432
This also means that, when you run a ``pip install`` command, pip only
1433-
considers the packages you are installing in that command, and may
1434-
break already-installed packages. It will not guarantee that your
1433+
considers the packages you are installing in that command, and **may
1434+
break already-installed packages**. It will not guarantee that your
14351435
environment will be consistent all the time. If you ``pip install x``
14361436
and then ``pip install y``, it's possible that the version of ``y``
14371437
you get will be different than it would be if you had run ``pip
1438-
install x y`` in a single command. We would like your thoughts on what
1438+
install x y`` in a single command. We are considering changing this
1439+
behavior (per :issue:`7744`) and would like your thoughts on what
14391440
pip's behavior should be; please answer `our survey on upgrades that
14401441
create conflicts`_.
14411442

0 commit comments

Comments
 (0)