RELEASE-NOTES.xml #1

<?xml version='1.0' encoding="utf-8"?>
<!DOCTYPE article SYSTEM "http://docbook.org/xml/4.4/docbookx.dtd">
<article>
  <articleinfo>
    <title>DocBook Slides Release Notes</title>
    <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
    <releaseinfo role="cvs">$Id: RELEASE-NOTES.xml 9639 2012-10-22 18:41:00Z stefan $</releaseinfo> 
    <corpauthor>DocBook Project Development Team</corpauthor> 
  </articleinfo> 
  <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 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 Slides 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>
          <simpara>Added attribute-set to easily control appearance of
          footer</simpara>
        </listitem>
        <listitem>
          <simpara>Added support for
          <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>
        </listitem>
      </itemizedlist>
    </section>
    <section id="V340_html">
      <title>HTML</title>
      <itemizedlist>
        <listitem>
          <simpara><sgmltag>xref</sgmltag> to <sgmltag>foil</sgmltag>
          and <sgmltag>foilgroup</sgmltag> is now supported. (You must
          have the DocBook XSL stylesheets v1.67.0 or greater to use
          xrefs.)</simpara>
        </listitem>
        <listitem>
          <simpara>Added new parameter
          <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>
	</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 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 id="V340_install">Install</title>
      <itemizedlist>
	<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 id="old">
    <title>Older releases</title>
    <para>Sorry, there are no release notes for releases prior to the
    3.4.0 release.</para>
  </section>
</article>