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