Files
git-mirror/Documentation/technical/meson.build
D. Ben Knoble d63417e3ad meson: make GIT_HTML_PATH configurable
Makefile-based builds can configure Git's internal HTML_PATH by defining
htmldir, which is useful for packagers that put documentation in
different locations. Gentoo, for example, uses version-suffixed
directories like ${prefix}/share/doc/git-2.51 and puts the HTML
documentation in an 'html' subdirectory of the same.

Propagate the same configuration knob to Meson-based builds so that
"git --html-path" on such systems can be configured to output the
correct directory.

Signed-off-by: D. Ben Knoble <ben.knoble+github@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-11-06 09:58:56 -08:00

69 lines
1.5 KiB
Meson

api_docs = [
'api-error-handling.adoc',
'api-merge.adoc',
'api-parse-options.adoc',
'api-simple-ipc.adoc',
'api-trace2.adoc',
]
articles = [
'bitmap-format.adoc',
'build-systems.adoc',
'bundle-uri.adoc',
'commit-graph.adoc',
'directory-rename-detection.adoc',
'hash-function-transition.adoc',
'large-object-promisors.adoc',
'long-running-process-protocol.adoc',
'multi-pack-index.adoc',
'packfile-uri.adoc',
'pack-heuristics.adoc',
'parallel-checkout.adoc',
'partial-clone.adoc',
'platform-support.adoc',
'racy-git.adoc',
'reftable.adoc',
'remembering-renames.adoc',
'repository-version.adoc',
'rerere.adoc',
'scalar.adoc',
'send-pack-pipeline.adoc',
'shallow.adoc',
'sparse-checkout.adoc',
'sparse-index.adoc',
'trivial-merge.adoc',
'unit-tests.adoc',
]
api_index = custom_target(
command: [
shell,
meson.current_source_dir() / 'api-index.sh',
meson.current_source_dir(),
'@OUTPUT@',
],
env: script_environment,
input: api_docs,
output: 'api-index.adoc',
)
doc_targets += custom_target(
command: asciidoc_html_options,
input: api_index,
output: 'api-index.html',
depends: documentation_deps,
install: true,
install_dir: htmldir / 'technical',
)
foreach article : api_docs + articles
doc_targets += custom_target(
command: asciidoc_html_options,
input: article,
output: fs.stem(article) + '.html',
depends: documentation_deps,
install: true,
install_dir: htmldir / 'technical',
)
endforeach