Document that using overrides disables all wheels

See #4118. 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 · Mar 1, 2021 · f6e29fd · f6e29fd
1 parent e7d6e54
commit f6e29fd
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 2 deletions.
diff --git a/docs/html/reference/pip_install.rst b/docs/html/reference/pip_install.rst
@@ -315,8 +315,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.