]> git.ipfire.org Git - thirdparty/git.git/commit
doc: git-clone fix discrepancy between asciidoc and asciidoctor
authorJean-Noël Avila <jn.avila@free.fr>
Sat, 20 Jul 2024 17:34:13 +0000 (17:34 +0000)
committerJunio C Hamano <gitster@pobox.com>
Sat, 20 Jul 2024 23:24:12 +0000 (16:24 -0700)
commit6474da0aa4d411e12fd4962b3e81c6d4e9db6b12
tree05a783bb6d1a8ae57808297518507030f66f8650
parentebb55042a4416a07c27ba45eeb24e6ff1899f360
doc: git-clone fix discrepancy between asciidoc and asciidoctor

Asciidoc.py does not have the concept of generalized roles, whereas
asciidoctor interprets [foo]`blah` as blah with role foo in the
synopsis, making in effect foo disappear in the output. Note that
square brackets not directly followed by an inline markup do not
define a role, which is why we do not have the issue on other parts of
the documentation.

In order to get a consistant result across asciidoctor and
asciidoc.py, the hack is to use the {empty} entity
to split the bracket part from the inline format part.

Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-clone.txt