Andrew's git - gitweb.git/blob

6be8ba32505e53809477f07529cc5c7638bd20fe
   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;
  20apostrophe=&#39;
  21backtick=&#96;
  22
  23ifdef::backend-docbook[]
  24[linkgit-inlinemacro]
  25{0%{target}}
  26{0#<citerefentry>}
  27{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  28{0#</citerefentry>}
  29endif::backend-docbook[]
  30
  31ifdef::backend-docbook[]
  32ifndef::git-asciidoc-no-roff[]
  33# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  34# v1.72 breaks with this because it replaces dots not in roff requests.
  35[listingblock]
  36<example><title>{title}</title>
  37<literallayout>
  38ifdef::doctype-manpage[]
  39&#10;.ft C&#10;
  40endif::doctype-manpage[]
  41|
  42ifdef::doctype-manpage[]
  43&#10;.ft&#10;
  44endif::doctype-manpage[]
  45</literallayout>
  46{title#}</example>
  47endif::git-asciidoc-no-roff[]
  48
  49ifdef::git-asciidoc-no-roff[]
  50ifdef::doctype-manpage[]
  51# The following two small workarounds insert a simple paragraph after screen
  52[listingblock]
  53<example><title>{title}</title>
  54<literallayout>
  55|
  56</literallayout><simpara></simpara>
  57{title#}</example>
  58
  59[verseblock]
  60<formalpara{id? id="{id}"}><title>{title}</title><para>
  61{title%}<literallayout{id? id="{id}"}>
  62{title#}<literallayout>
  63|
  64</literallayout>
  65{title#}</para></formalpara>
  66{title%}<simpara></simpara>
  67endif::doctype-manpage[]
  68endif::git-asciidoc-no-roff[]
  69endif::backend-docbook[]
  70
  71ifdef::doctype-manpage[]
  72ifdef::backend-docbook[]
  73[header]
  74template::[header-declarations]
  75<refentry>
  76<refmeta>
  77<refentrytitle>{mantitle}</refentrytitle>
  78<manvolnum>{manvolnum}</manvolnum>
  79<refmiscinfo class="source">Git</refmiscinfo>
  80<refmiscinfo class="version">{git_version}</refmiscinfo>
  81<refmiscinfo class="manual">Git Manual</refmiscinfo>
  82</refmeta>
  83<refnamediv>
  84  <refname>{manname}</refname>
  85  <refpurpose>{manpurpose}</refpurpose>
  86</refnamediv>
  87endif::backend-docbook[]
  88endif::doctype-manpage[]
  89
  90ifdef::backend-xhtml11[]
  91[linkgit-inlinemacro]
  92<a href="{target}.html">{target}{0?({0})}</a>
  93endif::backend-xhtml11[]