Merge pull request #10588 from tusharsadhwani/main

Author: uranusjr

news/10588.feature.rst

@@ -0,0 +1 @@
+Documents the ``--require-virtualenv`` flag for ``pip install``.

src/pip/_internal/cli/cmdoptions.py

@@ -177,13 +177,15 @@ class PipOption(Option):
 
 require_virtualenv: Callable[..., Option] = partial(
     Option,
-    # Run only if inside a virtualenv, bail if not.
     "--require-virtualenv",
     "--require-venv",
     dest="require_venv",
     action="store_true",
     default=False,
-    help=SUPPRESS_HELP,
+    help=(
+        "Allow pip to only run in a virtual environment; "
+        "exit with an error otherwise."
+    ),
 )
 
 verbose: Callable[..., Option] = partial(