Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
Path: blob/master/tools/perf/Documentation/asciidoc.conf
26282 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
ifdef::perf_date[]
75
<refentryinfo><date>{perf_date}</date></refentryinfo>
76
endif::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>
88
endif::backend-docbook[]
89
endif::doctype-manpage[]
90
91
ifdef::backend-xhtml11[]
92
[linkperf-inlinemacro]
93
<a href="{target}.html">{target}{0?({0})}</a>
94
endif::backend-xhtml11[]
95
96