path: root/doc/guides/contributing/coding_style.rst
diff options
authorBruce Richardson <>2019-06-05 21:22:39 +0100
committerThomas Monjalon <>2019-07-02 23:20:26 +0200
commit8baad6f884d687e30097dd5b5f23ec973b0a3e0a (patch)
treed1deb8c5078e907fb6b1d4ed56cbadf8dcabe4b9 /doc/guides/contributing/coding_style.rst
parent291d090364fc0b0cefb0d91cca896e336b6f6331 (diff)
build: print list of disabled components
When configuring with meson we print out a list of enabled components, but it is also useful to list out the disabled components and the reasons why. Signed-off-by: Bruce Richardson <> Acked-by: Luca Boccassi <>
Diffstat (limited to 'doc/guides/contributing/coding_style.rst')
1 files changed, 14 insertions, 1 deletions
diff --git a/doc/guides/contributing/coding_style.rst b/doc/guides/contributing/coding_style.rst
index a5d5897..449b334 100644
--- a/doc/guides/contributing/coding_style.rst
+++ b/doc/guides/contributing/coding_style.rst
@@ -852,12 +852,15 @@ allow_experimental_apis
**Default Value = true**
Used to optionally compile a library, based on its dependencies or
- environment. A simple example of use would be:
+ environment. When set to "false" the ``reason`` value, explained below, should
+ also be set to explain to the user why the component is not being built.
+ A simple example of use would be:
.. code-block:: python
if not is_linux
build = false
+ reason = 'only supported on Linux'
@@ -938,6 +941,13 @@ objs
objects that were compiled up as part of another target given in the
included library ```` file.
+ **Default Value = '<unknown reason>'**.
+ This variable should be used when a library is not to be built i.e. when
+ ``build`` is set to "false", to specify the reason why a library will not be
+ built. For missing dependencies this should be of the form
+ ``'missing dependency, "libname"'``.
**Default Value = 1**.
Specifies the ABI version of the library, and is used as the major
@@ -991,6 +1001,9 @@ pkgconfig_extra_libs
using static libraries. Anything added here will be appended to the end
of the ``pkgconfig --libs`` output.
+ As above.
sources [mandatory]
As above