doc/asciidoc.conf

   1 ## linkman: macro
   2 # Inspired by/borrowed from the GIT source tree at Documentation/asciidoc.conf
   3 #
   4 # Usage: linkman:command[manpage-section]
   5 #
   6 # Note, {0} is the manpage section, while {target} is the command.
   7 #
   8 # Show man link as: <command>(<section>); if section is defined, else just show
   9 # the command.
  10
  11 [macros]
  12 (?su)[\\]?(?P<name>linkman):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
  13
  14 [attributes]
  15 asterisk=&#42;
  16 plus=&#43;
  17 caret=&#94;
  18 startsb=&#91;
  19 endsb=&#93;
  20 tilde=&#126;
  21
  22 ifdef::backend-docbook[]
  23 [linkman-inlinemacro]
  24 {0%{target}}
  25 {0#<citerefentry>}
  26 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  27 {0#</citerefentry>}
  28 endif::backend-docbook[]
  29
  30 ifdef::backend-docbook[]
  31 ifndef::docbook-xsl-172[]
  32 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  33 # v1.72 breaks with this because it replaces dots not in roff requests.
  34 [listingblock]
  35 <example><title>{title}</title>
  36 <literallayout>
  37 |
  38 </literallayout>
  39 {title#}</example>
  40 endif::docbook-xsl-172[]
  41 endif::backend-docbook[]
  42
  43 ifdef::doctype-manpage[]
  44 ifdef::backend-docbook[]
  45 [header]
  46 template::[header-declarations]
  47 <refentry>
  48 <refentryinfo>
  49 <date>{pacman_date}</date>
  50 </refentryinfo>
  51 <refmeta>
  52 <refentrytitle>{mantitle}</refentrytitle>
  53 <manvolnum>{manvolnum}</manvolnum>
  54 <refmiscinfo class="source">Pacman</refmiscinfo>
  55 <refmiscinfo class="version">{pacman_version}</refmiscinfo>
  56 <refmiscinfo class="manual">Pacman Manual</refmiscinfo>
  57 </refmeta>
  58 <refnamediv>
  59   <refname>{manname}</refname>
  60   <refpurpose>{manpurpose}</refpurpose>
  61 </refnamediv>
  62 endif::backend-docbook[]
  63 endif::doctype-manpage[]
  64
  65 ifdef::backend-xhtml11[]
  66 [linkman-inlinemacro]
  67 <a href="{target}.{0}.html">{target}{0?({0})}</a>
  68 endif::backend-xhtml11[]