fwupd/docs/meson.build
Mario Limonciello 1e17457b16 Allow building the documentation with gi-docgen and gtk-doc
Until gi-docgen is declared stable support either of them.
This effectively means that hand builds and CI builds will use
gi-docgen, but distro builds use gtk-doc-tools.
2021-06-09 22:21:53 +01:00

81 lines
2.0 KiB
Meson

if get_option('docs') == 'docgen'
toml_conf = configuration_data()
toml_conf.set('version', meson.project_version())
fwupd_toml = configure_file(
input: 'fwupd.toml.in',
output: 'fwupd.toml',
configuration: toml_conf
)
fwupdplugin_toml = configure_file(
input: 'fwupdplugin.toml.in',
output: 'fwupdplugin.toml',
configuration: toml_conf
)
custom_target('doc-fwupd',
input: [
fwupd_toml,
fwupd_gir[0],
],
output: 'libfwupd',
command: [
gidocgen,
'generate',
'--quiet',
'--add-include-path=@0@'.format(meson.current_build_dir() / '../libfwupd'),
'--config=@INPUT0@',
'--output-dir=@OUTPUT@',
'--no-namespace-dir',
'--content-dir=@0@'.format(meson.current_source_dir()),
'@INPUT1@',
],
depends: [
fwupd_gir[0],
],
build_by_default: true,
install: true,
install_dir: join_paths(datadir, 'doc', 'fwupd'),
)
custom_target('doc-fwupdplugin',
input: [
fwupdplugin_toml,
fwupdplugin_gir[0],
],
output: 'libfwupdplugin',
command: [
gidocgen,
'generate',
'--quiet',
'--add-include-path=@0@'.format(meson.current_build_dir() / '../libfwupd'),
'--add-include-path=@0@'.format(meson.current_build_dir() / '../libfwupdplugin'),
'--config=@INPUT0@',
'--output-dir=@OUTPUT@',
'--no-namespace-dir',
'--content-dir=@0@'.format(meson.current_source_dir()),
'@INPUT1@',
],
depends: [
fwupdplugin_gir[0],
],
build_by_default: true,
install: true,
install_dir: join_paths(datadir, 'doc', 'fwupd'),
)
elif get_option('docs') == 'gtkdoc'
gnome.gtkdoc(
'fwupd',
src_dir : [
join_paths(meson.source_root(), 'libfwupd'),
join_paths(meson.source_root(), 'libfwupdplugin'),
join_paths(meson.build_root(), 'libfwupd'),
join_paths(meson.build_root(), 'libfwupdplugin'),
join_paths(meson.current_source_dir()),
],
main_xml : 'fwupd-docs.xml',
install : true
)
endif