mirror of
https://github.com/xemu-project/xemu.git
synced 2025-04-02 11:11:48 -04:00
db16115f87
Convert qemu-ga-ref to rST format. This includes dropping the plain-text, pdf and info format outputs for this document; as with all our other Sphinx-based documentation, we provide HTML and manpage only. The qemu-ga-ref.rst is somewhat more stripped down than the .texi was, because we do not (currently) attempt to generate indexes for the commands, events and data types being documented. As the GA ref is now part of the Sphinx 'interop' manual, we can delete the direct link from index.html.in. Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Message-Id: <20200925162316.21205-9-peter.maydell@linaro.org> Reviewed-by: Markus Armbruster <armbru@redhat.com> [Unicode legacy literal dumbed down to plain string literal, TODO comment on displaying QEMU version added] Signed-off-by: Markus Armbruster <armbru@redhat.com>
74 lines
2.7 KiB
Meson
74 lines
2.7 KiB
Meson
SPHINX_ARGS = [config_host['SPHINX_BUILD'],
|
|
'-Dversion=' + meson.project_version(),
|
|
'-Drelease=' + config_host['PKGVERSION']]
|
|
|
|
if get_option('werror')
|
|
SPHINX_ARGS += [ '-W' ]
|
|
endif
|
|
|
|
if build_docs
|
|
configure_file(output: 'index.html',
|
|
input: files('index.html.in'),
|
|
configuration: {'VERSION': meson.project_version()},
|
|
install_dir: qemu_docdir)
|
|
manuals = [ 'devel', 'interop', 'tools', 'specs', 'system', 'user' ]
|
|
man_pages = {
|
|
'interop' : {
|
|
'qemu-ga.8': (have_tools ? 'man8' : ''),
|
|
'qemu-ga-ref.7': 'man7',
|
|
},
|
|
'tools': {
|
|
'qemu-img.1': (have_tools ? 'man1' : ''),
|
|
'qemu-nbd.8': (have_tools ? 'man8' : ''),
|
|
'qemu-trace-stap.1': (config_host.has_key('CONFIG_TRACE_SYSTEMTAP') ? 'man1' : ''),
|
|
'virtfs-proxy-helper.1': (have_virtfs_proxy_helper ? 'man1' : ''),
|
|
'virtiofsd.1': (have_virtiofsd ? 'man1' : ''),
|
|
},
|
|
'system': {
|
|
'qemu.1': 'man1',
|
|
'qemu-block-drivers.7': 'man7',
|
|
'qemu-cpu-models.7': 'man7'
|
|
},
|
|
}
|
|
|
|
sphinxdocs = []
|
|
sphinxmans = []
|
|
foreach manual : manuals
|
|
private_dir = meson.current_build_dir() / (manual + '.p')
|
|
output_dir = meson.current_build_dir() / manual
|
|
input_dir = meson.current_source_dir() / manual
|
|
|
|
this_manual = custom_target(manual + ' manual',
|
|
build_by_default: build_docs,
|
|
output: [manual + '.stamp'],
|
|
input: [files('conf.py'), files(manual / 'conf.py')],
|
|
depfile: manual + '.d',
|
|
command: [SPHINX_ARGS, '-Ddepfile=@DEPFILE@',
|
|
'-Ddepfile_stamp=@OUTPUT0@',
|
|
'-b', 'html', '-d', private_dir,
|
|
input_dir, output_dir])
|
|
sphinxdocs += this_manual
|
|
if build_docs and manual != 'devel'
|
|
install_subdir(output_dir, install_dir: qemu_docdir)
|
|
endif
|
|
|
|
these_man_pages = []
|
|
install_dirs = []
|
|
foreach page, section : man_pages.get(manual, {})
|
|
these_man_pages += page
|
|
install_dirs += section == '' ? false : get_option('mandir') / section
|
|
endforeach
|
|
if these_man_pages.length() > 0
|
|
sphinxmans += custom_target(manual + ' man pages',
|
|
build_by_default: build_docs,
|
|
output: these_man_pages,
|
|
input: this_manual,
|
|
install: build_docs,
|
|
install_dir: install_dirs,
|
|
command: [SPHINX_ARGS, '-b', 'man', '-d', private_dir,
|
|
input_dir, meson.current_build_dir()])
|
|
endif
|
|
endforeach
|
|
alias_target('sphinxdocs', sphinxdocs)
|
|
alias_target('man', sphinxmans)
|
|
endif
|