197f0d0f39
Meson does not currently provide a target to compile documentation, only. Instead, users needs to compile the whole project, which may be way more than they really intend to do. Introduce a new "docs" alias to plug this gap. This alias can be invoked e.g. with `meson compile docs`. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>
63 lines
1.5 KiB
Meson
63 lines
1.5 KiB
Meson
howto_sources = [
|
|
'coordinate-embargoed-releases.adoc',
|
|
'keep-canonical-history-correct.adoc',
|
|
'maintain-git.adoc',
|
|
'new-command.adoc',
|
|
'rebase-from-internal-branch.adoc',
|
|
'rebuild-from-update-hook.adoc',
|
|
'recover-corrupted-blob-object.adoc',
|
|
'recover-corrupted-object-harder.adoc',
|
|
'revert-a-faulty-merge.adoc',
|
|
'revert-branch-rebase.adoc',
|
|
'separating-topic-branches.adoc',
|
|
'setup-git-server-over-http.adoc',
|
|
'update-hook-example.adoc',
|
|
'use-git-daemon.adoc',
|
|
'using-merge-subtree.adoc',
|
|
'using-signed-tag-in-pull-request.adoc',
|
|
]
|
|
|
|
howto_index = custom_target(
|
|
command: [
|
|
shell,
|
|
meson.current_source_dir() / 'howto-index.sh',
|
|
'@INPUT@',
|
|
],
|
|
env: script_environment,
|
|
capture: true,
|
|
input: howto_sources,
|
|
output: 'howto-index.adoc',
|
|
)
|
|
|
|
doc_targets += custom_target(
|
|
command: asciidoc_html_options,
|
|
input: howto_index,
|
|
output: 'howto-index.html',
|
|
depends: documentation_deps,
|
|
install: true,
|
|
install_dir: get_option('datadir') / 'doc/git-doc',
|
|
)
|
|
|
|
foreach howto : howto_sources
|
|
howto_stripped = custom_target(
|
|
command: [
|
|
sed,
|
|
'-e',
|
|
'1,/^$/d',
|
|
'@INPUT@',
|
|
],
|
|
input: howto,
|
|
output: fs.stem(howto) + '.stripped',
|
|
capture: true,
|
|
)
|
|
|
|
doc_targets += custom_target(
|
|
command: asciidoc_html_options,
|
|
input: howto_stripped,
|
|
output: fs.stem(howto_stripped.full_path()) + '.html',
|
|
depends: documentation_deps,
|
|
install: true,
|
|
install_dir: get_option('datadir') / 'doc/git-doc/howto',
|
|
)
|
|
endforeach
|