blob: 5750f7028d3d146df7eb4983844096e3fd26b69c [file] [log] [blame]
William A. Kennington IIIac69b482021-06-02 12:28:27 -07001# gi-docgen is a new gnome documentation generator, which
2# seems to be a successor to gtk-doc:
3# https://gitlab.gnome.org/GNOME/gi-docgen
4
5# This variable is set to True if api-documentation is in
6# DISTRO_FEATURES, and False otherwise.
7GIDOCGEN_ENABLED ?= "${@bb.utils.contains('DISTRO_FEATURES', 'api-documentation', 'True', 'False', d)}"
8# When building native recipes, disable gi-docgen, as it is not necessary,
9# pulls in additional dependencies, and makes build times longer
10GIDOCGEN_ENABLED_class-native = "False"
11GIDOCGEN_ENABLED_class-nativesdk = "False"
12
13# meson: default option name to enable/disable gi-docgen. This matches most
14# projects' configuration. In doubts - check meson_options.txt in project's
15# source path.
16GIDOCGEN_MESON_OPTION ?= 'gtk_doc'
17GIDOCGEN_MESON_ENABLE_FLAG ?= 'true'
18GIDOCGEN_MESON_DISABLE_FLAG ?= 'false'
19
20# Auto enable/disable based on GIDOCGEN_ENABLED
21EXTRA_OEMESON_prepend = "-D${GIDOCGEN_MESON_OPTION}=${@bb.utils.contains('GIDOCGEN_ENABLED', 'True', '${GIDOCGEN_MESON_ENABLE_FLAG}', '${GIDOCGEN_MESON_DISABLE_FLAG}', d)} "
22
23DEPENDS_append = "${@' gi-docgen-native gi-docgen' if d.getVar('GIDOCGEN_ENABLED') == 'True' else ''}"
24