Skip to content

Commit a77a5a7

Browse files
authored
Document use of the backtracking resolver (#1718)
1 parent cb7ce7d commit a77a5a7

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

README.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -572,6 +572,21 @@ This section lists ``pip-tools`` features that are currently deprecated.
572572
recommended to pass the ``--allow-unsafe`` now to adapt to the upcoming
573573
change.
574574

575+
A Note on Resolvers
576+
===================
577+
578+
You can choose from either the legacy or the backtracking resolver.
579+
The backtracking resolver is recommended, and will become the default
580+
with the 7.0 release.
581+
582+
Use it now with the ``--resolver=backtracking`` option to ``pip-compile``.
583+
584+
The legacy resolver will occasionally fail to resolve dependencies. The
585+
backtracking resolver is more robust, but can take longer to run in
586+
general.
587+
588+
You can continue using the legacy resolver with ``--resolver=legacy``.
589+
575590
Versions and compatibility
576591
==========================
577592

0 commit comments

Comments
 (0)