DOC: assume pip 23.1 or later in examples

Add a note about the command line syntax for older versions.

Author: dnicolodi

docs/how-to-guides/config-settings.rst

@@ -35,8 +35,9 @@ the ``-C`` short command line option:
       .. code-block:: console
 
 	 $ python -m pip wheel . \
-               --config-settings=setup-args="-Doption=disable" \
-               --config-settings=compile-args="-j6"
+               -Csetup-args="-Doption=true" \
+               -Csetup-args="-Dvalue=1" \
+               -Ccompile-args="-j6"
 
 
 Refer to the `build`_ and `pip`_ documentation for details.  This
@@ -46,15 +47,16 @@ immediately install it, replace ``wheel`` with ``install``.  See the
 :ref:`how-to-guides-meson-args` guide for more examples.
 
 
-.. admonition:: Passing multiple settings
+.. admonition:: Older pip versions
    :class: caution
 
-   Please note that ``pip`` prior to 23.1 did not offer a way to set a
-   build config setting to a list of strings: later values for the
-   same key passed to ``--config-settings`` override earlier ones,
-   effectively limiting the number of options that can be passed to
-   each command invoked in the build process to one. This limitation
-   has been lifted in ``pip`` release 23.1.
+   Please note that prior to version 23.1 ``pip`` did not support the ``-C``
+   short command line switch for the ``--config-settings`` options and did not
+   offer a way to set a build config setting to a list of strings: later
+   values for the same key passed to ``--config-settings`` override earlier
+   ones, effectively limiting the number of options that can be passed to each
+   command invoked in the build process to one. This limitation has been
+   lifted in ``pip`` release 23.1.
 
 
 .. _build: https://pypa-build.readthedocs.io/en/stable/

docs/how-to-guides/editable-installs.rst

@@ -178,4 +178,4 @@ set to a non-null value when installing the package:
 
 .. code-block:: console
 
-   $ python -m pip install --no-build-isolation --config-settings=editable-verbose=true --editable .
+   $ python -m pip install --no-build-isolation -Ceditable-verbose=true --editable .

docs/how-to-guides/meson-args.rst

@@ -90,7 +90,7 @@ To set this option temporarily at build-time:
 
       .. code-block:: console
 
-         $ python -m pip wheel --config-settings=setup-args="--default-library=static" .
+         $ python -m pip wheel -Csetup-args="--default-library=static" .
 
 
 Select the build targets to include in the wheel
@@ -132,7 +132,7 @@ To set this option temporarily at build-time:
 
       .. code-block:: console
 
-         $ python -m pip wheel --config-settings=install-args="--tags=runtime,python-runtime" .
+         $ python -m pip wheel -Cinstall-args="--tags=runtime,python-runtime" .
 
 
 Set the build optimization level
@@ -165,7 +165,7 @@ To set this option temporarily at build-time:
 
       .. code-block:: console
 
-         $ python -m pip wheel --config-settings=setup-args="-Doptimization=3" .
+         $ python -m pip wheel -Csetup-args="-Doptimization=3" .
 
 
 .. _vsenv-example:
@@ -206,4 +206,4 @@ To set this option temporarily at build-time:
 
       .. code-block:: console
 
-	 $ python -m pip wheel --config-settings=setup-args="--vsenv" .
+	 $ python -m pip wheel -Csetup-args="--vsenv" .