xref: /linux/tools/perf/Documentation/asciidoc.conf (revision dae82c7fd0926840c832151f3258ba751f73d348) 
1## linkperf: macro
2#
3# Usage: linkperf:command[manpage-section]
4#
5# Note, {0} is the manpage section, while {target} is the command.
6#
7# Show PERF link as: <command>(<section>); if section is defined, else just show
8# the command.
9
10[macros]
11(?su)[\\]?(?P<name>linkperf):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
12
13[attributes]
14asterisk=&#42;
15plus=&#43;
16caret=&#94;
17startsb=&#91;
18endsb=&#93;
19tilde=&#126;
20
21ifdef::backend-docbook[]
22[linkperf-inlinemacro]
23{0%{target}}
24{0#<citerefentry>}
25{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
26{0#</citerefentry>}
27endif::backend-docbook[]
28
29ifdef::backend-docbook[]
30ifndef::perf-asciidoc-no-roff[]
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>
36ifdef::doctype-manpage[]
37&#10;.ft C&#10;
38endif::doctype-manpage[]
39|
40ifdef::doctype-manpage[]
41&#10;.ft&#10;
42endif::doctype-manpage[]
43</literallayout>
44{title#}</example>
45endif::perf-asciidoc-no-roff[]
46
47ifdef::perf-asciidoc-no-roff[]
48ifdef::doctype-manpage[]
49# The following two small workarounds insert a simple paragraph after screen
50[listingblock]
51<example><title>{title}</title>
52<literallayout>
53|
54</literallayout><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>
63{title#}</para></formalpara>
64{title%}<simpara></simpara>
65endif::doctype-manpage[]
66endif::perf-asciidoc-no-roff[]
67endif::backend-docbook[]
68
69ifdef::doctype-manpage[]
70ifdef::backend-docbook[]
71[header]
72template::[header-declarations]
73<refentry>
74ifdef::perf_date[]
75<refentryinfo><date>{perf_date}</date></refentryinfo>
76endif::perf_date[]
77<refmeta>
78<refentrytitle>{mantitle}</refentrytitle>
79<manvolnum>{manvolnum}</manvolnum>
80<refmiscinfo class="source">perf</refmiscinfo>
81<refmiscinfo class="version">{perf_version}</refmiscinfo>
82<refmiscinfo class="manual">perf Manual</refmiscinfo>
83</refmeta>
84<refnamediv>
85  <refname>{manname}</refname>
86  <refpurpose>{manpurpose}</refpurpose>
87</refnamediv>
88endif::backend-docbook[]
89endif::doctype-manpage[]
90
91ifdef::backend-xhtml11[]
92[linkperf-inlinemacro]
93<a href="{target}.html">{target}{0?({0})}</a>
94endif::backend-xhtml11[]
95