Merge branch 'js/maint-1.6.0-path-normalize' into maint-1.6.1
[git] / Documentation / asciidoc.conf
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.
9
10 [macros]
11 (?su)[\\]?(?P<name>linkgit):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
12
13 [attributes]
14 asterisk=&#42;
15 plus=&#43;
16 caret=&#94;
17 startsb=&#91;
18 endsb=&#93;
19 tilde=&#126;
20
21 ifdef::backend-docbook[]
22 [linkgit-inlinemacro]
23 {0%{target}}
24 {0#<citerefentry>}
25 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
26 {0#</citerefentry>}
27 endif::backend-docbook[]
28
29 ifdef::backend-docbook[]
30 ifndef::docbook-xsl-172[]
31 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
32 # v1.72 breaks with this because it replaces dots not in roff requests.
33 [listingblock]
34 <example><title>{title}</title>
35 <literallayout>
36 ifdef::doctype-manpage[]
37 &#10;.ft C&#10;
38 endif::doctype-manpage[]
39 |
40 ifdef::doctype-manpage[]
41 &#10;.ft&#10;
42 endif::doctype-manpage[]
43 </literallayout>
44 {title#}</example>
45 endif::docbook-xsl-172[]
46
47 ifdef::docbook-xsl-172[]
48 ifdef::doctype-manpage[]
49 # The following two small workarounds insert a simple paragraph after screen
50 [listingblock]
51 <example><title>{title}</title>
52 <screen>
53 |
54 </screen><simpara></simpara>
55 {title#}</example>
56
57 [verseblock]
58 <formalpara{id? id="{id}"}><title>{title}</title><para>
59 {title%}<literallayout{id? id="{id}"}>
60 {title#}<literallayout>
61 |
62 </literallayout><simpara></simpara>
63 {title#}</para></formalpara>
64 endif::doctype-manpage[]
65 endif::docbook-xsl-172[]
66 endif::backend-docbook[]
67
68 ifdef::doctype-manpage[]
69 ifdef::backend-docbook[]
70 [header]
71 template::[header-declarations]
72 <refentry>
73 <refmeta>
74 <refentrytitle>{mantitle}</refentrytitle>
75 <manvolnum>{manvolnum}</manvolnum>
76 <refmiscinfo class="source">Git</refmiscinfo>
77 <refmiscinfo class="version">{git_version}</refmiscinfo>
78 <refmiscinfo class="manual">Git Manual</refmiscinfo>
79 </refmeta>
80 <refnamediv>
81   <refname>{manname}</refname>
82   <refpurpose>{manpurpose}</refpurpose>
83 </refnamediv>
84 endif::backend-docbook[]
85 endif::doctype-manpage[]
86
87 ifdef::backend-xhtml11[]
88 [linkgit-inlinemacro]
89 <a href="{target}.html">{target}{0?({0})}</a>
90 endif::backend-xhtml11[]