fwupd/docs/meson.build
Richard Hughes da6928fe76 Do not use globs when building docs
If we use an explicit file lists then the docs are regenerated when the source
files change.
2022-11-02 13:54:23 +00:00

106 lines
2.8 KiB
Meson

if gidocgen_dep.found() and docs_python_deps.allowed() and gidocgen_app.found() and introspection.allowed()
toml_conf = configuration_data()
docgen_version = source_version
if git.found() and source_version != fwupd_version
docgen_version = run_command(git, 'branch', '--show-current').stdout().strip()
endif
toml_conf.set('version', docgen_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_app,
'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'),
)
subdir('hsi-tests.d')
hsi_md = custom_target('generate-hsi-spec',
input: hsi_test_jsons,
output : 'hsi.md',
command : [
python3,
files(['generate-hsi-spec.py', 'hsi.md.in']),
'@OUTPUT@',
'@INPUT@',
],
)
custom_target('doc-fwupdplugin',
input: [
fwupdplugin_toml,
fwupdplugin_gir[0],
],
output: 'libfwupdplugin',
command: [
gidocgen_app,
'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_build_dir()),
'--content-dir=@0@'.format(meson.current_source_dir()),
'@INPUT1@',
],
depends: [
fwupdplugin_gir[0],
hsi_md,
],
build_by_default: true,
install: true,
install_dir: join_paths(datadir, 'doc'),
)
if hsi
install_data(['index.html', 'hsi.html'],
install_dir : join_paths(datadir, 'doc', 'fwupd')
)
endif
install_data(['urlmap_fwupd.js'],
install_dir: join_paths(datadir, 'doc', 'libfwupd')
)
install_data(['urlmap_fwupdplugin.js'],
install_dir: join_paths(datadir, 'doc', 'libfwupdplugin')
)
#make devhelp work
install_symlink('libfwupd',
install_dir: join_paths(datadir, 'doc', 'fwupd'),
pointing_to: join_paths('..', 'libfwupd'),
)
install_symlink('libfwupdplugin',
install_dir: join_paths(datadir, 'doc', 'fwupd'),
pointing_to: join_paths('..', 'libfwupdplugin'),
)
endif