]>
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 | # | |
48a8c26c | 7 | # Show Git link as: <command>(<section>); if section is defined, else just show |
d1c2e113 SV |
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=] | |
f1005987 | 19 | backslash=\ |
54bd2558 | 20 | tilde=~ |
438ded45 | 21 | apostrophe=' |
1c3acfcd | 22 | backtick=` |
28394787 | 23 | litdd=-- |
babfaba2 | 24 | |
d1c2e113 | 25 | ifdef::backend-docbook[] |
5162e697 | 26 | [linkgit-inlinemacro] |
d1c2e113 SV |
27 | {0%{target}} |
28 | {0#<citerefentry>} | |
29 | {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>} | |
30 | {0#</citerefentry>} | |
31 | endif::backend-docbook[] | |
32 | ||
e920b565 | 33 | ifdef::backend-docbook[] |
8fa2b45f | 34 | ifndef::git-asciidoc-no-roff[] |
e920b565 | 35 | # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this. |
7f55cf45 | 36 | # v1.72 breaks with this because it replaces dots not in roff requests. |
e920b565 FD |
37 | [listingblock] |
38 | <example><title>{title}</title> | |
c2a7f5d4 | 39 | <literallayout class="monospaced"> |
281a53bb JP |
40 | ifdef::doctype-manpage[] |
41 | .ft C | |
42 | endif::doctype-manpage[] | |
e920b565 | 43 | | |
281a53bb JP |
44 | ifdef::doctype-manpage[] |
45 | .ft | |
46 | endif::doctype-manpage[] | |
e920b565 FD |
47 | </literallayout> |
48 | {title#}</example> | |
8fa2b45f | 49 | endif::git-asciidoc-no-roff[] |
9b6f84d2 | 50 | |
8fa2b45f | 51 | ifdef::git-asciidoc-no-roff[] |
9b6f84d2 JF |
52 | ifdef::doctype-manpage[] |
53 | # The following two small workarounds insert a simple paragraph after screen | |
54 | [listingblock] | |
55 | <example><title>{title}</title> | |
c2a7f5d4 | 56 | <literallayout class="monospaced"> |
9b6f84d2 | 57 | | |
dad32115 | 58 | </literallayout><simpara></simpara> |
9b6f84d2 JF |
59 | {title#}</example> |
60 | ||
61 | [verseblock] | |
62 | <formalpara{id? id="{id}"}><title>{title}</title><para> | |
63 | {title%}<literallayout{id? id="{id}"}> | |
64 | {title#}<literallayout> | |
65 | | | |
0c04f527 | 66 | </literallayout> |
9b6f84d2 | 67 | {title#}</para></formalpara> |
0c04f527 | 68 | {title%}<simpara></simpara> |
9b6f84d2 | 69 | endif::doctype-manpage[] |
8fa2b45f | 70 | endif::git-asciidoc-no-roff[] |
e920b565 FD |
71 | endif::backend-docbook[] |
72 | ||
d3d4fa86 | 73 | ifdef::doctype-manpage[] |
7ef195ba FL |
74 | ifdef::backend-docbook[] |
75 | [header] | |
76 | template::[header-declarations] | |
77 | <refentry> | |
78 | <refmeta> | |
79 | <refentrytitle>{mantitle}</refentrytitle> | |
80 | <manvolnum>{manvolnum}</manvolnum> | |
81 | <refmiscinfo class="source">Git</refmiscinfo> | |
4159c578 | 82 | <refmiscinfo class="version">{git_version}</refmiscinfo> |
7ef195ba FL |
83 | <refmiscinfo class="manual">Git Manual</refmiscinfo> |
84 | </refmeta> | |
85 | <refnamediv> | |
86 | <refname>{manname}</refname> | |
87 | <refpurpose>{manpurpose}</refpurpose> | |
88 | </refnamediv> | |
89 | endif::backend-docbook[] | |
d3d4fa86 | 90 | endif::doctype-manpage[] |
7ef195ba | 91 | |
d1c2e113 | 92 | ifdef::backend-xhtml11[] |
60475183 JK |
93 | [attributes] |
94 | git-relative-html-prefix= | |
5162e697 | 95 | [linkgit-inlinemacro] |
fe77b416 | 96 | <a href="{git-relative-html-prefix}{target}.html">{target}{0?({0})}</a> |
d1c2e113 | 97 | endif::backend-xhtml11[] |