Merge d6965c09c4 into a15dd75d98

docs/html/cli/pip_install.rst

@@ -45,8 +45,8 @@ When looking at the items to be installed, pip checks what type of item
 each is, in the following order:
 
 1. Project or archive URL.
-2. Local directory (which must contain a ``setup.py``, or pip will report
-   an error).
+2. Local directory (which must contain a ``pyproject.toml`` or ``setup.py``,
+   otherwise pip will report an error).
 3. Local file (a sdist or wheel format archive, following the naming
    conventions for those formats).
 4. A requirement, as specified in :pep:`440`.

news/12417.doc.rst

@@ -0,0 +1 @@
+Fix outdated pip install argument description in documentation.

tests/functional/test_install_extras.py

@@ -186,6 +186,8 @@ def test_install_special_extra(
         extras={specified_extra: ["missing_pkg"]},
     )
 
+    print(script.pip("list").stdout)
+
     result = script.pip(
         "install",
         "--no-index",