From 168b795f9eb12c08d70d05f2ee313165004564e3 Mon Sep 17 00:00:00 2001
From: Dan McGee <dan@archlinux.org>
Date: Sun, 1 Jul 2007 17:55:44 -0400
Subject: Start addition of asciidoc stuff

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>
---
 doc/asciidoc.conf | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 doc/asciidoc.conf

(limited to 'doc/asciidoc.conf')

diff --git a/doc/asciidoc.conf b/doc/asciidoc.conf
new file mode 100644
index 00000000..cb75ad75
--- /dev/null
+++ b/doc/asciidoc.conf
@@ -0,0 +1,61 @@
+#
+# 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=&#43;
+caret=&#94;
+startsb=&#91;
+endsb=&#93;
+tilde=&#126;
+
+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[]
-- 
cgit v1.2.3


From fe9a0de32edaf1db58e46a3fd3f1c05ad0b0e6c2 Mon Sep 17 00:00:00 2001
From: Andrew Fyfe <andrew@neptune-one.net>
Date: Fri, 6 Jul 2007 06:56:11 +0100
Subject: doc/Makefile.am: Set pacman version and date when man pages are
 generated.

Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>
---
 doc/asciidoc.conf | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'doc/asciidoc.conf')

diff --git a/doc/asciidoc.conf b/doc/asciidoc.conf
index cb75ad75..6b0747d6 100644
--- a/doc/asciidoc.conf
+++ b/doc/asciidoc.conf
@@ -41,6 +41,9 @@ ifdef::backend-docbook[]
 [header]
 template::[header-declarations]
 <refentry>
+<refentryinfo>
+<date>{pacman_date}</date>
+</refentryinfo>
 <refmeta>
 <refentrytitle>{mantitle}</refentrytitle>
 <manvolnum>{manvolnum}</manvolnum>
-- 
cgit v1.2.3


From e412ac19f549afa26b58dbd2a2090ed95ca9cb95 Mon Sep 17 00:00:00 2001
From: Dan McGee <dan@archlinux.org>
Date: Fri, 6 Jul 2007 16:54:18 -0400
Subject: Asciidoc updates- make it pretty, fix build, etc.

* Fix up the target so we rebuild the manpages when we edit the corresponding
  text file.
* Add vim modelines to all of the asciidoc files ensureing the right syntax
  highlighting is used and we have expandtabs turned off.
* Start making a few small changes to PKGBUILD.5 to make it pretty in both
  HTML and manpage format output.
* Fix the manlink macro to include the manpage section in the link.

Signed-off-by: Dan McGee <dan@archlinux.org>
---
 doc/asciidoc.conf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'doc/asciidoc.conf')

diff --git a/doc/asciidoc.conf b/doc/asciidoc.conf
index 6b0747d6..92e01179 100644
--- a/doc/asciidoc.conf
+++ b/doc/asciidoc.conf
@@ -60,5 +60,5 @@ endif::doctype-manpage[]
 
 ifdef::backend-xhtml11[]
 [manlink-inlinemacro]
-<a href="{target}.html">{target}{0?({0})}</a>
+<a href="{target}.{0}.html">{target}{0?({0})}</a>
 endif::backend-xhtml11[]
-- 
cgit v1.2.3