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 · Mar 3, 2021 · 6dc5cd8 · 6dc5cd8
1 parent e7d6e54
commit 6dc5cd8
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.