Documentation updates

diff --git a/slides/doc/.cvsignore b/slides/doc/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
+++ b/slides/doc/.cvsignore
@@ -0,0 +1 @@
+*.html

diff --git a/slides/doc/Makefile b/slides/doc/Makefile
new file mode 100644 (file)
index 0000000..d9618ce
--- /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 b9412e54be795420c1fc118ac32d8826b52a207e..0b73712a9f6381a19d4f99a5ac3fa25aad460d68 100644 (file)
--- 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>