Add additional info to MesonPackage docs (#10133)
* Add additional info to MesonPackage docs * No Pygments lexer for Meson code, default to none
This commit is contained in:
parent
b091fcdb8e
commit
c1a99bf8ec
1 changed files with 44 additions and 0 deletions
|
@ -54,6 +54,28 @@ Packages that use the Meson build system can be identified by the
|
||||||
presence of a ``meson.build`` file. This file declares things
|
presence of a ``meson.build`` file. This file declares things
|
||||||
like build instructions and dependencies.
|
like build instructions and dependencies.
|
||||||
|
|
||||||
|
One thing to look for is the ``meson_version`` key that gets passed
|
||||||
|
to the ``project`` function:
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
:emphasize-lines: 10
|
||||||
|
|
||||||
|
project('gtk+', 'c',
|
||||||
|
version: '3.94.0',
|
||||||
|
default_options: [
|
||||||
|
'buildtype=debugoptimized',
|
||||||
|
'warning_level=1',
|
||||||
|
# We only need c99, but glib needs GNU-specific features
|
||||||
|
# https://github.com/mesonbuild/meson/issues/2289
|
||||||
|
'c_std=gnu99',
|
||||||
|
],
|
||||||
|
meson_version: '>= 0.43.0',
|
||||||
|
license: 'LGPLv2.1+')
|
||||||
|
|
||||||
|
|
||||||
|
This means that Meson 0.43.0 is the earliest release that will work.
|
||||||
|
You should specify this in a ``depends_on`` statement.
|
||||||
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
Build system dependencies
|
Build system dependencies
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
@ -67,6 +89,28 @@ the ``MesonPackage`` base class already contains:
|
||||||
depends_on('meson', type='build')
|
depends_on('meson', type='build')
|
||||||
depends_on('ninja', type='build')
|
depends_on('ninja', type='build')
|
||||||
|
|
||||||
|
|
||||||
|
If you need to specify a particular version requirement, you can
|
||||||
|
override this in your package:
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
depends_on('meson@0.43.0:', type='build')
|
||||||
|
depends_on('ninja', type='build')
|
||||||
|
|
||||||
|
|
||||||
|
^^^^^^^^^^^^^^^^^^^
|
||||||
|
Finding meson flags
|
||||||
|
^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
To get a list of valid flags that can be passed to ``meson``, run the
|
||||||
|
following command in the directory that contains ``meson.build``:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ meson setup --help
|
||||||
|
|
||||||
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
Passing arguments to meson
|
Passing arguments to meson
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
Loading…
Reference in a new issue