Blob Blame History Raw
<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<book id="relnotesb">
  <bookinfo>
    <title>OpenSP 1.5.2</title>
    <subtitle>Release Notes</subtitle>
    <corpauthor>OpenJade Project</corpauthor>
    <edition>Release 1.5.2</edition>
    <pubdate>September 2005</pubdate>
    <copyright>
      <year>2002</year>
      <year>2003</year>
      <year>2005</year>
      <holder>OpenJade Project</holder>
    </copyright>
  </bookinfo>

  <chapter id="relnotesc"><title>OpenSP 1.5.2 Release Notes</title>

    <para>The OpenJade project provides a suite of tools and libraries for
validating, processing and applying DSSSL (Document Style Semantics and
Specification Language) style sheets to SGML and XML documents.</para>
    <para>OpenJade is a project undertaken by the community to maintain and
extend James Clark's Jade, as well as the related SP suite of SGML/XML
processing tools. OpenJade and OpenSP are distributed under the same license
as Jade.</para>
    <para>OpenSP is written in C++ and provides a class library, libosp, which
can be used as a basis for either open source or commerical projects. The
library can be built as either a dynamic or static library.
</para>
    <sect1 id="apps"><title>Applications of OpenSP</title>
      <para>The OpenSP library has been used in a number of projects. The
World Wide Web consortium on-line HTML and XHTML validator is based on the
OpenSP library. In addition to the OpenSP library a set of command line tools
are provided to support the validation and transformation of SGML files. In
particular <command>onsgmls</command> can validate both XML and SGML documents
held on a local file system or accessed remotely via a web server using the
HTTP protocol with standard URI notation; <command>osx</command> will convert
SGML to XML to allow a library of SGML documents to be processed with XML
tools.</para>
    </sect1>

    <sect1 id="obtaining"><title>Obtaining OpenSP</title>
      <para>OpenSP is a project hosted at sourceforge.net and is available
from the OpenJade web site at http://openjade.sourceforge.net or directly from
the OpenJade project page at http://sourceforge.net/projects/openjade</para>
      <para>OpenSP is provided in source code form. However, see <xref
linkend="bindist"/> for information on how to obtain pre-compiled
binary packages.</para>
    </sect1>
    <sect1 id="supported"><title>Supported Platforms</title>
      <para>OpenSP is intended to be as portable as possible. It should be
possible to compile and build on most contemporary UNIX type platforms. In
addition OpenSP should also build on Microsoft's Win32 based operating
systems.
</para>
      <para>OpenSP is known to compile with both the GNU gcc c++ compiler and
Microsoft Visual C++. Other compilers have not been extensively tested.</para>
      <para>OpenSP 1.5.2 should build with the GNU gcc c++ compiler from
version 2.95 up to version 4.0. </para>
      <para>OpenSP has been built on a number of architectures including Intel
i386 and ia64, Alpha AXP, Sparc, PPC and S/390.</para>
      <para>The following table details known successful builds</para>
      <table id="platforms" frame="topbot"><title>Platforms on which OpenSP
1.5 is known to build</title>
	<tgroup cols="4" align="left" colsep="0" rowsep="0">
	  <colspec align="left" colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="2*" />
	  <colspec colname="c3" colwidth="2*" />
	  <colspec colname="c4" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Arch.</entry>
	      <entry>OS</entry>
	      <entry>Compiler</entry>
	      <entry>Notes</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry align="left">alpha</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">arm</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">hppa</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left" morerows="3">i386</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry>Red Hat Linux 7.3</entry>
	      <entry>Red Hat gcc 2.96</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry>Red Hat Linux 7.3</entry>
	      <entry>GNU gcc 3.2</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry>SuSE Linux 8.1</entry>
	      <entry>GNU gcc 3.2</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">ia64</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">m68k</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">mips, mipsel</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">powerpc</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">s390</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">sparc</entry>
	      <entry>Debian 3.1</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry align="left">sparc</entry>
	      <entry>Solaris 8/SunOS 5.8</entry>
	      <entry>GNU gcc 4.0</entry>
	      <entry></entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>
      <para>Please report any successful builds not mentioned above to
<email>openjade-devel@lists.sourceforge.net</email>, including any
diffs/patches you have used.</para>
    </sect1>
    <sect1 id="building"><title>Building OpenSP from Source</title>
      <para>OpenSP requires 20Mb to 50Mb of disk space to build. An
installation will require around 10Mb to 20Mb depending on
architecture.</para>
      <para>On UNIX platforms, OpenSP makes use of the GNU software
