1 ## linkperf: macro 1 ## linkperf: macro
2 # 2 #
3 # Usage: linkperf:command[manpage-section] 3 # Usage: linkperf:command[manpage-section]
4 # 4 #
5 # Note, {0} is the manpage section, while {tar 5 # Note, {0} is the manpage section, while {target} is the command.
6 # 6 #
7 # Show PERF link as: <command>(<section>); if 7 # Show PERF link as: <command>(<section>); if section is defined, else just show
8 # the command. 8 # the command.
9 9
10 [macros] 10 [macros]
11 (?su)[\\]?(?P<name>linkperf):(?P<target>\S*?)\ 11 (?su)[\\]?(?P<name>linkperf):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
12 12
13 [attributes] 13 [attributes]
14 asterisk=* 14 asterisk=*
15 plus=+ 15 plus=+
16 caret=^ 16 caret=^
17 startsb=[ 17 startsb=[
18 endsb=] 18 endsb=]
19 tilde=~ 19 tilde=~
20 20
21 ifdef::backend-docbook[] 21 ifdef::backend-docbook[]
22 [linkperf-inlinemacro] 22 [linkperf-inlinemacro]
23 {0%{target}} 23 {0%{target}}
24 {0#<citerefentry>} 24 {0#<citerefentry>}
25 {0#<refentrytitle>{target}</refentrytitle><man 25 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
26 {0#</citerefentry>} 26 {0#</citerefentry>}
27 endif::backend-docbook[] 27 endif::backend-docbook[]
28 28
29 ifdef::backend-docbook[] 29 ifdef::backend-docbook[]
30 ifndef::perf-asciidoc-no-roff[] 30 ifndef::perf-asciidoc-no-roff[]
31 # "unbreak" docbook-xsl v1.68 for manpages. v1 31 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
32 # v1.72 breaks with this because it replaces d 32 # v1.72 breaks with this because it replaces dots not in roff requests.
33 [listingblock] 33 [listingblock]
34 <example><title>{title}</title> 34 <example><title>{title}</title>
35 <literallayout> 35 <literallayout>
36 ifdef::doctype-manpage[] 36 ifdef::doctype-manpage[]
37 .ft C 37 .ft C
38 endif::doctype-manpage[] 38 endif::doctype-manpage[]
39 | 39 |
40 ifdef::doctype-manpage[] 40 ifdef::doctype-manpage[]
41 .ft 41 .ft
42 endif::doctype-manpage[] 42 endif::doctype-manpage[]
43 </literallayout> 43 </literallayout>
44 {title#}</example> 44 {title#}</example>
45 endif::perf-asciidoc-no-roff[] 45 endif::perf-asciidoc-no-roff[]
46 46
47 ifdef::perf-asciidoc-no-roff[] 47 ifdef::perf-asciidoc-no-roff[]
48 ifdef::doctype-manpage[] 48 ifdef::doctype-manpage[]
49 # The following two small workarounds insert a 49 # The following two small workarounds insert a simple paragraph after screen
50 [listingblock] 50 [listingblock]
51 <example><title>{title}</title> 51 <example><title>{title}</title>
52 <literallayout> 52 <literallayout>
53 | 53 |
54 </literallayout><simpara></simpara> 54 </literallayout><simpara></simpara>
55 {title#}</example> 55 {title#}</example>
56 56
57 [verseblock] 57 [verseblock]
58 <formalpara{id? id="{id}"}><title>{title}</tit 58 <formalpara{id? id="{id}"}><title>{title}</title><para>
59 {title%}<literallayout{id? id="{id}"}> 59 {title%}<literallayout{id? id="{id}"}>
60 {title#}<literallayout> 60 {title#}<literallayout>
61 | 61 |
62 </literallayout> 62 </literallayout>
63 {title#}</para></formalpara> 63 {title#}</para></formalpara>
64 {title%}<simpara></simpara> 64 {title%}<simpara></simpara>
65 endif::doctype-manpage[] 65 endif::doctype-manpage[]
66 endif::perf-asciidoc-no-roff[] 66 endif::perf-asciidoc-no-roff[]
67 endif::backend-docbook[] 67 endif::backend-docbook[]
68 68
69 ifdef::doctype-manpage[] 69 ifdef::doctype-manpage[]
70 ifdef::backend-docbook[] 70 ifdef::backend-docbook[]
71 [header] 71 [header]
72 template::[header-declarations] 72 template::[header-declarations]
73 <refentry> 73 <refentry>
74 ifdef::perf_date[] <<
75 <refentryinfo><date>{perf_date}</date></refent <<
76 endif::perf_date[] <<
77 <refmeta> 74 <refmeta>
78 <refentrytitle>{mantitle}</refentrytitle> 75 <refentrytitle>{mantitle}</refentrytitle>
79 <manvolnum>{manvolnum}</manvolnum> 76 <manvolnum>{manvolnum}</manvolnum>
80 <refmiscinfo class="source">perf</refmiscinfo> 77 <refmiscinfo class="source">perf</refmiscinfo>
81 <refmiscinfo class="version">{perf_version}</r 78 <refmiscinfo class="version">{perf_version}</refmiscinfo>
82 <refmiscinfo class="manual">perf Manual</refmi 79 <refmiscinfo class="manual">perf Manual</refmiscinfo>
83 </refmeta> 80 </refmeta>
84 <refnamediv> 81 <refnamediv>
85 <refname>{manname}</refname> 82 <refname>{manname}</refname>
86 <refpurpose>{manpurpose}</refpurpose> 83 <refpurpose>{manpurpose}</refpurpose>
87 </refnamediv> 84 </refnamediv>
88 endif::backend-docbook[] 85 endif::backend-docbook[]
89 endif::doctype-manpage[] 86 endif::doctype-manpage[]
90 87
91 ifdef::backend-xhtml11[] 88 ifdef::backend-xhtml11[]
92 [linkperf-inlinemacro] 89 [linkperf-inlinemacro]
93 <a href="{target}.html">{target}{0?({0})}</a> 90 <a href="{target}.html">{target}{0?({0})}</a>
94 endif::backend-xhtml11[] 91 endif::backend-xhtml11[]
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.