mirror of
https://git.proxmox.com/git/fwupd
synced 2025-06-06 00:37:53 +00:00
716f41b7b2
There is no guarantee that Python environment used for the build contains the same `markdown` version as the one used for running `gi-docgen`. For example, Nixpkgs uses a self-contained Python environment for the latter, so `markdown` package is not even available in fwupd build environment. Fortunately, gi-docgen 2022.2 already checks for `markdown` version so we can omit our own check for newer gi-docgen versions.
106 lines
2.7 KiB
Meson
106 lines
2.7 KiB
Meson
if build_docs 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
|