Skip to content

Commit a498c13

Browse files
authored
Merge pull request #9174 from pradyunsg/tweaks-to-migration-guide
Expand on troubleshooting steps in resolver migration guide
2 parents 502b4b1 + 9c8dfdd commit a498c13

File tree

1 file changed

+15
-4
lines changed

1 file changed

+15
-4
lines changed

docs/html/user_guide.rst

+15-4
Original file line numberDiff line numberDiff line change
@@ -1747,10 +1747,21 @@ How to upgrade and migrate
17471747
deliver part of your functionality, please test your integration
17481748
with pip 20.3.
17491749

1750-
4. **Temporarily use the old resolver when necessary.** If you run
1751-
into resolution errors and need a workaround while you're fixing
1752-
their root causes, you can choose the old resolver behavior
1753-
using the flag ``--use-deprecated=legacy-resolver``.
1750+
4. **Troubleshoot and try these workarounds if necessary.**
1751+
1752+
- If pip is taking longer to install packages, read
1753+
:ref:`Dependency resolution backtracking` for ways to reduce the
1754+
time pip spends backtracking due to dependency conflicts.
1755+
- If you don't want pip to actually resolve dependencies, use the
1756+
``--no-deps`` option. This is useful when you have a set of package
1757+
versions that work together in reality, even though their metadata says
1758+
that they conflict. For guidance on a long-term fix, read
1759+
:ref:`Fixing conflicting dependencies`.
1760+
- If you run into resolution errors and need a workaround while you're
1761+
fixing their root causes, you can choose the old resolver behavior using
1762+
the flag ``--use-deprecated=legacy-resolver``. This will work until we
1763+
release pip 21.0 (see
1764+
:ref:`Deprecation timeline for 2020 resolver changes`).
17541765

17551766
5. **Please report bugs** through the `resolver testing survey`_.
17561767

0 commit comments

Comments
 (0)