1 ## linkgit: macro
2 #
3 # Usage: linkgit:command[manpage-section]
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.
10 [attributes]
11 asterisk=*
12 plus=+
13 caret=^
14 startsb=[
15 endsb=]
16 tilde=~
18 ifdef::backend-docbook[]
19 [linkgit-inlinemacro]
20 {0%{target}}
21 {0#<citerefentry>}
22 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
23 {0#</citerefentry>}
24 endif::backend-docbook[]
26 ifdef::backend-docbook[]
27 ifndef::docbook-xsl-172[]
28 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
29 # v1.72 breaks with this because it replaces dots not in roff requests.
30 [listingblock]
31 <example><title>{title}</title>
32 <literallayout>
33 ifdef::doctype-manpage[]
34 .ft C
35 endif::doctype-manpage[]
36 |
37 ifdef::doctype-manpage[]
38 .ft
39 endif::doctype-manpage[]
40 </literallayout>
41 {title#}</example>
42 endif::docbook-xsl-172[]
44 ifdef::docbook-xsl-172[]
45 ifdef::doctype-manpage[]
46 # The following two small workarounds insert a simple paragraph after screen
47 [listingblock]
48 <example><title>{title}</title>
49 <screen>
50 |
51 </screen><simpara></simpara>
52 {title#}</example>
54 [verseblock]
55 <formalpara{id? id="{id}"}><title>{title}</title><para>
56 {title%}<literallayout{id? id="{id}"}>
57 {title#}<literallayout>
58 |
59 </literallayout><simpara></simpara>
60 {title#}</para></formalpara>
61 endif::doctype-manpage[]
62 endif::docbook-xsl-172[]
63 endif::backend-docbook[]
65 ifdef::doctype-manpage[]
66 ifdef::backend-docbook[]
67 [header]
68 template::[header-declarations]
69 <refentry>
70 <refmeta>
71 <refentrytitle>{mantitle}</refentrytitle>
72 <manvolnum>{manvolnum}</manvolnum>
73 <refmiscinfo class="source">Git</refmiscinfo>
74 <refmiscinfo class="version">{git_version}</refmiscinfo>
75 <refmiscinfo class="manual">Git Manual</refmiscinfo>
76 </refmeta>
77 <refnamediv>
78 <refname>{manname}</refname>
79 <refpurpose>{manpurpose}</refpurpose>
80 </refnamediv>
81 endif::backend-docbook[]
82 endif::doctype-manpage[]
84 ifdef::backend-xhtml11[]
85 [linkgit-inlinemacro]
86 <a href="{target}.html">{target}{0?({0})}</a>
87 endif::backend-xhtml11[]