xref: /aosp_15_r20/external/trace-cmd/Documentation/asciidoc.conf (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)

## linktep: macro
#
# Usage: linktep:command[manpage-section]
#
# Note, {0} is the manpage section, while {target} is the command.
#
# Show TEP link as: <command>(<section>); if section is defined, else just show
# the command.

[macros]
(?su)[\\]?(?P<name>linktep):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=

[attributes]
asterisk=&#42;
plus=&#43;
caret=&#94;
startsb=&#91;
endsb=&#93;
tilde=&#126;

ifdef::backend-docbook[]
[linktep-inlinemacro]
{0%{target}}
{0#<citerefentry>}
{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
{0#</citerefentry>}
endif::backend-docbook[]

ifdef::backend-docbook[]
ifndef::tep-asciidoc-no-roff[]
# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
# v1.72 breaks with this because it replaces dots not in roff requests.
[listingblock]
<example><title>{title}</title>
<literallayout>
ifdef::doctype-manpage[]
&#10;.ft C&#10;
endif::doctype-manpage[]
|
ifdef::doctype-manpage[]
&#10;.ft&#10;
endif::doctype-manpage[]
</literallayout>
{title#}</example>
endif::tep-asciidoc-no-roff[]

ifdef::tep-asciidoc-no-roff[]
ifdef::doctype-manpage[]
# The following two small workarounds insert a simple paragraph after screen
[listingblock]
<example><title>{title}</title>
<literallayout>
|
</literallayout><simpara></simpara>
{title#}</example>

[verseblock]
<formalpara{id? id="{id}"}><title>{title}</title><para>
{title%}<literallayout{id? id="{id}"}>
{title#}<literallayout>
|
</literallayout>
{title#}</para></formalpara>
{title%}<simpara></simpara>
endif::doctype-manpage[]
endif::tep-asciidoc-no-roff[]
endif::backend-docbook[]

ifdef::doctype-manpage[]
ifdef::backend-docbook[]
[header]
template::[header-declarations]
<refentry>
<refmeta>
<refentrytitle>{mantitle}</refentrytitle>
<manvolnum>{manvolnum}</manvolnum>
<refmiscinfo class="source">libtracefs</refmiscinfo>
<refmiscinfo class="version">{libtracefs_version}</refmiscinfo>
<refmiscinfo class="manual">libtracefs Manual</refmiscinfo>
</refmeta>
<refnamediv>
  <refname>{manname1}</refname>
  <refname>{manname2}</refname>
  <refname>{manname3}</refname>
  <refname>{manname4}</refname>
  <refname>{manname5}</refname>
  <refname>{manname6}</refname>
  <refname>{manname7}</refname>
  <refname>{manname8}</refname>
  <refname>{manname9}</refname>
  <refname>{manname10}</refname>
  <refname>{manname11}</refname>
  <refname>{manname12}</refname>
  <refname>{manname13}</refname>
  <refname>{manname14}</refname>
  <refname>{manname15}</refname>
  <refname>{manname16}</refname>
  <refname>{manname17}</refname>
  <refname>{manname18}</refname>
  <refname>{manname19}</refname>
  <refname>{manname20}</refname>
  <refname>{manname21}</refname>
  <refname>{manname22}</refname>
  <refname>{manname23}</refname>
  <refname>{manname24}</refname>
  <refname>{manname25}</refname>
  <refname>{manname26}</refname>
  <refname>{manname27}</refname>
  <refname>{manname28}</refname>
  <refname>{manname29}</refname>
  <refname>{manname30}</refname>
  <refpurpose>{manpurpose}</refpurpose>
</refnamediv>
endif::backend-docbook[]
endif::doctype-manpage[]

ifdef::backend-xhtml11[]
[linktep-inlinemacro]
<a href="{target}.html">{target}{0?({0})}</a>
endif::backend-xhtml11[]