Merge pull request #11560 from froli-code/10265-updated-documentation-install-options

Fixes #10265

Author: uranusjr

news/10265.bugfix.rst

@@ -0,0 +1 @@
+Fixed the description of the option "--install-options" in the documentation

src/pip/_internal/cli/cmdoptions.py

@@ -825,11 +825,9 @@ def _handle_config_settings(
     dest="install_options",
     action="append",
     metavar="options",
-    help="Extra arguments to be supplied to the setup.py install "
-    'command (use like --install-option="--install-scripts=/usr/local/'
-    'bin"). Use multiple --install-option options to pass multiple '
-    "options to setup.py install. If you are using an option with a "
-    "directory path, be sure to use absolute path.",
+    help="This option is deprecated. Using this option with location-changing "
+    "options may cause unexpected behavior. "
+    "Use pip-level options like --user, --prefix, --root, and --target.",
 )
 
 build_options: Callable[..., Option] = partial(