mirror of
https://github.com/git/git
synced 2024-08-27 19:49:21 +00:00
![Francis Daly](/assets/img/avatar_default.png)
docbook-xsl v1.68 incorrectly converts "<screen>" from docbook to manpage by not rendering it verbatim. v1.69 handles it correctly, but not many current popular distributions ship with it. asciidoc by default converts "listingblock" to "<screen>". This change causes asciidoc in git to convert "listingblock" to "<literallayout>", which both old and new docbook-xsl handle correctly. The difference can be seen in any manpage which includes a multi-line example, such as git-branch. [jc: the original patch was an disaster for html backends, so I made it apply only to docbook backends. ] Signed-off-by: Junio C Hamano <junkio@cox.net>
37 lines
796 B
Plaintext
37 lines
796 B
Plaintext
## gitlink: macro
|
|
#
|
|
# Usage: gitlink:command[manpage-section]
|
|
#
|
|
# Note, {0} is the manpage section, while {target} is the command.
|
|
#
|
|
# Show GIT link as: <command>(<section>); if section is defined, else just show
|
|
# the command.
|
|
|
|
[attributes]
|
|
caret=^
|
|
|
|
ifdef::backend-docbook[]
|
|
[gitlink-inlinemacro]
|
|
{0%{target}}
|
|
{0#<citerefentry>}
|
|
{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
|
|
{0#</citerefentry>}
|
|
endif::backend-docbook[]
|
|
|
|
ifdef::backend-docbook[]
|
|
# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
|
|
[listingblock]
|
|
<example><title>{title}</title>
|
|
<literallayout>
|
|
|
|
|
</literallayout>
|
|
{title#}</example>
|
|
endif::backend-docbook[]
|
|
|
|
ifdef::backend-xhtml11[]
|
|
[gitlink-inlinemacro]
|
|
<a href="{target}.html">{target}{0?({0})}</a>
|
|
endif::backend-xhtml11[]
|
|
|
|
|