mesa/docs/meson.build
Yonggang Luo 1f44a470b4 util: Always generate u_format_gen.h as docs need it
Signed-off-by: Yonggang Luo <luoyonggang@gmail.com>
Reviewed-by: Eric Engestrom <eric@igalia.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36891>
2025-08-21 03:19:02 +08:00

47 lines
1.1 KiB
Meson

get_option('html-docs').require(
run_command(prog_python, '-c',
'''
try:
from packaging.version import Version
except:
from distutils.version import StrictVersion as Version
import hawkmoth
assert Version(hawkmoth.__version__) >= Version("0.16.0")
''', check: false).returncode() == 0,
error_message: 'hawkmoth >= 0.16.0 required'
)
sphinx_args = []
if get_option('werror')
sphinx_args += '-W'
endif
html_docs = custom_target(
'html',
depfile: 'docs.d',
depend_files: files('conf.py'),
command: [sphinx, '-b', 'html', '-q',
'-Ddepfile=@DEPFILE@',
sphinx_args,
meson.current_source_dir(), '@OUTPUT@'],
env: [
'MESA_BUILD_ROOT=' + meson.project_build_root()
],
depends: [
u_format_gen_h,
],
output: 'html',
build_by_default: get_option('html-docs').enabled(),
)
html_docs_path = get_option('html-docs-path')
if html_docs_path == ''
html_docs_path = join_paths(get_option('datadir'), 'doc', 'mesa')
endif
install_subdir(html_docs.full_path(),
install_dir: html_docs_path,
exclude_files: ['.buildinfo'],
exclude_directories: ['.doctrees'],
strip_directory: true
)