1e3667660SYonggang Luoif get_option('sphinx_build') == '' 2e3667660SYonggang Luo sphinx_build = find_program(['sphinx-build-3', 'sphinx-build'], 3e3667660SYonggang Luo required: get_option('docs')) 4e3667660SYonggang Luoelse 5e3667660SYonggang Luo sphinx_build = find_program(get_option('sphinx_build'), 6e3667660SYonggang Luo required: get_option('docs')) 7e3667660SYonggang Luoendif 8e3667660SYonggang Luo 9e3667660SYonggang Luo# Check if tools are available to build documentation. 10e3667660SYonggang Luobuild_docs = false 11e3667660SYonggang Luoif sphinx_build.found() 122e880198SDaniel P. Berrangé SPHINX_ARGS = ['env', 'CONFDIR=' + qemu_confdir, sphinx_build, '-q'] 13e3667660SYonggang Luo # If we're making warnings fatal, apply this to Sphinx runs as well 14e3667660SYonggang Luo if get_option('werror') 15e3667660SYonggang Luo SPHINX_ARGS += [ '-W' ] 16e3667660SYonggang Luo endif 17e3667660SYonggang Luo 18e3667660SYonggang Luo # This is a bit awkward but works: create a trivial document and 19e3667660SYonggang Luo # try to run it with our configuration file (which enforces a 20e3667660SYonggang Luo # version requirement). This will fail if sphinx-build is too old. 21b20a7ee6SPaolo Bonzini run_command('mkdir', ['-p', tmpdir / 'sphinx'], check: true) 22b20a7ee6SPaolo Bonzini run_command('touch', [tmpdir / 'sphinx/index.rst'], check: true) 23e3667660SYonggang Luo sphinx_build_test_out = run_command(SPHINX_ARGS + [ 24e3667660SYonggang Luo '-c', meson.current_source_dir(), 25e3667660SYonggang Luo '-b', 'html', tmpdir / 'sphinx', 26b20a7ee6SPaolo Bonzini tmpdir / 'sphinx/out'], check: false) 27e3667660SYonggang Luo build_docs = (sphinx_build_test_out.returncode() == 0) 28e3667660SYonggang Luo 29e3667660SYonggang Luo if not build_docs 3073e6aec6SMarc-André Lureau warning('@0@: @1@'.format(sphinx_build.full_path(), sphinx_build_test_out.stderr())) 31e3667660SYonggang Luo if get_option('docs').enabled() 3273e6aec6SMarc-André Lureau error('Install a Python 3 version of python-sphinx and the readthedoc theme') 33e3667660SYonggang Luo endif 34e3667660SYonggang Luo endif 35e3667660SYonggang Luoendif 36e3667660SYonggang Luo 37f8aa24eaSPaolo Bonziniif build_docs 38*b0b4323eSPaolo Bonzini SPHINX_ARGS += ['-Dversion=' + meson.project_version(), '-Drelease=' + get_option('pkgversion')] 39e3667660SYonggang Luo 40f8aa24eaSPaolo Bonzini man_pages = { 41e0f7fc58SStefan Reiter 'qemu-ga.8': (have_ga ? 'man8' : ''), 42e0f7fc58SStefan Reiter 'qemu-ga-ref.7': (have_ga ? 'man7' : ''), 434ac2ee19SPeter Maydell 'qemu-qmp-ref.7': 'man7', 4423c02aceSStefan Hajnoczi 'qemu-storage-daemon-qmp-ref.7': (have_tools ? 'man7' : ''), 45f8aa24eaSPaolo Bonzini 'qemu-img.1': (have_tools ? 'man1' : ''), 46f8aa24eaSPaolo Bonzini 'qemu-nbd.8': (have_tools ? 'man8' : ''), 47773ee3f1SPeter Maydell 'qemu-pr-helper.8': (have_tools ? 'man8' : ''), 48fa56cf7eSPeter Maydell 'qemu-storage-daemon.1': (have_tools ? 'man1' : ''), 499c29b741SPaolo Bonzini 'qemu-trace-stap.1': (stap.found() ? 'man1' : ''), 50f8aa24eaSPaolo Bonzini 'virtfs-proxy-helper.1': (have_virtfs_proxy_helper ? 'man1' : ''), 51f8aa24eaSPaolo Bonzini 'virtiofsd.1': (have_virtiofsd ? 'man1' : ''), 52f8aa24eaSPaolo Bonzini 'qemu.1': 'man1', 53f8aa24eaSPaolo Bonzini 'qemu-block-drivers.7': 'man7', 54f8aa24eaSPaolo Bonzini 'qemu-cpu-models.7': 'man7' 55f8aa24eaSPaolo Bonzini } 56f8aa24eaSPaolo Bonzini 57f8aa24eaSPaolo Bonzini sphinxdocs = [] 58f8aa24eaSPaolo Bonzini sphinxmans = [] 59bac35bf5SPaolo Bonzini 60b93f4fbdSPeter Maydell private_dir = meson.current_build_dir() / 'manual.p' 61b93f4fbdSPeter Maydell output_dir = meson.current_build_dir() / 'manual' 62b93f4fbdSPeter Maydell input_dir = meson.current_source_dir() 63b93f4fbdSPeter Maydell 64b93f4fbdSPeter Maydell this_manual = custom_target('QEMU manual', 65f8aa24eaSPaolo Bonzini build_by_default: build_docs, 66b93f4fbdSPeter Maydell output: 'docs.stamp', 67b93f4fbdSPeter Maydell input: files('conf.py'), 68b93f4fbdSPeter Maydell depfile: 'docs.d', 69bac35bf5SPaolo Bonzini command: [SPHINX_ARGS, '-Ddepfile=@DEPFILE@', 70bac35bf5SPaolo Bonzini '-Ddepfile_stamp=@OUTPUT0@', 71bac35bf5SPaolo Bonzini '-b', 'html', '-d', private_dir, 72bac35bf5SPaolo Bonzini input_dir, output_dir]) 73bac35bf5SPaolo Bonzini sphinxdocs += this_manual 74b93f4fbdSPeter Maydell install_subdir(output_dir, install_dir: qemu_docdir, strip_directory: true) 75f8aa24eaSPaolo Bonzini 76f8aa24eaSPaolo Bonzini these_man_pages = [] 77f8aa24eaSPaolo Bonzini install_dirs = [] 78b93f4fbdSPeter Maydell foreach page, section : man_pages 79f8aa24eaSPaolo Bonzini these_man_pages += page 80f8aa24eaSPaolo Bonzini install_dirs += section == '' ? false : get_option('mandir') / section 81f8aa24eaSPaolo Bonzini endforeach 82b93f4fbdSPeter Maydell 83b93f4fbdSPeter Maydell sphinxmans += custom_target('QEMU man pages', 84f8aa24eaSPaolo Bonzini build_by_default: build_docs, 85f8aa24eaSPaolo Bonzini output: these_man_pages, 86bac35bf5SPaolo Bonzini input: this_manual, 87f8aa24eaSPaolo Bonzini install: build_docs, 88f8aa24eaSPaolo Bonzini install_dir: install_dirs, 89f8aa24eaSPaolo Bonzini command: [SPHINX_ARGS, '-b', 'man', '-d', private_dir, 90f8aa24eaSPaolo Bonzini input_dir, meson.current_build_dir()]) 91b93f4fbdSPeter Maydell 92f8aa24eaSPaolo Bonzini alias_target('sphinxdocs', sphinxdocs) 934ac2ee19SPeter Maydell alias_target('html', sphinxdocs) 94f8aa24eaSPaolo Bonzini alias_target('man', sphinxmans) 95f8aa24eaSPaolo Bonziniendif 96