From 803922a8188e5c5ef5cb0b8338094c1a6504dde3 Mon Sep 17 00:00:00 2001 From: Toni Gundogdu Date: Mon, 25 Mar 2013 22:53:30 +0200 Subject: [PATCH] doc: Add asciidoc.conf This file adds the linkman macro. See the comment field for the instructions. This is a modified version from the pacman (of Arch Linux) source tree uses to produce the manpages: this macro does not insert . Signed-off-by: Toni Gundogdu --- doc/Makefile.am | 2 ++ doc/asciidoc.conf | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 66 insertions(+) create mode 100644 doc/asciidoc.conf diff --git a/doc/Makefile.am b/doc/Makefile.am index 5dffbec..58755e0 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,3 +1,5 @@ +EXTRA_DIST=asciidoc.conf + SUBDIRS= if WITH_MANUAL SUBDIRS+=man7 diff --git a/doc/asciidoc.conf b/doc/asciidoc.conf new file mode 100644 index 0000000..4411572 --- /dev/null +++ b/doc/asciidoc.conf @@ -0,0 +1,64 @@ +## linkman: macro +# Inspired by/borrowed from the pacman source tree at doc/asciidoc.conf +# +# Usage: linkman:command[manpage-section] +# +# Note, {0} is the manpage section, while {target} is the command. +# +# Show man link as: (
); if section is defined, else just show +# the command. + +[macros] +(?su)[\\]?(?Plinkman):(?P\S*?)\[(?P.*?)\]= + +[attributes] +asterisk=* +plus=+ +caret=^ +startsb=[ +endsb=] +backslash=\ +tilde=~ +apostrophe=' +backtick=` +litdd=-- + +ifdef::backend-docbook[] +[linkman-inlinemacro] +{0%{target}} +{0#} +{0#{target}{0}} +{0#} +endif::backend-docbook[] + +ifdef::backend-docbook[] +ifndef::docbook-xsl-172[] +# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this. +# v1.72 breaks with this because it replaces dots not in roff requests. +[listingblock] +{title} + +| + +{title#} +endif::docbook-xsl-172[] +endif::backend-docbook[] + +ifdef::doctype-manpage[] +ifdef::backend-docbook[] +[header] +template::[header-declarations] + + +{mantitle} +{manvolnum} +libquvi-scripts +{pkg_version} +libquvi-scripts Manual + + + {manname} + {manpurpose} + +endif::backend-docbook[] +endif::doctype-manpage[] -- 2.11.4.GIT