168b795f9e
Add some asciidoc generation stuff to the doc/ Makefile.am so we can get some manpages up and working. Add necessary stuff to gitignore, and check in the asciidoc.conf file along with the footer for all of the manpages. Signed-off-by: Dan McGee <dan@archlinux.org>
62 lines
1.4 KiB
Plaintext
62 lines
1.4 KiB
Plaintext
#
|
|
# Inspired by/borrowed from the GIT source tree at Documentation/asciidoc.conf
|
|
#
|
|
|
|
## manlink: macro
|
|
#
|
|
# Usage: manlink:command[manpage-section]
|
|
#
|
|
# Note, {0} is the manpage section, while {target} is the command.
|
|
#
|
|
# Show man link as: <command>(<section>); if section is defined, else just show
|
|
# the command.
|
|
|
|
[attributes]
|
|
plus=+
|
|
caret=^
|
|
startsb=[
|
|
endsb=]
|
|
tilde=~
|
|
|
|
ifdef::backend-docbook[]
|
|
[manlink-inlinemacro]
|
|
{0%{target}}
|
|
{0#<citerefentry>}
|
|
{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
|
|
{0#</citerefentry>}
|
|
endif::backend-docbook[]
|
|
|
|
ifdef::backend-docbook[]
|
|
# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
|
|
[listingblock]
|
|
<example><title>{title}</title>
|
|
<literallayout>
|
|
|
|
|
</literallayout>
|
|
{title#}</example>
|
|
endif::backend-docbook[]
|
|
|
|
ifdef::doctype-manpage[]
|
|
ifdef::backend-docbook[]
|
|
[header]
|
|
template::[header-declarations]
|
|
<refentry>
|
|
<refmeta>
|
|
<refentrytitle>{mantitle}</refentrytitle>
|
|
<manvolnum>{manvolnum}</manvolnum>
|
|
<refmiscinfo class="source">Pacman</refmiscinfo>
|
|
<refmiscinfo class="version">{pacman_version}</refmiscinfo>
|
|
<refmiscinfo class="manual">Pacman Manual</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>{manname}</refname>
|
|
<refpurpose>{manpurpose}</refpurpose>
|
|
</refnamediv>
|
|
endif::backend-docbook[]
|
|
endif::doctype-manpage[]
|
|
|
|
ifdef::backend-xhtml11[]
|
|
[manlink-inlinemacro]
|
|
<a href="{target}.html">{target}{0?({0})}</a>
|
|
endif::backend-xhtml11[]
|