mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-01-29 21:08:42 +01:00
Code Issues Packages Projects Releases Wiki Activity

ref-manual: document meson class and variables

Browse Source 
(From yocto-docs rev: aacd49e5c72ac1506fc09790902c6047ccf26a02)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Michael Opdenacker
2023-02-16 15:07:02 +01:00
committed by Richard Purdie
parent 2b621b21bc
commit dc257d94fc
2 changed files with 35 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
documentation/ref-manual/classes.rst
View File

@@ -1651,6 +1651,16 @@ messages for various BitBake severity levels (i.e. ``bbplain``,
This class is enabled by default since it is inherited by the :ref:`ref-classes-base`
class.
.. _ref-classes-meson:
``meson``
=========
The :ref:`ref-classes-meson` class allows to create recipes that build software
using the `Meson <https://mesonbuild.com/>`__ build system. You can use
the :term:`MESON_BUILDTYPE` and :term:`EXTRA_OEMESON` variables to specify
additional configuration options to be passed using the ``meson`` command line.
.. _ref-classes-metadata_scm:
``metadata_scm``

25
documentation/ref-manual/variables.rst
View File

@@ -2528,6 +2528,20 @@ system and gives an overview of their function and contents.
variable specifies additional configuration options you want to pass
to the ``scons`` command line.
:term:`EXTRA_OEMESON`
Additional `Meson <https://mesonbuild.com/>`__ options. See the
:ref:`ref-classes-meson` class for additional information.
In addition to standard Meson options, such options correspond to
`Meson build options <https://mesonbuild.com/Build-options.html>`__
defined in the ``meson_options.txt`` file in the sources to build.
Here is an example::
EXTRA_OEMESON = "-Dpython=disabled -Dvalgrind=disabled"
Note that any custom value for the Meson ``--buildtype`` option
should be set through the :term:`MESON_BUILDTYPE` variable.
:term:`EXTRA_USERS_PARAMS`
When inheriting the :ref:`ref-classes-extrausers`
class, this variable provides image level user and group operations.
@@ -5138,6 +5152,17 @@ system and gives an overview of their function and contents.
:term:`MAINTAINER`
The email address of the distribution maintainer.
:term:`MESON_BUILDTYPE`
Value of the Meson ``--buildtype`` argument used by the
:ref:`ref-classes-meson` class. It defaults to ``debug`` if
:term:`DEBUG_BUILD` is set to "1", and ``plain`` otherwise.
See `Meson build options <https://mesonbuild.com/Builtin-options.html>`__
for the values you could set in a recipe. Values such as ``plain``,
``debug``, ``debugoptimized``, ``release`` and ``minsize`` allow
you to specify the inclusion of debugging symbols and the compiler
optimizations (none, performance or size).
:term:`METADATA_BRANCH`
The branch currently checked out for the OpenEmbedded-Core layer (path
determined by :term:`COREBASE`).