2007-12-29 14:20:38 +08:00
|
|
|
## linkgit: macro
|
2005-09-19 18:10:14 +08:00
|
|
|
#
|
2007-12-29 14:20:38 +08:00
|
|
|
# Usage: linkgit:command[manpage-section]
|
2005-09-19 18:10:14 +08:00
|
|
|
#
|
|
|
|
# Note, {0} is the manpage section, while {target} is the command.
|
|
|
|
#
|
2013-01-22 03:16:20 +08:00
|
|
|
# Show Git link as: <command>(<section>); if section is defined, else just show
|
2005-09-19 18:10:14 +08:00
|
|
|
# the command.
|
|
|
|
|
2008-12-09 02:29:09 +08:00
|
|
|
[macros]
|
|
|
|
(?su)[\\]?(?P<name>linkgit):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
|
|
|
|
|
2005-10-06 07:56:31 +08:00
|
|
|
[attributes]
|
2008-06-25 12:25:53 +08:00
|
|
|
asterisk=*
|
2007-06-15 13:20:16 +08:00
|
|
|
plus=+
|
|
|
|
caret=^
|
2006-07-15 07:36:00 +08:00
|
|
|
startsb=[
|
|
|
|
endsb=]
|
2010-08-20 18:23:54 +08:00
|
|
|
backslash=\
|
2006-10-03 13:52:57 +08:00
|
|
|
tilde=~
|
2010-08-20 18:21:53 +08:00
|
|
|
apostrophe='
|
2009-06-28 20:55:45 +08:00
|
|
|
backtick=`
|
2010-08-24 05:20:25 +08:00
|
|
|
litdd=--
|
2005-10-06 07:56:31 +08:00
|
|
|
|
2005-09-19 18:10:14 +08:00
|
|
|
ifdef::backend-docbook[]
|
2007-12-29 14:20:38 +08:00
|
|
|
[linkgit-inlinemacro]
|
2005-09-19 18:10:14 +08:00
|
|
|
{0%{target}}
|
|
|
|
{0#<citerefentry>}
|
|
|
|
{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
|
|
|
|
{0#</citerefentry>}
|
|
|
|
endif::backend-docbook[]
|
|
|
|
|
2006-03-06 07:13:36 +08:00
|
|
|
ifdef::backend-docbook[]
|
2009-03-27 14:44:00 +08:00
|
|
|
ifndef::git-asciidoc-no-roff[]
|
2006-03-06 07:13:36 +08:00
|
|
|
# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
|
2007-11-14 17:38:46 +08:00
|
|
|
# v1.72 breaks with this because it replaces dots not in roff requests.
|
2006-03-06 07:13:36 +08:00
|
|
|
[listingblock]
|
|
|
|
<example><title>{title}</title>
|
2012-08-08 04:07:38 +08:00
|
|
|
<literallayout class="monospaced">
|
2007-07-19 05:33:57 +08:00
|
|
|
ifdef::doctype-manpage[]
|
|
|
|
.ft C
|
|
|
|
endif::doctype-manpage[]
|
2006-03-06 07:13:36 +08:00
|
|
|
|
|
2007-07-19 05:33:57 +08:00
|
|
|
ifdef::doctype-manpage[]
|
|
|
|
.ft
|
|
|
|
endif::doctype-manpage[]
|
2006-03-06 07:13:36 +08:00
|
|
|
</literallayout>
|
|
|
|
{title#}</example>
|
2009-03-27 14:44:00 +08:00
|
|
|
endif::git-asciidoc-no-roff[]
|
2008-10-30 18:45:03 +08:00
|
|
|
|
2009-03-27 14:44:00 +08:00
|
|
|
ifdef::git-asciidoc-no-roff[]
|
2008-10-30 18:45:03 +08:00
|
|
|
ifdef::doctype-manpage[]
|
|
|
|
# The following two small workarounds insert a simple paragraph after screen
|
|
|
|
[listingblock]
|
|
|
|
<example><title>{title}</title>
|
2012-08-08 04:07:38 +08:00
|
|
|
<literallayout class="monospaced">
|
2008-10-30 18:45:03 +08:00
|
|
|
|
|
2009-03-27 14:44:03 +08:00
|
|
|
</literallayout><simpara></simpara>
|
2008-10-30 18:45:03 +08:00
|
|
|
{title#}</example>
|
|
|
|
|
|
|
|
[verseblock]
|
|
|
|
<formalpara{id? id="{id}"}><title>{title}</title><para>
|
|
|
|
{title%}<literallayout{id? id="{id}"}>
|
|
|
|
{title#}<literallayout>
|
|
|
|
|
|
2009-03-27 14:44:04 +08:00
|
|
|
</literallayout>
|
2008-10-30 18:45:03 +08:00
|
|
|
{title#}</para></formalpara>
|
2009-03-27 14:44:04 +08:00
|
|
|
{title%}<simpara></simpara>
|
2008-10-30 18:45:03 +08:00
|
|
|
endif::doctype-manpage[]
|
2009-03-27 14:44:00 +08:00
|
|
|
endif::git-asciidoc-no-roff[]
|
2006-03-06 07:13:36 +08:00
|
|
|
endif::backend-docbook[]
|
|
|
|
|
2007-03-27 14:45:23 +08:00
|
|
|
ifdef::doctype-manpage[]
|
2007-03-25 19:56:50 +08:00
|
|
|
ifdef::backend-docbook[]
|
|
|
|
[header]
|
|
|
|
template::[header-declarations]
|
|
|
|
<refentry>
|
|
|
|
<refmeta>
|
|
|
|
<refentrytitle>{mantitle}</refentrytitle>
|
|
|
|
<manvolnum>{manvolnum}</manvolnum>
|
|
|
|
<refmiscinfo class="source">Git</refmiscinfo>
|
2007-06-01 17:10:30 +08:00
|
|
|
<refmiscinfo class="version">{git_version}</refmiscinfo>
|
2007-03-25 19:56:50 +08:00
|
|
|
<refmiscinfo class="manual">Git Manual</refmiscinfo>
|
|
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
|
|
<refname>{manname}</refname>
|
|
|
|
<refpurpose>{manpurpose}</refpurpose>
|
|
|
|
</refnamediv>
|
|
|
|
endif::backend-docbook[]
|
2007-03-27 14:45:23 +08:00
|
|
|
endif::doctype-manpage[]
|
2007-03-25 19:56:50 +08:00
|
|
|
|
2005-09-19 18:10:14 +08:00
|
|
|
ifdef::backend-xhtml11[]
|
2012-06-21 14:24:10 +08:00
|
|
|
[attributes]
|
|
|
|
git-relative-html-prefix=
|
2007-12-29 14:20:38 +08:00
|
|
|
[linkgit-inlinemacro]
|
2012-06-08 05:03:23 +08:00
|
|
|
<a href="{git-relative-html-prefix}{target}.html">{target}{0?({0})}</a>
|
2005-09-19 18:10:14 +08:00
|
|
|
endif::backend-xhtml11[]
|