Skip to content

Commit 3ac0c2d

Browse files
committed
Improve docs on resolver, constraints, and hash-checking
Related to pypa#9020.
1 parent cc3b3f6 commit 3ac0c2d

File tree

2 files changed

+10
-1
lines changed

2 files changed

+10
-1
lines changed

docs/html/user_guide.rst

+9-1
Original file line numberDiff line numberDiff line change
@@ -1435,7 +1435,15 @@ install x y`` in a single command. We would like your thoughts on what
14351435
pip's behavior should be; please answer `our survey on upgrades that
14361436
create conflicts`_.
14371437

1438-
We are also changing our support for :ref:`Constraints Files`:
1438+
We are also changing our support for :ref:`Constraints Files` and related functionality:
1439+
1440+
* Constraints don't override the existing requirements; they simply
1441+
constrain what versions are visible as input to the resolver (see
1442+
:issue:`9020`)
1443+
1444+
* Hash-checking mode requires that all requirements are specified as a
1445+
`==` match on a version and may not work well in combination with
1446+
constraints (see :issue:`9020`)
14391447

14401448
* Unnamed requirements are not allowed as constraints (see :issue:`6628` and :issue:`8210`)
14411449
* Links are not allowed as constraints (see :issue:`8253`)

news/9056.doc.rst

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Improve migration guide to reflect changes in new resolver behavior.

0 commit comments

Comments
 (0)