DOC: minor tweak to docs on invoking pip/build

Addresses a comment on issue 704, where a user got tripped up
by `python -m build` building an sdist first (and that's typically
not what you want).

Author: rgommers

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

@@ -24,7 +24,7 @@ the ``-C`` short command line option:
 
 	.. code-block:: console
 
-	   $ python -m build \
+	   $ python -m build --wheel \
                -Csetup-args="-Doption=true" \
                -Csetup-args="-Dvalue=1" \
                -Ccompile-args="-j6"
@@ -34,6 +34,7 @@ the ``-C`` short command line option:
 
 	.. code-block:: console
 
+       $ # note: pip >=23.1 also accepts -C instead of --config-settings
 	   $ python -m pip wheel . \
                --config-settings=setup-args="-Doption=disable" \
                --config-settings=compile-args="-j6"
@@ -78,7 +79,7 @@ user-specified build directory which will not be deleted. For example:
 
 	.. code-block:: console
 
-	   $ python -m build -Cbuild-dir=build
+	   $ python -m build --wheel -Cbuild-dir=build
 
     .. tab-item:: pip
         :sync: key_pip

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

@@ -83,7 +83,7 @@ To set this option temporarily at build-time:
 
         .. code-block:: console
 
-           $ python -m build -Csetup-args="--default-library=static" .
+           $ python -m build -Csetup-args="--default-library=static" --wheel .
 
     .. tab-item:: pip
         :sync: key_pip
@@ -125,7 +125,7 @@ To set this option temporarily at build-time:
 
         .. code-block:: console
 
-	   $ python -m build -Cinstall-args="--tags=runtime,python-runtime" .
+	   $ python -m build -Cinstall-args="--tags=runtime,python-runtime" --wheel .
 
     .. tab-item:: pip
         :sync: key_pip
@@ -158,7 +158,7 @@ To set this option temporarily at build-time:
 
         .. code-block:: console
 
-	   $ python -m build -Csetup-args="-Doptimization=3" .
+	   $ python -m build -Csetup-args="-Doptimization=3" --wheel .
 
     .. tab-item:: pip
         :sync: key_pip
@@ -199,7 +199,7 @@ To set this option temporarily at build-time:
 
         .. code-block:: console
 
-	   $ python -m build -Csetup-args="--vsenv" .
+	   $ python -m build -Csetup-args="--vsenv" --wheel .
 
     .. tab-item:: pip
         :sync: key_pip

docs/tutorials/introduction.rst

@@ -242,6 +242,9 @@ dependencies, and ask ``meson-python`` to build the artifacts.
    $ python -m build
 
 If the build succeeded, you'll have the binary artifacts in the ``dist`` folder.
+Note that by default, ``python -m build`` builds an sdist first, and then a
+wheel from the sdist. If you only want one artifact, add ``--sdist`` or
+``--wheel`` to the invocation.
 
 .. admonition:: Building wheels for multiple platforms
    :class: tip