]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/asciidoc.conf
Makefile & configure: add a NO_FNMATCH_CASEFOLD flag
[thirdparty/git.git] / Documentation / asciidoc.conf
CommitLineData
5162e697 1## linkgit: macro
d1c2e113 2#
5162e697 3# Usage: linkgit:command[manpage-section]
d1c2e113
SV
4#
5# Note, {0} is the manpage section, while {target} is the command.
6#
7# Show GIT link as: <command>(<section>); if section is defined, else just show
8# the command.
9
9c0c1b1f
AB
10[macros]
11(?su)[\\]?(?P<name>linkgit):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
12
babfaba2 13[attributes]
c0a5e2d4 14asterisk=&#42;
4c7100a9
JH
15plus=&#43;
16caret=&#94;
a3e65d74
JF
17startsb=&#91;
18endsb=&#93;
54bd2558 19tilde=&#126;
1c3acfcd 20backtick=&#96;
babfaba2 21
d1c2e113 22ifdef::backend-docbook[]
5162e697 23[linkgit-inlinemacro]
d1c2e113
SV
24{0%{target}}
25{0#<citerefentry>}
26{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
27{0#</citerefentry>}
28endif::backend-docbook[]
29
e920b565 30ifdef::backend-docbook[]
8fa2b45f 31ifndef::git-asciidoc-no-roff[]
e920b565 32# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
7f55cf45 33# v1.72 breaks with this because it replaces dots not in roff requests.
e920b565
FD
34[listingblock]
35<example><title>{title}</title>
36<literallayout>
281a53bb
JP
37ifdef::doctype-manpage[]
38&#10;.ft C&#10;
39endif::doctype-manpage[]
e920b565 40|
281a53bb
JP
41ifdef::doctype-manpage[]
42&#10;.ft&#10;
43endif::doctype-manpage[]
e920b565
FD
44</literallayout>
45{title#}</example>
8fa2b45f 46endif::git-asciidoc-no-roff[]
9b6f84d2 47
8fa2b45f 48ifdef::git-asciidoc-no-roff[]
9b6f84d2
JF
49ifdef::doctype-manpage[]
50# The following two small workarounds insert a simple paragraph after screen
51[listingblock]
52<example><title>{title}</title>
dad32115 53<literallayout>
9b6f84d2 54|
dad32115 55</literallayout><simpara></simpara>
9b6f84d2
JF
56{title#}</example>
57
58[verseblock]
59<formalpara{id? id="{id}"}><title>{title}</title><para>
60{title%}<literallayout{id? id="{id}"}>
61{title#}<literallayout>
62|
0c04f527 63</literallayout>
9b6f84d2 64{title#}</para></formalpara>
0c04f527 65{title%}<simpara></simpara>
9b6f84d2 66endif::doctype-manpage[]
8fa2b45f 67endif::git-asciidoc-no-roff[]
e920b565
FD
68endif::backend-docbook[]
69
d3d4fa86 70ifdef::doctype-manpage[]
7ef195ba
FL
71ifdef::backend-docbook[]
72[header]
73template::[header-declarations]
74<refentry>
75<refmeta>
76<refentrytitle>{mantitle}</refentrytitle>
77<manvolnum>{manvolnum}</manvolnum>
78<refmiscinfo class="source">Git</refmiscinfo>
4159c578 79<refmiscinfo class="version">{git_version}</refmiscinfo>
7ef195ba
FL
80<refmiscinfo class="manual">Git Manual</refmiscinfo>
81</refmeta>
82<refnamediv>
83 <refname>{manname}</refname>
84 <refpurpose>{manpurpose}</refpurpose>
85</refnamediv>
86endif::backend-docbook[]
d3d4fa86 87endif::doctype-manpage[]
7ef195ba 88
d1c2e113 89ifdef::backend-xhtml11[]
5162e697 90[linkgit-inlinemacro]
d1c2e113
SV
91<a href="{target}.html">{target}{0?({0})}</a>
92endif::backend-xhtml11[]