From: Bdale Garbee <bdale@gag.com>
Date: Wed, 31 Mar 2010 05:11:40 +0000 (-0600)
Subject: initial harness for documentation
X-Git-Tag: debian/0.6+111+g20d4d41~1
X-Git-Url: https://git.gag.com/?p=fw%2Faltos;a=commitdiff_plain;h=20d4d410e0fc04fe192e309811eed6c0194fa5a8

initial harness for documentation
---

diff --git a/.gitignore b/.gitignore
index eafee20f..16ff1f7b 100644
--- 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 7d21e602..2ba1722d 100644
--- 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 50bd824b..d5af59c7 100644
--- 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 780011b7..a7468b9f 100755
--- 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
index 00000000..d3293900
--- /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
index 00000000..7d855318
--- /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>
+