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 backslash=&#92;
  21 tilde=&#126;
  22 apostrophe=&#39;
  23 backtick=&#96;
  24 litdd=&#45;&#45;
  25
  26 ifdef::backend-docbook[]
  27 [linkman-inlinemacro]
  28 {0%{target}}
  29 {0#<citerefentry>}
  30 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  31 {0#</citerefentry>}
  32 endif::backend-docbook[]
  33
  34 ifdef::backend-docbook[]
  35 ifndef::docbook-xsl-172[]
  36 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  37 # v1.72 breaks with this because it replaces dots not in roff requests.
  38 [listingblock]
  39 <example><title>{title}</title>
  40 <literallayout>
  41 |
  42 </literallayout>
  43 {title#}</example>
  44 endif::docbook-xsl-172[]
  45 endif::backend-docbook[]
  46
  47 ifdef::doctype-manpage[]
  48 ifdef::backend-docbook[]
  49 [header]
  50 template::[header-declarations]
  51 <refentry>
  52 <refentryinfo>
  53 <date>{pacman_date}</date>
  54 </refentryinfo>
  55 <refmeta>
  56 <refentrytitle>{mantitle}</refentrytitle>
  57 <manvolnum>{manvolnum}</manvolnum>
  58 <refmiscinfo class="source">Pacman</refmiscinfo>
  59 <refmiscinfo class="version">{pacman_version}</refmiscinfo>
  60 <refmiscinfo class="manual">Pacman Manual</refmiscinfo>
  61 </refmeta>
  62 <refnamediv>
  63   <refname>{manname}</refname>
  64   <refpurpose>{manpurpose}</refpurpose>
  65 </refnamediv>
  66 endif::backend-docbook[]
  67 endif::doctype-manpage[]
  68
  69 ifdef::backend-xhtml11[]
  70 [linkman-inlinemacro]
  71 <a href="{target}.{0}.html">{target}{0?({0})}</a>
  72 endif::backend-xhtml11[]