Skip to content

Commit

Permalink
DOC: remove examples in favor of linking to the meson-args page
Browse files Browse the repository at this point in the history
[skip cirrus]
  • Loading branch information
rgommers committed Mar 21, 2023
1 parent 667c9c4 commit cb1c86c
Showing 1 changed file with 3 additions and 18 deletions.
21 changes: 3 additions & 18 deletions docs/explanations/default-options.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.

0 comments on commit cb1c86c

Please sign in to comment.