]>
Commit | Line | Data |
---|---|---|
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 | 14 | asterisk=* |
4c7100a9 JH |
15 | plus=+ |
16 | caret=^ | |
a3e65d74 JF |
17 | startsb=[ |
18 | endsb=] | |
54bd2558 | 19 | tilde=~ |
1c3acfcd | 20 | backtick=` |
babfaba2 | 21 | |
d1c2e113 | 22 | ifdef::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>} | |
28 | endif::backend-docbook[] | |
29 | ||
e920b565 | 30 | ifdef::backend-docbook[] |
8fa2b45f | 31 | ifndef::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 |
37 | ifdef::doctype-manpage[] |
38 | .ft C | |
39 | endif::doctype-manpage[] | |
e920b565 | 40 | | |
281a53bb JP |
41 | ifdef::doctype-manpage[] |
42 | .ft | |
43 | endif::doctype-manpage[] | |
e920b565 FD |
44 | </literallayout> |
45 | {title#}</example> | |
8fa2b45f | 46 | endif::git-asciidoc-no-roff[] |
9b6f84d2 | 47 | |
8fa2b45f | 48 | ifdef::git-asciidoc-no-roff[] |
9b6f84d2 JF |
49 | ifdef::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 | 66 | endif::doctype-manpage[] |
8fa2b45f | 67 | endif::git-asciidoc-no-roff[] |
e920b565 FD |
68 | endif::backend-docbook[] |
69 | ||
d3d4fa86 | 70 | ifdef::doctype-manpage[] |
7ef195ba FL |
71 | ifdef::backend-docbook[] |
72 | [header] | |
73 | template::[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> | |
86 | endif::backend-docbook[] | |
d3d4fa86 | 87 | endif::doctype-manpage[] |
7ef195ba | 88 | |
d1c2e113 | 89 | ifdef::backend-xhtml11[] |
5162e697 | 90 | [linkgit-inlinemacro] |
d1c2e113 SV |
91 | <a href="{target}.html">{target}{0?({0})}</a> |
92 | endif::backend-xhtml11[] |