File: config-settings.rst

package info (click to toggle)
meson-python 0.18.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,264 kB
  • sloc: python: 3,005; ansic: 326; makefile: 8
file content (48 lines) | stat: -rw-r--r-- 1,507 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
.. SPDX-FileCopyrightText: 2023 The meson-python developers
..
.. SPDX-License-Identifier: MIT

.. _reference-config-settings:

*********************
Build config settings
*********************

This page lists the build configuration settings, that is, the
settings you can pass when building the project. Please refer to the
:ref:`how-to-guides-config-settings` and
:ref:`how-to-guides-meson-args` guides for information on how to use
them.

.. option:: build-dir

   By default ``meson-python`` uses a temporary build directory.
   This settings allows to select the Meson build directory and
   prevents it to be deleted when ``meson-python`` terminates.  If the
   directory does not exists, it will be created.  If the directory
   exists and contains a valid Meson build directory setup, the
   project will be reconfigured using ``meson setup --reconfigure``.

   For backward compatibility reasons, the alternative ``builddir``
   spelling is also accepted.

.. option:: dist-args

   Extra arguments to be passed to the ``meson dist`` command.

.. option:: setup-args

   Extra arguments to be passed to the ``meson setup`` command.

.. option:: compile-args

   Extra arguments to be passed to the ``ninja`` command.

.. option:: install-args

   Extra arguments to be passed to the ``meson install`` command.

.. option:: editable-verbose

   Enable :ref:`verbose mode <how-to-guides-editable-installs-verbose>`
   when building for an :ref:`editable install <how-to-guides-editable-installs>`.