qemu/docs/meson.build

1 sphinx_build = find_program(fs.parent(python.full_path()) / 'sphinx-build',
7   SPHINX_ARGS = ['env', 'CONFDIR=' + qemu_confdir, sphinx_build, '-q']
10     SPHINX_ARGS += [ '-W', '-Dkerneldoc_werror=1' ]
13   sphinx_version = run_command(SPHINX_ARGS + ['--version'],
16     SPHINX_ARGS += ['-j', 'auto']
21       SPHINX_ARGS += ['-j', jobs]
27   # version requirement). This will fail if sphinx-build is too old.
28   run_command('mkdir', ['-p', tmpdir / 'sphinx'], check: true)
31     '-c', meson.current_source_dir(),
32     '-b', 'html', tmpdir / 'sphinx',
39       error('Install a Python 3 version of python-sphinx and the readthedoc theme')
45   SPHINX_ARGS += ['-Dversion=' + meson.project_version(), '-Drelease=' + get_option('pkgversion')]
48         'qemu-ga.8': (have_ga ? 'man8' : ''),
49         'qemu-ga-ref.7': (have_ga ? 'man7' : ''),
50         'qemu-qmp-ref.7': 'man7',
51         'qemu-storage-daemon-qmp-ref.7': (have_tools ? 'man7' : ''),
52         'qemu-img.1': (have_tools ? 'man1' : ''),
53         'qemu-nbd.8': (have_tools ? 'man8' : ''),
54         'qemu-pr-helper.8': (have_tools ? 'man8' : ''),
55         'qemu-storage-daemon.1': (have_tools ? 'man1' : ''),
56         'qemu-trace-stap.1': (stap.found() ? 'man1' : ''),
58         'qemu-block-drivers.7': 'man7',
59         'qemu-cpu-models.7': 'man7'
74                 command: [SPHINX_ARGS, '-Ddepfile=@DEPFILE@',
75                           '-Ddepfile_stamp=@OUTPUT0@',
76                           '-b', 'html', '-d', private_dir,
88   sphinxmans += custom_target('QEMU man pages',
94                               command: [SPHINX_ARGS, '-b', 'man', '-d', private_dir,
99   alias_target('man', sphinxmans)  run
103      args: ['-o', meson.current_build_dir() / 'qapi',
105      suite: ['qapi-schema', 'qapi-interop'])