mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-07 18:06:15 +01:00
aa28326b87
Now that the reference documentation uses gi-docgen, it's more troublesome to generate in less standard build scenarios like cross-compiling. In distributions like Debian, reference documentation is generally packaged separately (in libglib2.0-doc in Debian's case), but man pages are generally packaged alongside the executables themselves (in the libglib2.0-bin and libglib2.0-dev-bin packages, in Debian's case). We can exclude the reference documentation when cross-compiling, but ideally we would like the man pages to still be built, so that a cross-compiled libglib2.0-bin or libglib2.0-dev-bin package has the same content as a native build. Signed-off-by: Simon McVittie <smcv@debian.org>
65 lines
1.6 KiB
Meson
65 lines
1.6 KiB
Meson
if get_option('man-pages').enabled()
|
|
manpages = ['gapplication', 'gio-querymodules', 'glib-compile-schemas',
|
|
'glib-compile-resources', 'gsettings', 'gresource', 'gdbus',
|
|
'gio', 'gdbus-codegen']
|
|
foreach page : manpages
|
|
custom_target(page + '-man',
|
|
input: page + '.rst',
|
|
output: page + '.1',
|
|
command: [
|
|
rst2man,
|
|
rst2man_flags,
|
|
'@INPUT@',
|
|
],
|
|
capture: true,
|
|
install: true,
|
|
install_dir: man1_dir,
|
|
install_tag: 'doc',
|
|
)
|
|
endforeach
|
|
endif
|
|
|
|
if get_option('documentation') and enable_gir
|
|
expand_content_files = [
|
|
'dbus-error.md',
|
|
'dbus-introspection.md',
|
|
'dbus-name-owning.md',
|
|
'dbus-name-watching.md',
|
|
'dbus-utils.md',
|
|
'error.md',
|
|
'file-attributes.md',
|
|
'io-scheduler.md',
|
|
'menu-exporter.md',
|
|
'migrating-gconf.md',
|
|
'migrating-gdbus.md',
|
|
'migrating-gnome-vfs.md',
|
|
'migrating-posix.md',
|
|
'networking.md',
|
|
'overview.md',
|
|
'pollable-utils.md',
|
|
'tls-overview.md',
|
|
'unix-mounts.md',
|
|
]
|
|
|
|
gio_toml = configure_file(input: 'gio.toml.in', output: 'gio.toml', configuration: toml_conf)
|
|
|
|
custom_target('gio-docs',
|
|
input: [ gio_toml, gio_gir[0] ],
|
|
output: 'gio',
|
|
command: [
|
|
gidocgen,
|
|
'generate',
|
|
gidocgen_common_args,
|
|
'--config=@INPUT0@',
|
|
'--output-dir=@OUTPUT@',
|
|
'--content-dir=@0@'.format(meson.current_source_dir()),
|
|
'@INPUT1@',
|
|
],
|
|
build_by_default: true,
|
|
depend_files: expand_content_files,
|
|
install: true,
|
|
install_dir: docs_dir,
|
|
install_tag: 'doc',
|
|
)
|
|
endif
|