configuration tools (autoconf, libtool, automake etc). The GNU C++ compiler
and make utility should also be used. The steps required to build the OpenSP
tools (<command>onsgmls</command>, <command>osgmlnorm</command>,
<command>ospam</command>, <command>ospcat</command>,
<command>ospent</command>, <command>osx</command>) and libraries are as
follows:
<screen>gzip -d OpenSP-1.5.2.tar.gz | tar xvf - 
cd OpenSP-1.5.2
./configure <optional><option><replaceable>options...</replaceable></option></optional> 
make</screen> You may need to switch to the super user
<command>root</command> to complete the installation
<screen>make install</screen>
The <command>configure</command> script supports many options. These
can be displayed using the command
<screen>./configure --help</screen>
In addition to the standard options, the following table describes options
specific to OpenSP.</para>
      <table id="configure" frame="topbot"><title>OpenSP specific configure
options</title>
	<tgroup cols="3" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="3*" />
	  <colspec colname="c2" colwidth="1*" />
	  <colspec colname="c3" colwidth="2*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Option</entry>
	      <entry>Default</entry>
	      <entry>Explanation</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><option>--enable-http</option></entry>
	      <entry>No http support</entry>
	      <entry>Include support for http. This allows the OpenSP tools to
be used to validate or process SGML or XML documents directly from the World
Wide Web. Example: <screen>onsgmls -s http://www.example.com</screen></entry>
	    </row>
	    <row>
	      <entry><option>--enable-default-catalog=<replaceable>pathlist</replaceable></option></entry>
	      <entry>Not enabled</entry>
	      <entry>Provide one or more default catalog files or sysids, e.g.
/usr/local/lib/sgml/catalog</entry>
	    </row>
	    <row>
	      <entry><option>--enable-default-search-path=<replaceable>pathlist</replaceable></option></entry>
	      <entry>Not enabled</entry>
	      <entry>Provide a default value for
<varname>SGML_SEARCH_PATH</varname></entry>
	    </row>
	    <row>
	      <entry><option>--enable-xml-messages</option></entry>
	      <entry>Not enabled</entry>
	      <entry>Include support for XML Formatted Messages</entry>
	    </row>
	    <row>
	      <entry><option>--disable-doc-build</option></entry>
	      <entry>Enabled</entry>
	      <entry>Do not build docs (man pages and release notes)</entry>
	    </row>
	    <row>
	      <entry><option>--disable-dtddecl</option></entry>
	      <entry>Enabled</entry>
	      <entry>Do not include support for DTDDECL</entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>
      <para>Please refer to the system documentation for details on building
on the Win32 platform.</para>
    </sect1>
    <sect1 id="bindist"><title>Binary Distributions</title>
      <para>In addition to binary packages availble from the project, OpenSP
has been a part of many software distributions, including the major Linux
distributions as well as FreeBSD. Expect pre-compiled and packaged versions of
the latest version of OpenSP to be available from your distributor in due
course.</para>
    </sect1>
    <sect1 id="installation"><title>Installation</title>
      <para>In addition to the OpenSP executables and libraries you will also
need various DTDs and declaration files. Some DTDs and associated files
(entity definitions) are available in the <filename>pubtext</filename>
directory of the distribution. However, more authoritative sources should be
referenced to ensure that up-to-date versions are used. If you wish to process
XML files, then suitable SGML declarations for valid XML documents should be
used. Again, a sample set of declarations (<filename>xml.dcl</filename>) is
provided in the <filename>pubtext</filename>, but more complete or recent
versions may be available from other sources.</para>
      <para>OpenSP supports the standard SGML catalog facility; it is
recommended that you set up and use such a catalog system.
</para>
    </sect1>
    <sect1 id="support"><title>Support</title>
      <para>If, after reading the documentation, you still have a problem,
then you may require some additional help. The OpenJade project is a volunteer
effort and as such does not provide any formal support. Instead, you should
look to the community for support. Once part of the community, you, in turn,
will be able to play your part in helping those that come after you. Here are
some pointers to obtaining help:</para>

      <itemizedlist>
	<listitem>
	  <para>If you obtained your OpenSP distribution in binary form from
your operating system distributor and you have a build related problem - such
as <command>onsgmls</command> crashing, then your first port of call should be
your distributor.</para>
	</listitem>

	<listitem>
	  <para>If you have a problem with the usage of the OpenSP tools, then
you should try the openjade-users mailing list, see
http://sf.net/projects/openjade/ for details.</para>
	</listitem>

	<listitem>
	  <para>If you have a patch or bug fix for OpenJade, or are trying to
use the OpenSP API then the openjade-devel mailing list is the appropriate
forum.</para>
	</listitem>

      </itemizedlist>

      <para>Please choose only one mailing list to post to, as cross-posting
is generally frowned upon. The various mailing lists are archived and
searchable. It is always worth searching for your problem first, as it is
often the case that someone has had the same problem before.</para>

    </sect1>
    <sect1 id="v152"><title>Version 1.5.2</title>
      <formalpara><title>Released December 2005.</title>
	<para>The release contains a number of enhancements together with
