gimp/devel-docs/meson.build

devel_docs_build_root = meson.current_build_dir()

scan_args_common = [
  '--deprecated-guards=GIMP_DISABLE_DEPRECATED',
]

mkdb_args_common = [
  '--name-space=gimp',
]

if gi_docgen.found()
  subdir('reference')
endif

if get_option('g-ir-doc')
  subdir('g-ir-docs')
endif
Meson port. 2017-11-01 21:27:13 +08:00			`devel_docs_build_root = meson.current_build_dir()`

			`scan_args_common = [`
			`'--deprecated-guards=GIMP_DISABLE_DEPRECATED',`
			`]`

			`mkdb_args_common = [`
			`'--name-space=gimp',`
			`]`

configure, meson, devel-docs: make gi-docgen into an auto option. Also called "feature" option in meson, so that by default it depends on auto-detection of the gi-docgen hence won't break the configuration when the tool is missing (the feature is simply disabled). Also move the program check into the root meson file, which is anyway much better to have a better visibility of features, otherwise we'd end up just having tests everywhere in any possible random directory of the repo. Finally add a line in the summary of the configuration step, displaying the docs generation being enabled or disabled. 2021-12-29 07:55:17 +08:00			`if gi_docgen.found()`
docs: Migrate from gtk-doc to gi-docgen gtk-doc has been slowly dying for the past few years; with gi-docgen we have a nice successor. This also makes sure the C documentation also uses the GIR file, which in turn means faster build times (since all the C code doesn't have to be parsed and recompiled again), and has a clear dependency graph. See the [gi-docgen tutorial] for more info on how the system works. [gi-docgen tutorial]: https://gnome.pages.gitlab.gnome.org/gi-docgen/tutorial.html 2021-11-29 02:36:07 +08:00			`subdir('reference')`
Meson port. 2017-11-01 21:27:13 +08:00			`endif`

devel-docs, meson: g-ir-doc option to generate introspected API docs. Similar to the --enable-g-ir-doc option I just added on autotools. Also separate this option from gtk-doc as it is unrelated (not everything under devel-docs is related to gtk-doc!). 2021-01-29 23:51:47 +08:00			`if get_option('g-ir-doc')`
			`subdir('g-ir-docs')`
			`endif`