Add some rules to deal with documentation generation.
[apps/pfixtools.git] / mk / 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::doctype-manpage[]
30 ifdef::backend-docbook[]
31 [header]
32 template::[header-declarations]
33 <refentry>
34 <refmeta>
35 <refentrytitle>{mantitle}</refentrytitle>
36 <manvolnum>{manvolnum}</manvolnum>
37 <refmiscinfo class="source">Postfix Tools</refmiscinfo>
38 <refmiscinfo class="version">{pft_version}</refmiscinfo>
39 <refmiscinfo class="manual">Postfix Tools Manual</refmiscinfo>
40 </refmeta>
41 <refnamediv>
42   <refname>{manname}</refname>
43   <refpurpose>{manpurpose}</refpurpose>
44 </refnamediv>
45 endif::backend-docbook[]
46 endif::doctype-manpage[]
47
48 ifdef::backend-xhtml11[]
49 [linkgit-inlinemacro]
50 <a href="{target}.html">{target}{0?({0})}</a>
51 endif::backend-xhtml11[]