From cb1c86cd10b51f1f9d776be6ed029614cf149bf0 Mon Sep 17 00:00:00 2001 From: Ralf Gommers Date: Tue, 21 Mar 2023 20:24:42 +0000 Subject: [PATCH] DOC: remove examples in favor of linking to the meson-args page [skip cirrus] --- docs/explanations/default-options.rst | 21 +++------------------ 1 file changed, 3 insertions(+), 18 deletions(-) diff --git a/docs/explanations/default-options.rst b/docs/explanations/default-options.rst index 9ea14d521..f04e39fe7 100644 --- a/docs/explanations/default-options.rst +++ b/docs/explanations/default-options.rst @@ -44,21 +44,6 @@ Let's go through each option and why they are used: because Meson defaults to values that are appropriate for development, while the main purpose of meson-python is to build release artifacts. -It is possible to override these defaults, either permanently in your project -or at build time. For example, to build a wheel with debug symbols, use: - -.. code-block:: console - - $ python -m build -Csetup-args=-Ddebug=true - -And to override all debug and optimization settings permanently, add this to -your ``pyproject.toml`` file: - -.. code-block:: toml - - [tool.meson-python.args] - setup = ['-Ddebug=true', '-Doptimization=0', '-Db_ndebug=false'] - -For more details on overriding build options at build time see the -:ref:`reference-config-settings` page, and in ``pyproject.toml`` see the -:ref:`reference-pyproject-settings` page. +It is possible to override these defaults, either permanently in your +``pyproject.toml`` or at build time via the build frontend CLI. +See the :ref:`how-to-guides-meson-args` page for examples of both methods.