initial harness for documentation

diff --git a/.gitignore b/.gitignore
index eafee20f0bacae08b62c1fb5b944cf8dd8deb212..16ff1f7bfee0eed0bdd43fcc570982dc21eb0b1c 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -49,3 +49,6 @@ Makefile.in
 missing
 stamp-h1
 tags
+doc/telemetrum.fo
+doc/telemetrum.html
+doc/telemetrum.pdf

diff --git a/debian/control b/debian/control
index 7d21e602328518bc4127567c4c115b280d5055cd..2ba1722df74de4e14aef91d6ff9e4c88d98d32c1 100644 (file)
--- a/debian/control
+++ b/debian/control
@@ -3,8 +3,8 @@ Section: otherosfs
 Priority: extra
 Maintainer: Bdale Garbee <bdale@gag.com>
 Uploaders: Keith Packard <keithp@keithp.com>
-Build-Depends: debhelper (>= 7), autoconf, automake, flite1-dev, gawk, libasound2-dev, libgconf2-dev, libglade2-dev, libgtk2.0-dev, libreadline-dev, libusb-1.0-0-dev, nickle, sdcc, libplplot-dev
-Standards-Version: 3.8.3
+Build-Depends: debhelper (>= 7), autoconf, automake, flite1-dev, gawk, libasound2-dev, libgconf2-dev, libglade2-dev, libgtk2.0-dev, libreadline-dev, libusb-1.0-0-dev, nickle, sdcc, libplplot-dev, xsltproc, fop, docbook.xsl
+Standards-Version: 3.8.4
 Homepage: http://altusmetrum.org/AltOS
 
 Package: altos

diff --git a/debian/docs b/debian/docs
index 50bd824bb7bc7edba72e31d1f7a6ef7932846902..d5af59c7f431e2010746b1ac4ccbeecaaebc2a1e 100644 (file)
--- a/debian/docs
+++ b/debian/docs
@@ -1,2 +1,4 @@
 NEWS
 README
+doc/telemetrum.html
+doc/telemetrum.pdf

diff --git a/debian/rules b/debian/rules
index 780011b7734e4e8a7ce3d4970025eb2dc03a37a2..a7468b9f5c99814da86002ffd31fd184eb7df2e6 100755 (executable)
--- a/debian/rules
+++ b/debian/rules
@@ -26,6 +26,7 @@ build: build-stamp
 build-stamp: configure-stamp  
        dh_testdir
        $(MAKE) VERSION=$(PKG_VERSION)
+       (cd doc ; $(MAKE))
        touch $@
 
 clean: 

diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644 (file)
index 0000000..d329390
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,25 @@
+#
+#      http://docbook.sourceforge.net/release/xsl/current/README
+#
+
+all:   telemetrum.html telemetrum.pdf
+
+telemetrum.html:       telemetrum.xsl
+       xsltproc -o telemetrum.html \
+               /usr/share/xml/docbook/stylesheet/nwalsh/html/docbook.xsl \
+               telemetrum.xsl
+
+telemetrum.fo: telemetrum.xsl
+       xsltproc -o telemetrum.fo \
+               /usr/share/xml/docbook/stylesheet/nwalsh/fo/docbook.xsl \
+               telemetrum.xsl
+
+telemetrum.pdf:        telemetrum.fo
+       fop -fo telemetrum.fo -pdf telemetrum.pdf
+
+clean:
+       rm -f telemetrum.html telemetrum.pdf telemetrum.fo
+
+indent:                telemetrum.xsl
+       xmlindent -i 2 < telemetrum.xsl > telemetrum.new
+

diff --git a/doc/telemetrum.xsl b/doc/telemetrum.xsl
new file mode 100644 (file)
index 0000000..7d85531
--- /dev/null
+++ b/doc/telemetrum.xsl
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">
+<book>
+  <bookinfo>
+    <author>
+      <firstname>Bdale</firstname>
+      <surname>Garbee</surname>
+    </author>
+    <author>
+      <firstname>Keith</firstname>
+      <surname>Packard</surname>
+    </author>
+    <copyright>
+      <year>2010</year>
+      <holder>Bdale Garbee</holder>
+    </copyright>
+    <title>TeleMetrum</title>
+    <subtitle>Owner's Manual for the TeleMetrum System</subtitle>
+    <legalnotice>
+      <para>
+        This document is released under the terms of the 
+        <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">
+          Creative Commons ShareAlike 3.0
+        </ulink>
+        license.
+      </para>
+    </legalnotice>
+    <revhistory>
+      <revision>
+        <revnumber>0.1</revnumber>
+        <date>30 March 2010</date>
+        <revremark>Initial content</revremark>
+      </revision>
+    </revhistory>
+  </bookinfo>
+  <chapter>
+    <title>Introduction</title>
+    <para>
+      Placeholder.
+    </para>
+  </chapter>
+</book>
+