Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
awilliam
GitHub Repository: awilliam/linux-vfio
Path: blob/master/tools/perf/Documentation/asciidoc.conf
10821 views
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]
14
asterisk=&#42;
15
plus=&#43;
16
caret=&#94;
17
startsb=&#91;
18
endsb=&#93;
19
tilde=&#126;
20
21
ifdef::backend-docbook[]
22
[linkperf-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::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>
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::perf-asciidoc-no-roff[]
46
47
ifdef::perf-asciidoc-no-roff[]
48
ifdef::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>
65
endif::doctype-manpage[]
66
endif::perf-asciidoc-no-roff[]
67
endif::backend-docbook[]
68
69
ifdef::doctype-manpage[]
70
ifdef::backend-docbook[]
71
[header]
72
template::[header-declarations]
73
<refentry>
74
<refmeta>
75
<refentrytitle>{mantitle}</refentrytitle>
76
<manvolnum>{manvolnum}</manvolnum>
77
<refmiscinfo class="source">perf</refmiscinfo>
78
<refmiscinfo class="version">{perf_version}</refmiscinfo>
79
<refmiscinfo class="manual">perf Manual</refmiscinfo>
80
</refmeta>
81
<refnamediv>
82
<refname>{manname}</refname>
83
<refpurpose>{manpurpose}</refpurpose>
84
</refnamediv>
85
endif::backend-docbook[]
86
endif::doctype-manpage[]
87
88
ifdef::backend-xhtml11[]
89
[linkperf-inlinemacro]
90
<a href="{target}.html">{target}{0?({0})}</a>
91
endif::backend-xhtml11[]
92
93