updates for 3.4.0 release

diff --git a/slides/RELEASE-NOTES.xml b/slides/RELEASE-NOTES.xml
index 69092c9f600e87d28d4a08d479c0cd104955ce0c..f6fea2c5c280e08c9fc814e449f856aa1dd35de9 100644 (file)
--- a/slides/RELEASE-NOTES.xml
+++ b/slides/RELEASE-NOTES.xml
@@ -1,25 +1,68 @@
 <?xml version='1.0' encoding="utf-8"?>
-<!DOCTYPE article SYSTEM "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+<!DOCTYPE article SYSTEM "http://docbook.org/xml/4.4/docbookx.dtd">
 <article>
   <articleinfo>
     <title>DocBook Slides Release Notes</title>
-    <pubdate>10 November 2004</pubdate>
+    <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
     <releaseinfo role="cvs">$Id$</releaseinfo> 
-    <corpauthor>DocBook Open Repository Team</corpauthor> 
+    <corpauthor>DocBook Project Development Team</corpauthor> 
   </articleinfo> 
-  <para>These are the release notes for the DocBook Slides package.
-  At a minimum, this file attempts to document changes to the public
-  APIs and provide a high-level overview of the features added in each
-  release.</para>
+  <para>These are the release notes for the DocBook Slides
+  distribution. This file provides a high-level overview of features
+  and API changes in each release.</para>
+
+  <para>Bug fixes are (mostly) not documented here. For a complete
+  list of changes, including descriptions of bug fixes, see the <ulink
+  url="NEWS"/> file, which is auto-generated from the commit
+  descriptions for changes in the project CVS repository.</para>
+
   <section>
     <title>Release 3.4.0</title>
-    <para>This is a feature release that also contains fixes for a few
-    bugs. The main feature changes arenewly added support for
-    generating presentations in HTML Help, Keynote, and SVG
-    formats. See the <ulink url="WhatsNew"/> file for a complete list
-    of changes made since the previous release. The following is a
-    summary of the user-visible changes.</para>
-    <section>
+    <para>This is a feature release that includes some significant
+    schema changes as well as fixes for a few bugs. The feature
+    changes include newly added support for generating presentations
+    in HTML Help format. There are also experimental versions of
+    stylesheets for generating presentations in Keynote and SVG
+    formats. It also includes a new (and still experimental)
+    <filename><ulink url="install.sh" >install.sh</ulink></filename>
+    script to facilitate XML catalog and locating-rules setup.</para>
+    <section id="V340_schema">
+      <title>Schemas</title>
+      <itemizedlist>
+       <listitem>
+         <para>Slides (non-full) is now based on <ulink
+         url="http://docbook.org/xml/simple/1.1/index.html" >Simplified
+         DocBook 1.1</ulink> and Slides "full" is now based on <ulink
+         url="http://docbook.org/xml/4.4/index.html" >DocBook
+         4.4</ulink>. The main benefit this provides is the ability to
+         use HTML tables in your Slide XML source (instead of just CALS
+         tables).</para>
+       </listitem>
+       <listitem>
+         <para>RELAX NG schemas in RNC (compact-syntax) form as well as
+         in RNG (XML syntax) form are now included in the
+         distribution. You can use those to do context-sensitive
+         Slides editing in a RELAX NG-aware editor such as Emacs/nXML,
+         oXygen XML Editor, XMLBuddy, or Exchanger XML Editor. (Note
+         that the RELAX NG schemas are currently generated from the
+         DTDs).</para>
+       </listitem>
+       <listitem>
+         <para>A <filename><ulink url="locatingrules.xml"
+         >locatingrules.xml</ulink> </filename> file has been added
+         to the distribution. The
+         <filename><ulink url="locatingrules.xml"
+         >locatingrules.xml</ulink></filename> file tells a
+         "locating rules"-aware editor such as Emacs/nXML to
+         automatically associate the included RELAX NG Slides schema
+         with any document whose root element is
+         <sgmltag>slides</sgmltag>, <sgmltag>foil</sgmltag>,
+         <sgmltag>foilgroup</sgmltag>, or
+         <sgmltag>speakernotes</sgmltag>.</para>
+       </listitem>
+      </itemizedlist>
+    </section>
+    <section id="V340_fo">
       <title>FO</title>
       <itemizedlist>
         <listitem>
@@ -28,16 +71,19 @@
         </listitem>
         <listitem>
           <simpara>Added support for
-          <sgmltag>foil</sgmltag>/<sgmltag>subtitle</sgmltag>. Bookmarks
-          in XEP can contain i18n characters.</simpara>
+          <sgmltag>foil</sgmltag>/<sgmltag>subtitle</sgmltag></simpara>
+       </listitem>
+       <listitem>
+         <simpara>Bookmarks in XEP can now contain i18n
+         characters</simpara>
         </listitem>
         <listitem>
           <simpara>Changed attribute namespaces accordingly to new
-          schema used for titlepage templates.</simpara>
+          schema used for titlepage templates</simpara>
         </listitem>
       </itemizedlist>
     </section>
-    <section>
+    <section id="V340_html">
       <title>HTML</title>
       <itemizedlist>
         <listitem>
@@ -51,42 +97,39 @@
           <parameter>show.foil.number</parameter> which can enable
           numbering of slides. Currently works only with
           <filename>frames.xsl</filename> and
-          <literal>multiframe=0</literal>.</simpara>
+          <literal>multiframe=0</literal></simpara>
+       </listitem>
+       <listitem>
+         <simpara>Added support for <literal><ulink
+         url="http://www.sagehill.net/docbookxsl/Chunking.html#dbhtmlDirPI"
+         >dbhtml dir</ulink></literal> processing instruction</simpara>
         </listitem>
       </itemizedlist>
     </section>
-    <section>
+    <section id="V340_htmlhelp">
       <title>HTML Help</title>
       <itemizedlist>
         <listitem>
-          <simpara>Slides can now be generated in HTML Help format.</simpara>
-        </listitem>
-      </itemizedlist>
-    </section>
-    <section>
-      <title>Keynote</title>
-      <itemizedlist>
-        <listitem>
-          <simpara>Slides can now be generated in Keynote format.</simpara>
-         <note>
-           <simpara>There is not yet any user documentation
-           describing how to use the Keynote stylesheet.</simpara>
-         </note>
+          <simpara>Slides can now be generated in HTML Help format</simpara>
         </listitem>
       </itemizedlist>
     </section>
     <section>
-      <title>SVG</title>
+      <title id="V340_install">Install</title>
       <itemizedlist>
-        <listitem>
-          <simpara>Slides can now be generated using SVG.</simpara>
-         <note>
-           <simpara>The SVG stylesheet is still a bit rough and not
-           yet documented; users are encouraged to try it and post
-           comments to <literal>docbook-apps</literal></simpara>
-         </note>
-        </listitem>
+       <listitem>
+         <para>A new (and still experimental) <filename><ulink
+         url="install.sh" >install.sh</ulink></filename> file has
+         been added to the Slides distribution. For information on
+         using it, see the <filename><ulink url="INSTALL"
+         >INSTALL</ulink></filename> file.</para>
+       </listitem>
       </itemizedlist>
     </section>
   </section>
+  <section>
+    <title>Older releases</title>
+    <para>Sorry, there are no release notes for releases prior to the
+    3.4.0 release.</para>
+  </section>
 </article>