support for version 4.0 of the GNU C++ compiler.</para>
      </formalpara>
      <para>The following table details the major improvements in OpenSP
1.5.2</para>
      <table id="opensp152fixes" frame="topbot"><title>Changes for release
1.5.2</title>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 1</entry>
	      <entry>Added doc building and config option</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributors</para></entry>
	      <entry><para>Terje Bless, Neil Roeth</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Enable creation of release notes and man pages as
part of the standard build process.  Added option --disable-doc-build; this
step requires several additional software packages, so a user who chooses not
to install those tools or otherwise has problems building the docs can skip
this step.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 2</entry>
	      <entry>Updated local gettext</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Terje Bless</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>A local gettext is provided for those platforms
	      that have an old or broken gettext.  This has been updated to
	      version 0.14.5.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 3</entry>
	      <entry>Added config option to turn off DTDDECL support</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Neil Roeth</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Added option --disable-dtddecl to disable DTDDECL
support.  The combination of DTDDECL support and enabling a default catalog
and default SGML search path can cause poor performance.  Using this option
allows you to use a default catalog and search path and still get good
performance if DTDDECL support is not needed.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 4</entry>
	      <entry>Updated/added translations</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Karl Eichwalder</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Updated German and French translations, added
Turkish translation.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>
    </sect1>

    <sect1 id="v151"><title>Version 1.5.1</title>
      <formalpara><title>Released October 2003.</title>
	<para>The release contains a number of new features together with
support for version 3.3 for the GNU C++ compiler.</para>
      </formalpara>
      <para>The following table details the major improvements in OpenSP
1.5.1</para>
      <table id="opensp151fixes" frame="topbot"><title>Changes for release
1.5.1</title>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 1</entry>
	      <entry>Runtime selection of message format</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Nick Kew</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Enable run time selection of message format with
<envar>SP_MESSAGE_FORMAT</envar> environment variable. Value is one of
<constant>XML</constant>, <constant>NONE</constant>,
<constant>TRADITIONAL</constant>.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 2</entry>
	      <entry>Support for HTTP redirection</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Nick Kew</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>When validating/parseing a document using http,
OpenSP will now follow any redirects headers/requests from the
server</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 3</entry>
	      <entry>Specification of http user agent header</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Nick Kew</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>The environment variable
<envar>SP_HTTP_USER_AGENT</envar> can be used to specify a UserAgent:
header.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 4</entry>
	      <entry>Specification of http Accept: headers</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Nick Kew</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>The environment variable
<envar>SP_HTTP_ACCEPT</envar> can be used to specify Accept:
headers.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 5</entry>
	      <entry>Enhancements to <command>osx</command></entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Jessica Perry Hekman</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>A number of enhancements have been made to the
<command>osx</command> tool: security fixes in the handling of output files;
addition of the "preserve case option".</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 6</entry>
	      <entry>Addition of a test suite</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Karl Eichwalder</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>A testing framework together with some initial
tests have been added. Currently there are 22 tests. 6 of which
fail.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 7</entry>
	      <entry>Sundry build improvments</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Neil Roeth, Peter O'Gorman et al</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Enhancement/Fixes</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Support for Mac OS/X, Darwin has been improved.
Build infrastructure and localisation fixes and enhancements. Improved
compiler support</para></entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>
    </sect1>

    <sect1 id="v15"><title>Version 1.5</title>
      <formalpara><title>Released November 2002.</title>
	<para>In addition to many new features this version also supports the
latest GNU C++ compiler: gcc 3.2 at the time of writing.</para>
      </formalpara>
      <para>The following table details the major improvements in OpenSP
1.5</para>

      <table id="opensp15fixes" frame="topbot"><title>Changes for release
1.5.1</title>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 1</entry>
	      <entry>"--restricted" option</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Liam Quinn</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Security Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>This new option restricts parsing of web based
documents to local files. This can be classed as a security fix and is
especially useful when using OpenSP within a CGI (Common Gateway Interface)
application on a web server.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 2</entry>
	      <entry>UNIX on-line manual pages</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Ian Castle</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Documentation Bug</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>on-line manual (man) pages for the commands
included in the OpenSP package are now available for UNIX
platforms</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 3</entry>
	      <entry>Upgrade GNU source configuration tools</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Various</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Bug</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>If you wish to create the various autoconf files
then newer versions are required (autoconf 2.52 and later). As a result of the
upgrades more platforms are potentially supported.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 4</entry>
	      <entry>"-x" option to <command>osx</command> and other
enhancements</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Jessica Hekman</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>The "-x" command line option enables SDATA entities
to be transformed into PIs or treated like normal entities (the
default).</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 5</entry>
	      <entry>New Translations</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributors</para></entry>
	      <entry><para>Various</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Documentation Bug</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>New and updated translations are available for
