Documentation / asciidoc.confon commit user-manual: use pithier example commit (e2618ff)
   1## gitlink: macro
   2#
   3# Usage: gitlink:command[manpage-section]
   4#
   5# Note, {0} is the manpage section, while {target} is the command.
   6#
   7# Show GIT link as: <command>(<section>); if section is defined, else just show
   8# the command.
   9
  10[attributes]
  11plus=&#43;
  12caret=&#94;
  13startsb=&#91;
  14endsb=&#93;
  15tilde=&#126;
  16
  17ifdef::backend-docbook[]
  18[gitlink-inlinemacro]
  19{0%{target}}
  20{0#<citerefentry>}
  21{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  22{0#</citerefentry>}
  23endif::backend-docbook[]
  24
  25ifdef::backend-docbook[]
  26# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  27[listingblock]
  28<example><title>{title}</title>
  29<literallayout>
  30ifdef::doctype-manpage[]
  31&#10;.ft C&#10;
  32endif::doctype-manpage[]
  33|
  34ifdef::doctype-manpage[]
  35&#10;.ft&#10;
  36endif::doctype-manpage[]
  37</literallayout>
  38{title#}</example>
  39endif::backend-docbook[]
  40
  41ifdef::doctype-manpage[]
  42ifdef::backend-docbook[]
  43[header]
  44template::[header-declarations]
  45<refentry>
  46<refmeta>
  47<refentrytitle>{mantitle}</refentrytitle>
  48<manvolnum>{manvolnum}</manvolnum>
  49<refmiscinfo class="source">Git</refmiscinfo>
  50<refmiscinfo class="version">{git_version}</refmiscinfo>
  51<refmiscinfo class="manual">Git Manual</refmiscinfo>
  52</refmeta>
  53<refnamediv>
  54  <refname>{manname}</refname>
  55  <refpurpose>{manpurpose}</refpurpose>
  56</refnamediv>
  57endif::backend-docbook[]
  58endif::doctype-manpage[]
  59
  60ifdef::backend-xhtml11[]
  61[gitlink-inlinemacro]
  62<a href="{target}.html">{target}{0?({0})}</a>
  63endif::backend-xhtml11[]
  64
  65