1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2024-12-22 13:33:56 +03:00

meson: add custom targets man/man and man/html

This provides functionality similar to the ./configure --disable-manpages
switch. Man pages are built by default (if xsltproc is found), html pages
are not. Those default can be changed with -Dman=no, -Dhtml=yes/auto.
It is still possible to build one or the either, even if not configured, with
ninja-build man/man and ninja-build man/html.

v2:
- obey conditionals in index/directives list
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2017-04-05 22:46:03 -04:00
parent 04e3eb46e3
commit 527d43d701
2 changed files with 57 additions and 28 deletions

View File

@ -6,7 +6,13 @@ subdir('rules')
# TODO: add regeneration rule:
# python3 tools/make-man-rules.py --meson man/*xml > man/rules/meson.build
xsltproc = find_program('xsltproc')
want_man = get_option('man')
want_html = get_option('html')
xsltproc = find_program('xsltproc',
required : want_man == 'yes' or want_html == 'yes')
want_man = want_man != 'no' and xsltproc.found()
want_html = want_html != 'no' and xsltproc.found()
xsltproc_flags = [
'--nonet',
'--xinclude',
@ -19,13 +25,16 @@ xsltproc_flags = [
'@0@:@1@'.format(meson.current_build_dir(), meson.current_source_dir())]
custom_man_xsl = files('custom-man.xsl')
custom_html_xsl = files('custom-man.xsl')
custom_html_xsl = files('custom-html.xsl')
custom_entities_ent = configure_file(
input : 'custom-entities.ent.in',
output : 'custom-entities.ent',
configuration : conf)
man_pages = []
html_pages = []
source_xml_files = []
foreach tuple : manpages
stem = tuple[0]
section = tuple[1]
@ -45,36 +54,37 @@ foreach tuple : manpages
mandirn = get_option('mandir') + '/man' + section
install = condition == '' or conf.get(condition, 0) == 1
have = condition == '' or conf.get(condition, 0) == 1
custom_target(
man,
input : xml,
output : [man] + manaliases,
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_man_xsl, '@INPUT@'],
depend_files : custom_entities_ent,
install : install,
install_dir : mandirn)
if have
p1 = custom_target(
man,
input : xml,
output : [man] + manaliases,
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_man_xsl, '@INPUT@'],
depend_files : custom_entities_ent,
install : want_man,
install_dir : mandirn)
man_pages += [p1]
custom_target(
html,
input : xml,
output : [html] + htmlaliases,
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_html_xsl, '@INPUT@'],
depend_files : custom_entities_ent)
p2 = custom_target(
html,
input : xml,
output : [html] + htmlaliases,
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_html_xsl, '@INPUT@'],
depend_files : custom_entities_ent,
install : want_html,
install_dir : docdir + '/html')
html_pages += [p2]
if not install
message('Skipping @0@.@1@ because @2@ is @3@'.format(stem, section, condition, install))
source_xml_files += files(tuple[0] + '.xml')
else
message('Skipping @0@.@1@ because @2@ is @3@'.format(stem, section, condition, have))
endif
endforeach
############################################################
source_xml_files = files()
foreach tuple : manpages
source_xml_files += files(tuple[0] + '.xml')
endforeach
systemd_directives_xml = custom_target(
'systemd.directives.xml',
input : source_xml_files,
@ -99,17 +109,31 @@ foreach tuple : [['systemd.directives', '7', systemd_directives_xml],
mandirn = get_option('mandir') + '/man' + section
custom_target(
p1 = custom_target(
man,
input : xml,
output : man,
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_man_xsl, '@INPUT@'],
install : install,
install : want_man,
install_dir : mandirn)
man_pages += [p1]
custom_target(
p2 = custom_target(
html,
input : xml,
output : html,
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_html_xsl, '@INPUT@'])
command : [xsltproc, '-o', '@OUTPUT0@'] + xsltproc_flags + [custom_html_xsl, '@INPUT@'],
install : want_html,
install_dir : docdir + '/html')
html_pages += [p2]
endforeach
custom_target('man',
depends : man_pages,
output : ['man'],
command : ['echo'])
custom_target('html',
depends : html_pages,
output : ['html'],
command : ['echo'])

View File

@ -76,6 +76,11 @@ option('hwdb', type : 'boolean',
description : 'support for the hardware database')
option('rfkill', type : 'boolean',
description : 'support for the rfkill tools')
option('man', type : 'combo', choices : ['auto', 'yes', 'no'],
description : 'build and install man pages')
option('html', type : 'combo', choices : ['auto', 'yes', 'no'],
value : 'no',
description : 'build and install html pages')
option('certificate-root', type : 'string', value : '/etc/ssl',
description : 'the prefix for TLS certificates')