Andrew's git - gitweb.git/blob - Documentation/asciidoc.conf

   1## linkgit: macro
   2#
   3# Usage: linkgit: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[macros]
  11(?su)[\\]?(?P<name>linkgit):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
  12
  13[attributes]
  14asterisk=&#42;
  15plus=&#43;
  16caret=&#94;
  17startsb=&#91;
  18endsb=&#93;
  19tilde=&#126;
  20
  21ifdef::backend-docbook[]
  22[linkgit-inlinemacro]
  23{0%{target}}
  24{0#<citerefentry>}
  25{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  26{0#</citerefentry>}
  27endif::backend-docbook[]
  28
  29ifdef::backend-docbook[]
  30ifndef::git-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>
  36ifdef::doctype-manpage[]
  37&#10;.ft C&#10;
  38endif::doctype-manpage[]
  39|
  40ifdef::doctype-manpage[]
  41&#10;.ft&#10;
  42endif::doctype-manpage[]
  43</literallayout>
  44{title#}</example>
  45endif::git-asciidoc-no-roff[]
  46
  47ifdef::git-asciidoc-no-roff[]
  48ifdef::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>
  65endif::doctype-manpage[]
  66endif::git-asciidoc-no-roff[]
  67endif::backend-docbook[]
  68
  69ifdef::doctype-manpage[]
  70ifdef::backend-docbook[]
  71[header]
  72template::[header-declarations]
  73<refentry>
  74<refmeta>
  75<refentrytitle>{mantitle}</refentrytitle>
  76<manvolnum>{manvolnum}</manvolnum>
  77<refmiscinfo class="source">Git</refmiscinfo>
  78<refmiscinfo class="version">{git_version}</refmiscinfo>
  79<refmiscinfo class="manual">Git Manual</refmiscinfo>
  80</refmeta>
  81<refnamediv>
  82  <refname>{manname}</refname>
  83  <refpurpose>{manpurpose}</refpurpose>
  84</refnamediv>
  85endif::backend-docbook[]
  86endif::doctype-manpage[]
  87
  88ifdef::backend-xhtml11[]
  89[linkgit-inlinemacro]
  90<a href="{target}.html">{target}{0?({0})}</a>
  91endif::backend-xhtml11[]