git/Documentation/howto
Julia Evans 2fc11e3382 doc: add more AsciiDoc cross-references
Instead of saying "see EXAMPLES below", say "see <<EXAMPLES,EXAMPLES>>
below" to make the man pages easier to navigate on the web.

The reason for using the more verbose <<EXAMPLES,EXAMPLES>>
(instead of <<EXAMPLES>>) is that in some cases, <<EXAMPLES>> is
rendered as `the section called "EXAMPLES"` or `[EXAMPLES]`.
<<EXAMPLES,EXAMPLES>> is rendered as `EXAMPLES`, which gives us more
control over the output.

This also changes some of the HTML IDs of the headings from `_examples`
to `EXAMPLES`, which has the potential to break some links.

Signed-off-by: Julia Evans <julia@jvns.ca>
Acked-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-09-25 09:11:18 -07:00
..
coordinate-embargoed-releases.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
howto-index.sh doc: update howto-index.sh for .adoc extensions 2025-03-01 10:00:51 -08:00
keep-canonical-history-correct.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
maintain-git.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
meson.build meson: make GIT_HTML_PATH configurable 2025-11-06 09:58:56 -08:00
new-command.adoc howto/new-command: update reference to builtin docs 2025-03-03 13:49:20 -08:00
rebase-from-internal-branch.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
rebuild-from-update-hook.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
recover-corrupted-blob-object.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
recover-corrupted-object-harder.adoc git-zlib: use `struct z_stream_s` instead of typedef 2025-04-07 14:53:11 -07:00
revert-a-faulty-merge.adoc doc: add more AsciiDoc cross-references 2026-09-25 09:11:18 -07:00
revert-branch-rebase.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
separating-topic-branches.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
setup-git-server-over-http.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
update-hook-example.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
use-git-daemon.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
using-merge-subtree.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
using-signed-tag-in-pull-request.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00