From 76b37efc1819e16545e616801bb2896baf968ab3 Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Thu, 30 May 2002 12:22:43 +0000
Subject: [PATCH] Documentation updates

---
 slides/doc/.cvsignore |  1 +
 slides/doc/Makefile   | 16 ++++++++++++++++
 slides/doc/slides.xml | 31 ++++++++++++++++++++++++++++---
 3 files changed, 45 insertions(+), 3 deletions(-)
 create mode 100644 slides/doc/.cvsignore
 create mode 100644 slides/doc/Makefile

diff --git a/slides/doc/.cvsignore b/slides/doc/.cvsignore
new file mode 100644
index 000000000..2d19fc766
--- /dev/null
+++ b/slides/doc/.cvsignore
@@ -0,0 +1 @@
+*.html
diff --git a/slides/doc/Makefile b/slides/doc/Makefile
new file mode 100644
index 000000000..d9618cebd
--- /dev/null
+++ b/slides/doc/Makefile
@@ -0,0 +1,16 @@
+include ../../cvstools/Makefile.incl
+
+CP=cp
+
+all: index.html param.html
+
+param.html:
+	make -C ../xsl param.html
+	$(CP) ../xsl/param.html .
+
+index.html: slides.xml
+	$(XSLT) $< ../../xsl/html/docbook.xsl $@
+
+clean:
+	rm -f *.html
+
diff --git a/slides/doc/slides.xml b/slides/doc/slides.xml
index b9412e54b..0b73712a9 100644
--- a/slides/doc/slides.xml
+++ b/slides/doc/slides.xml
@@ -24,7 +24,7 @@ these options are and how to use them.</para>
 <section id="ch.stylesheet">
 <title>Choose a Stylesheet</title>
 
-<para>At the highest level, you can choose one of four stylesheets:</para>
+<para>At the highest level, you can choose one of five stylesheets:</para>
 
 <itemizedlist>
 <listitem>
@@ -38,6 +38,12 @@ per slide.
 </para>
 </listitem>
 
+<listitem>
+<para><filename>tables.xsl</filename> produces slides in HTML using tables, one page
+per slide.
+</para>
+</listitem>
+
 <listitem>
 <para><filename>w3c.xsl</filename> produces basic slides in HTML, one
 page per slide, using a navigation style similar to that of most W3C
@@ -54,8 +60,27 @@ page per slide, for print using XSL Formatting Objects.
 
 </section>
 
-<section id="ch.browser">
-<title>Choose a Browser</title>
+<section id="ch.params">
+<title>Choose your Parameters</title>
+
+<para>The <ulink url="param.html">parameter reference</ulink> summarizes the
+parameters that you can set to change the features of the slides.</para>
+
+<para>Be aware that some features require JavaScript. Some effort has been taken
+to assure that these features work across different browsers on different platforms,
+but it is possible that older browsers will not render slides that use JavaScript
+correctly.</para>
 
+</section>
+
+<section id="ch.process">
+<title>Process the Slides</title>
+
+<para>Run your slides source through your favorite XSLT processor using the stylesheet
+and parameters you selected.</para>
+
+<para>View the results in your favorite browser.</para>
+
+</section>
 
 </article>
-- 
2.40.0