Document that using overrides disables all wheels

Update documentation to state that using command line options on any requirements will disable all usage of wheels. Since this is unexpected behavior, move text to a warning.
pypa · Sep 29, 2021 · 72e3e6c · 72e3e6c
1 parent 8ea2651
commit 72e3e6c
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 2 deletions.
diff --git a/docs/html/cli/pip_install.rst b/docs/html/cli/pip_install.rst
@@ -205,8 +205,12 @@ Per-requirement Overrides
 -------------------------
 
 Since version 7.0 pip supports controlling the command line options given to
-``setup.py`` via requirements files. This disables the use of wheels (cached or
-otherwise) for that package, as ``setup.py`` does not exist for wheels.
+``setup.py`` via requirements files.
+
+.. warning::
+
+   This disables the use of wheels (cached or otherwise),
+   as ``setup.py`` does not exist for wheels.
 
 The ``--global-option`` and ``--install-option`` options are used to pass
 options to ``setup.py``. For example:

diff --git a/news/9674.doc.rst b/news/9674.doc.rst
@@ -0,0 +1 @@
+Clarify that using per-requirement overrides disables the usage of wheels.