"ja", "fr", "de" and "sv" languages.</para></entry>
	
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 6</entry>
	      <entry>Enhanced Message Handling</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Epremis Corporation (Peter Newcomb)</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Improvement in message handling within the library.
This allows Windows (Win32) applications which make use of the OpenSP DLL to
include other DLLs which can also make use of the message handling
facility.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 7</entry>
	      <entry>Error Messages formatted as XML</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Nick Kew</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>A build time option to allow error messages to be
output in XML format as opposed to plain old ASCII. Specify with the
./configure option <command>--enable-xml-messages</command></para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 8</entry>
	      <entry>New syntax for  PI based architecture
declarations</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Epremis Corporation (Peter Newcomb)</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para> Added support for the PI-based architecture using
declaration syntax defined by Amendment 1 to ISO/IEC 10744:1997 (HyTime). This
makes it possible to specify architectural support attributes when using
architectures with XML, and is generally simpler than the original syntax. See
http://www.ornl.gov/sgml/wg8/document/1985.htm for details. </para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 9</entry>
	      <entry>Support name based virtual hosts when parsing a
URI</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Liam Quinn (and others)</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Adds an HTTP/1.0 host header to HTTP requests. This
makes it possible to parse and fetch DTDs specified in SYSTEM identifiers when
the DTD resides on a name-based "Virutal Host".</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 10</entry>
	      <entry>64 Bit Platform Support</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancements</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Remove 32-bit assumptions so that 64 bit platforms
such as Alpha, IA64, UltraSparc are supported.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 11</entry>
	      <entry>New output options: comment, omitted, tagomit,
attromit</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Contributor</para></entry>
	      <entry><para>Robert Braddock</para></entry>
	    </row>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>Support for new output options: this allows
comments and implied elements and/or attributes to be produced.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 12</entry>
	      <entry>Enhanced Support for Annex K of ISO 8879</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>More of Annex K is now supported. Common data
attributes can now be specified in external entity
declarations.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 13</entry>
	      <entry>Support for GCC 3.2</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>GCC 3.2 is now supported.</para></entry>
	    </row>
	  </tbody>
	</tgroup>
	<tgroup cols="2" align="left" colsep="0" rowsep="0">
	  <colspec colname="c1" colwidth="1*" />
	  <colspec colname="c2" colwidth="3*" />
	  <thead>
	    <row rowsep="1">
	      <entry>Item 14</entry>
	      <entry>Enhance Unicode support</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><para>Category</para></entry>
	      <entry><para>Software Enhancement</para></entry>
	    </row>
	    <row>
	      <entry><para>Description</para></entry>
	      <entry><para>The multibyte version of OpenSP now uses 32 bit
characters and supports the full UTF-16 range 0x000000-0x10ffff</para></entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>
    </sect1>
    <sect1 id="v14">
      <title>Version 1.4</title>
      <formalpara><title>Released February 2000</title>
	<para>Version 1.4 added many improvements. Changes
included:</para></formalpara>

      <itemizedlist>
	<listitem>
	  <para>Support for the koi8-r (RFC 1489) encoding.</para>
	</listitem>

	<listitem>
	  <para>OpenSP now supports long (GNU Style) command line
options.</para>
	</listitem>

	<listitem>
	  <para>OpenSP is internationalized</para>
	</listitem>

	<listitem>
	  <para>New option -h or --help shows a list of all available options
with descriptions.</para>
	</listitem>

	<listitem>
	  <para>New option -n and -x to see message numbers/relevant clauses
with messages.</para>
	</listitem>

	<listitem>
	  <para>More of Annex K of ISO 8879 supported: SGML declarations on
subdocs, DATA declared value for attribures, DTD data entities and DTD
notations for doctypes, complete IMPLYDEF support, ENTITIES REF constraints,
URN parsing. Many new -w flags.</para>
	</listitem>

	<listitem>
	  <para>DTDDECL support</para>
	</listitem>

	<listitem>
	  <para>New spcat command line interface to the catalog
manager.</para>
	</listitem>
      </itemizedlist>
    </sect1>
    <sect1 id="v134"><title>Version 1.3.4</title>
      <formalpara><title>Released October 1999</title>
	<para>The second release from the OpenJade project. This version was
distributed as part of OpenJade 1.3</para>
      </formalpara>

      <para>Changes in OpenJade 1.3.4</para>

      <itemizedlist>
	<listitem>
	  <para>
Added the Entity classes to the public interface of the library/DLL.
    </para>
	</listitem>

      </itemizedlist>
    </sect1>
    <sect1 id="v133"><title>Version 1.3.3</title>
      <para>The first release from the OpenJade project</para>
    </sect1>
  </chapter>
</book>