"Fossies" - the Fresh Open Source Software Archive

Member "OpenSP-1.5.2/docsrc/releasenotes.xml" (15 Dec 2005, 34765 Bytes) of package /linux/misc/old/OpenSP-1.5.2.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) XML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <?xml version='1.0'?>
    2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    3   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
    4 <book>
    5   <bookinfo>
    6     <title>OpenSP 1.5.2</title>
    7     <subtitle>Release Notes</subtitle>
    8     <corpauthor>OpenJade Project</corpauthor>
    9     <edition>Release 1.5.2</edition>
   10     <pubdate>September 2005</pubdate>
   11     <copyright>
   12       <year>2002</year>
   13       <year>2003</year>
   14       <year>2005</year>
   15       <holder>OpenJade Project</holder>
   16     </copyright>
   17   </bookinfo>
   18 
   19   <chapter><title>OpenSP 1.5.2 Release Notes</title>
   20 
   21     <para>The OpenJade project provides a suite of tools and libraries for
   22 validating, processing and applying DSSSL (Document Style Semantics and
   23 Specification Language) style sheets to SGML and XML documents.</para>
   24     <para>OpenJade is a project undertaken by the community to maintain and
   25 extend James Clark's Jade, as well as the related SP suite of SGML/XML
   26 processing tools. OpenJade and OpenSP are distributed under the same license
   27 as Jade.</para>
   28     <para>OpenSP is written in C++ and provides a class library, libosp, which
   29 can be used as a basis for either open source or commerical projects. The
   30 library can be built as either a dynamic or static library.
   31 </para>
   32     <sect1><title>Applications of OpenSP</title>
   33       <para>The OpenSP library has been used in a number of projects. The
   34 World Wide Web consortium on-line HTML and XHTML validator is based on the
   35 OpenSP library. In addition to the OpenSP library a set of command line tools
   36 are provided to support the validation and transformation of SGML files. In
   37 particular <command>onsgmls</command> can validate both XML and SGML documents
   38 held on a local file system or accessed remotely via a web server using the
   39 HTTP protocol with standard URI notation; <command>osx</command> will convert
   40 SGML to XML to allow a library of SGML documents to be processed with XML
   41 tools.</para>
   42     </sect1>
   43 
   44     <sect1><title>Obtaining OpenSP</title>
   45       <para>OpenSP is a project hosted at sourceforge.net and is available
   46 from the OpenJade web site at http://openjade.sourceforge.net or directly from
   47 the OpenJade project page at http://sourceforge.net/projects/openjade</para>
   48       <para>OpenSP is provided in source code form. However, see <xref
   49 linkend="bindist"/> for information on how to obtain pre-compiled
   50 binary packages.</para>
   51     </sect1>
   52     <sect1><title>Supported Platforms</title>
   53       <para>OpenSP is intended to be as portable as possible. It should be
   54 possible to compile and build on most contemporary UNIX type platforms. In
   55 addition OpenSP should also build on Microsoft's Win32 based operating
   56 systems.
   57 </para>
   58       <para>OpenSP is known to compile with both the GNU gcc c++ compiler and
   59 Microsoft Visual C++. Other compilers have not been extensively tested.</para>
   60       <para>OpenSP 1.5.2 should build with the GNU gcc c++ compiler from
   61 version 2.95 up to version 4.0. </para>
   62       <para>OpenSP has been built on a number of architectures including Intel
   63 i386 and ia64, Alpha AXP, Sparc, PPC and S/390.</para>
   64       <para>The following table details known successful builds</para>
   65       <table id="platforms" frame="topbot"><title>Platforms on which OpenSP
   66 1.5 is known to build</title>
   67     <tgroup cols="4" align="left" colsep="0" rowsep="0">
   68       <colspec align="left" colname="c1" colwidth="1*" />
   69       <colspec colname="c2" colwidth="2*" />
   70       <colspec colname="c3" colwidth="2*" />
   71       <colspec colname="c4" colwidth="3*" />
   72       <thead>
   73         <row rowsep="1">
   74           <entry>Arch.</entry>
   75           <entry>OS</entry>
   76           <entry>Compiler</entry>
   77           <entry>Notes</entry>
   78         </row>
   79       </thead>
   80       <tbody>
   81         <row>
   82           <entry align="left">alpha</entry>
   83           <entry>Debian 3.1</entry>
   84           <entry>GNU gcc 4.0</entry>
   85           <entry></entry>
   86         </row>
   87         <row>
   88           <entry align="left">arm</entry>
   89           <entry>Debian 3.1</entry>
   90           <entry>GNU gcc 4.0</entry>
   91           <entry></entry>
   92         </row>
   93         <row>
   94           <entry align="left">hppa</entry>
   95           <entry>Debian 3.1</entry>
   96           <entry>GNU gcc 4.0</entry>
   97           <entry></entry>
   98         </row>
   99         <row>
  100           <entry align="left" morerows="3">i386</entry>
  101           <entry>Debian 3.1</entry>
  102           <entry>GNU gcc 4.0</entry>
  103           <entry></entry>
  104         </row>
  105         <row>
  106           <entry>Red Hat Linux 7.3</entry>
  107           <entry>Red Hat gcc 2.96</entry>
  108           <entry></entry>
  109         </row>
  110         <row>
  111           <entry>Red Hat Linux 7.3</entry>
  112           <entry>GNU gcc 3.2</entry>
  113           <entry></entry>
  114         </row>
  115         <row>
  116           <entry>SuSE Linux 8.1</entry>
  117           <entry>GNU gcc 3.2</entry>
  118           <entry></entry>
  119         </row>
  120         <row>
  121           <entry align="left">ia64</entry>
  122           <entry>Debian 3.1</entry>
  123           <entry>GNU gcc 4.0</entry>
  124           <entry></entry>
  125         </row>
  126         <row>
  127           <entry align="left">m68k</entry>
  128           <entry>Debian 3.1</entry>
  129           <entry>GNU gcc 4.0</entry>
  130           <entry></entry>
  131         </row>
  132         <row>
  133           <entry align="left">mips, mipsel</entry>
  134           <entry>Debian 3.1</entry>
  135           <entry>GNU gcc 4.0</entry>
  136           <entry></entry>
  137         </row>
  138         <row>
  139           <entry align="left">powerpc</entry>
  140           <entry>Debian 3.1</entry>
  141           <entry>GNU gcc 4.0</entry>
  142           <entry></entry>
  143         </row>
  144         <row>
  145           <entry align="left">s390</entry>
  146           <entry>Debian 3.1</entry>
  147           <entry>GNU gcc 4.0</entry>
  148           <entry></entry>
  149         </row>
  150         <row>
  151           <entry align="left">sparc</entry>
  152           <entry>Debian 3.1</entry>
  153           <entry>GNU gcc 4.0</entry>
  154           <entry></entry>
  155         </row>
  156         <row>
  157           <entry align="left">sparc</entry>
  158           <entry>Solaris 8/SunOS 5.8</entry>
  159           <entry>GNU gcc 4.0</entry>
  160           <entry></entry>
  161         </row>
  162       </tbody>
  163     </tgroup>
  164       </table>
  165       <para>Please report any successful builds not mentioned above to
  166 <email>openjade-devel@lists.sourceforge.net</email>, including any
  167 diffs/patches you have used.</para>
  168     </sect1>
  169     <sect1><title>Building OpenSP from Source</title>
  170       <para>OpenSP requires 20Mb to 50Mb of disk space to build. An
  171 installation will require around 10Mb to 20Mb depending on
  172 architecture.</para>
  173       <para>On UNIX platforms, OpenSP makes use of the GNU software
  174 configuration tools (autoconf, libtool, automake etc). The GNU C++ compiler
  175 and make utility should also be used. The steps required to build the OpenSP
  176 tools (<command>onsgmls</command>, <command>osgmlnorm</command>,
  177 <command>ospam</command>, <command>ospcat</command>,
  178 <command>ospent</command>, <command>osx</command>) and libraries are as
  179 follows:
  180 <screen>gzip -d OpenSP-1.5.2.tar.gz | tar xvf - 
  181 cd OpenSP-1.5.2
  182 ./configure <optional><option><replaceable>options...</replaceable></option></optional> 
  183 make</screen> You may need to switch to the super user
  184 <command>root</command> to complete the installation
  185 <screen>make install</screen>
  186 The <command>configure</command> script supports many options. These
  187 can be displayed using the command
  188 <screen>./configure --help</screen>
  189 In addition to the standard options, the following table describes options
  190 specific to OpenSP.</para>
  191       <table id="configure" frame="topbot"><title>OpenSP specific configure
  192 options</title>
  193     <tgroup cols="3" align="left" colsep="0" rowsep="0">
  194       <colspec colname="c1" colwidth="3*" />
  195       <colspec colname="c2" colwidth="1*" />
  196       <colspec colname="c3" colwidth="2*" />
  197       <thead>
  198         <row rowsep="1">
  199           <entry>Option</entry>
  200           <entry>Default</entry>
  201           <entry>Explanation</entry>
  202         </row>
  203       </thead>
  204       <tbody>
  205         <row>
  206           <entry><option>--enable-http</option></entry>
  207           <entry>No http support</entry>
  208           <entry>Include support for http. This allows the OpenSP tools to
  209 be used to validate or process SGML or XML documents directly from the World
  210 Wide Web. Example: <screen>onsgmls -s http://www.example.com</screen></entry>
  211         </row>
  212         <row>
  213           <entry><option>--enable-default-catalog=<replaceable>pathlist</replaceable></option></entry>
  214           <entry>Not enabled</entry>
  215           <entry>Provide one or more default catalog files or sysids, e.g.
  216 /usr/local/lib/sgml/catalog</entry>
  217         </row>
  218         <row>
  219           <entry><option>--enable-default-search-path=<replaceable>pathlist</replaceable></option></entry>
  220           <entry>Not enabled</entry>
  221           <entry>Provide a default value for
  222 <varname>SGML_SEARCH_PATH</varname></entry>
  223         </row>
  224         <row>
  225           <entry><option>--enable-xml-messages</option></entry>
  226           <entry>Not enabled</entry>
  227           <entry>Include support for XML Formatted Messages</entry>
  228         </row>
  229         <row>
  230           <entry><option>--disable-doc-build</option></entry>
  231           <entry>Enabled</entry>
  232           <entry>Do not build docs (man pages and release notes)</entry>
  233         </row>
  234         <row>
  235           <entry><option>--disable-dtddecl</option></entry>
  236           <entry>Enabled</entry>
  237           <entry>Do not include support for DTDDECL</entry>
  238         </row>
  239       </tbody>
  240     </tgroup>
  241       </table>
  242       <para>Please refer to the system documentation for details on building
  243 on the Win32 platform.</para>
  244     </sect1>
  245     <sect1 id="bindist"><title>Binary Distributions</title>
  246       <para>In addition to binary packages availble from the project, OpenSP
  247 has been a part of many software distributions, including the major Linux
  248 distributions as well as FreeBSD. Expect pre-compiled and packaged versions of
  249 the latest version of OpenSP to be available from your distributor in due
  250 course.</para>
  251     </sect1>
  252     <sect1><title>Installation</title>
  253       <para>In addition to the OpenSP executables and libraries you will also
  254 need various DTDs and declaration files. Some DTDs and associated files
  255 (entity definitions) are available in the <filename>pubtext</filename>
  256 directory of the distribution. However, more authoritative sources should be
  257 referenced to ensure that up-to-date versions are used. If you wish to process
  258 XML files, then suitable SGML declarations for valid XML documents should be
  259 used. Again, a sample set of declarations (<filename>xml.dcl</filename>) is
  260 provided in the <filename>pubtext</filename>, but more complete or recent
  261 versions may be available from other sources.</para>
  262       <para>OpenSP supports the standard SGML catalog facility; it is
  263 recommended that you set up and use such a catalog system.
  264 </para>
  265     </sect1>
  266     <sect1><title>Support</title>
  267       <para>If, after reading the documentation, you still have a problem,
  268 then you may require some additional help. The OpenJade project is a volunteer
  269 effort and as such does not provide any formal support. Instead, you should
  270 look to the community for support. Once part of the community, you, in turn,
  271 will be able to play your part in helping those that come after you. Here are
  272 some pointers to obtaining help:</para>
  273 
  274       <itemizedlist>
  275     <listitem>
  276       <para>If you obtained your OpenSP distribution in binary form from
  277 your operating system distributor and you have a build related problem - such
  278 as <command>onsgmls</command> crashing, then your first port of call should be
  279 your distributor.</para>
  280     </listitem>
  281 
  282     <listitem>
  283       <para>If you have a problem with the usage of the OpenSP tools, then
  284 you should try the openjade-users mailing list, see
  285 http://sf.net/projects/openjade/ for details.</para>
  286     </listitem>
  287 
  288     <listitem>
  289       <para>If you have a patch or bug fix for OpenJade, or are trying to
  290 use the OpenSP API then the openjade-devel mailing list is the appropriate
  291 forum.</para>
  292     </listitem>
  293 
  294       </itemizedlist>
  295 
  296       <para>Please choose only one mailing list to post to, as cross-posting
  297 is generally frowned upon. The various mailing lists are archived and
  298 searchable. It is always worth searching for your problem first, as it is
  299 often the case that someone has had the same problem before.</para>
  300 
  301     </sect1>
  302     <sect1><title>Version 1.5.2</title>
  303       <formalpara><title>Released December 2005.</title>
  304     <para>The release contains a number of enhancements together with
  305 support for version 4.0 of the GNU C++ compiler.</para>
  306       </formalpara>
  307       <para>The following table details the major improvements in OpenSP
  308 1.5.2</para>
  309       <table id="opensp152fixes" frame="topbot"><title>Changes for release
  310 1.5.2</title>
  311     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  312       <colspec colname="c1" colwidth="1*" />
  313       <colspec colname="c2" colwidth="3*" />
  314       <thead>
  315         <row rowsep="1">
  316           <entry>Item 1</entry>
  317           <entry>Added doc building and config option</entry>
  318         </row>
  319       </thead>
  320       <tbody>
  321         <row>
  322           <entry><para>Contributors</para></entry>
  323           <entry><para>Terje Bless, Neil Roeth</para></entry>
  324         </row>
  325         <row>
  326           <entry><para>Category</para></entry>
  327           <entry><para>Enhancement</para></entry>
  328         </row>
  329         <row>
  330           <entry><para>Description</para></entry>
  331           <entry><para>Enable creation of release notes and man pages as
  332 part of the standard build process.  Added option --disable-doc-build; this
  333 step requires several additional software packages, so a user who chooses not
  334 to install those tools or otherwise has problems building the docs can skip
  335 this step.</para></entry>
  336         </row>
  337       </tbody>
  338     </tgroup>
  339     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  340       <colspec colname="c1" colwidth="1*" />
  341       <colspec colname="c2" colwidth="3*" />
  342       <thead>
  343         <row rowsep="1">
  344           <entry>Item 2</entry>
  345           <entry>Updated local gettext</entry>
  346         </row>
  347       </thead>
  348       <tbody>
  349         <row>
  350           <entry><para>Contributor</para></entry>
  351           <entry><para>Terje Bless</para></entry>
  352         </row>
  353         <row>
  354           <entry><para>Category</para></entry>
  355           <entry><para>Enhancement</para></entry>
  356         </row>
  357         <row>
  358           <entry><para>Description</para></entry>
  359           <entry><para>A local gettext is provided for those platforms
  360           that have an old or broken gettext.  This has been updated to
  361           version 0.14.5.</para></entry>
  362         </row>
  363       </tbody>
  364     </tgroup>
  365     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  366       <colspec colname="c1" colwidth="1*" />
  367       <colspec colname="c2" colwidth="3*" />
  368       <thead>
  369         <row rowsep="1">
  370           <entry>Item 3</entry>
  371           <entry>Added config option to turn off DTDDECL support</entry>
  372         </row>
  373       </thead>
  374       <tbody>
  375         <row>
  376           <entry><para>Contributor</para></entry>
  377           <entry><para>Neil Roeth</para></entry>
  378         </row>
  379         <row>
  380           <entry><para>Category</para></entry>
  381           <entry><para>Enhancement</para></entry>
  382         </row>
  383         <row>
  384           <entry><para>Description</para></entry>
  385           <entry><para>Added option --disable-dtddecl to disable DTDDECL
  386 support.  The combination of DTDDECL support and enabling a default catalog
  387 and default SGML search path can cause poor performance.  Using this option
  388 allows you to use a default catalog and search path and still get good
  389 performance if DTDDECL support is not needed.</para></entry>
  390         </row>
  391       </tbody>
  392     </tgroup>
  393     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  394       <colspec colname="c1" colwidth="1*" />
  395       <colspec colname="c2" colwidth="3*" />
  396       <thead>
  397         <row rowsep="1">
  398           <entry>Item 4</entry>
  399           <entry>Updated/added translations</entry>
  400         </row>
  401       </thead>
  402       <tbody>
  403         <row>
  404           <entry><para>Contributor</para></entry>
  405           <entry><para>Karl Eichwalder</para></entry>
  406         </row>
  407         <row>
  408           <entry><para>Category</para></entry>
  409           <entry><para>Enhancement</para></entry>
  410         </row>
  411         <row>
  412           <entry><para>Description</para></entry>
  413           <entry><para>Updated German and French translations, added
  414 Turkish translation.</para></entry>
  415         </row>
  416       </tbody>
  417     </tgroup>
  418       </table>
  419     </sect1>
  420 
  421     <sect1><title>Version 1.5.1</title>
  422       <formalpara><title>Released October 2003.</title>
  423     <para>The release contains a number of new features together with
  424 support for version 3.3 for the GNU C++ compiler.</para>
  425       </formalpara>
  426       <para>The following table details the major improvements in OpenSP
  427 1.5.1</para>
  428       <table id="opensp151fixes" frame="topbot"><title>Changes for release
  429 1.5.1</title>
  430     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  431       <colspec colname="c1" colwidth="1*" />
  432       <colspec colname="c2" colwidth="3*" />
  433       <thead>
  434         <row rowsep="1">
  435           <entry>Item 1</entry>
  436           <entry>Runtime selection of message format</entry>
  437         </row>
  438       </thead>
  439       <tbody>
  440         <row>
  441           <entry><para>Contributor</para></entry>
  442           <entry><para>Nick Kew</para></entry>
  443         </row>
  444         <row>
  445           <entry><para>Category</para></entry>
  446           <entry><para>Enhancement</para></entry>
  447         </row>
  448         <row>
  449           <entry><para>Description</para></entry>
  450           <entry><para>Enable run time selection of message format with
  451 <envar>SP_MESSAGE_FORMAT</envar> environment variable. Value is one of
  452 <constant>XML</constant>, <constant>NONE</constant>,
  453 <constant>TRADITIONAL</constant>.</para></entry>
  454         </row>
  455       </tbody>
  456     </tgroup>
  457     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  458       <colspec colname="c1" colwidth="1*" />
  459       <colspec colname="c2" colwidth="3*" />
  460       <thead>
  461         <row rowsep="1">
  462           <entry>Item 2</entry>
  463           <entry>Support for HTTP redirection</entry>
  464         </row>
  465       </thead>
  466       <tbody>
  467         <row>
  468           <entry><para>Contributor</para></entry>
  469           <entry><para>Nick Kew</para></entry>
  470         </row>
  471         <row>
  472           <entry><para>Category</para></entry>
  473           <entry><para>Enhancement</para></entry>
  474         </row>
  475         <row>
  476           <entry><para>Description</para></entry>
  477           <entry><para>When validating/parseing a document using http,
  478 OpenSP will now follow any redirects headers/requests from the
  479 server</para></entry>
  480         </row>
  481       </tbody>
  482     </tgroup>
  483     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  484       <colspec colname="c1" colwidth="1*" />
  485       <colspec colname="c2" colwidth="3*" />
  486       <thead>
  487         <row rowsep="1">
  488           <entry>Item 3</entry>
  489           <entry>Specification of http user agent header</entry>
  490         </row>
  491       </thead>
  492       <tbody>
  493         <row>
  494           <entry><para>Contributor</para></entry>
  495           <entry><para>Nick Kew</para></entry>
  496         </row>
  497         <row>
  498           <entry><para>Category</para></entry>
  499           <entry><para>Enhancement</para></entry>
  500         </row>
  501         <row>
  502           <entry><para>Description</para></entry>
  503           <entry><para>The environment variable
  504 <envar>SP_HTTP_USER_AGENT</envar> can be used to specify a UserAgent:
  505 header.</para></entry>
  506         </row>
  507       </tbody>
  508     </tgroup>
  509     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  510       <colspec colname="c1" colwidth="1*" />
  511       <colspec colname="c2" colwidth="3*" />
  512       <thead>
  513         <row rowsep="1">
  514           <entry>Item 4</entry>
  515           <entry>Specification of http Accept: headers</entry>
  516         </row>
  517       </thead>
  518       <tbody>
  519         <row>
  520           <entry><para>Contributor</para></entry>
  521           <entry><para>Nick Kew</para></entry>
  522         </row>
  523         <row>
  524           <entry><para>Category</para></entry>
  525           <entry><para>Enhancement</para></entry>
  526         </row>
  527         <row>
  528           <entry><para>Description</para></entry>
  529           <entry><para>The environment variable
  530 <envar>SP_HTTP_ACCEPT</envar> can be used to specify Accept:
  531 headers.</para></entry>
  532         </row>
  533       </tbody>
  534     </tgroup>
  535     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  536       <colspec colname="c1" colwidth="1*" />
  537       <colspec colname="c2" colwidth="3*" />
  538       <thead>
  539         <row rowsep="1">
  540           <entry>Item 5</entry>
  541           <entry>Enhancements to <command>osx</command></entry>
  542         </row>
  543       </thead>
  544       <tbody>
  545         <row>
  546           <entry><para>Contributor</para></entry>
  547           <entry><para>Jessica Perry Hekman</para></entry>
  548         </row>
  549         <row>
  550           <entry><para>Category</para></entry>
  551           <entry><para>Enhancement</para></entry>
  552         </row>
  553         <row>
  554           <entry><para>Description</para></entry>
  555           <entry><para>A number of enhancements have been made to the
  556 <command>osx</command> tool: security fixes in the handling of output files;
  557 addition of the "preserve case option".</para></entry>
  558         </row>
  559       </tbody>
  560     </tgroup>
  561     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  562       <colspec colname="c1" colwidth="1*" />
  563       <colspec colname="c2" colwidth="3*" />
  564       <thead>
  565         <row rowsep="1">
  566           <entry>Item 6</entry>
  567           <entry>Addition of a test suite</entry>
  568         </row>
  569       </thead>
  570       <tbody>
  571         <row>
  572           <entry><para>Contributor</para></entry>
  573           <entry><para>Karl Eichwalder</para></entry>
  574         </row>
  575         <row>
  576           <entry><para>Category</para></entry>
  577           <entry><para>Enhancement</para></entry>
  578         </row>
  579         <row>
  580           <entry><para>Description</para></entry>
  581           <entry><para>A testing framework together with some initial
  582 tests have been added. Currently there are 22 tests. 6 of which
  583 fail.</para></entry>
  584         </row>
  585       </tbody>
  586     </tgroup>
  587     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  588       <colspec colname="c1" colwidth="1*" />
  589       <colspec colname="c2" colwidth="3*" />
  590       <thead>
  591         <row rowsep="1">
  592           <entry>Item 7</entry>
  593           <entry>Sundry build improvments</entry>
  594         </row>
  595       </thead>
  596       <tbody>
  597         <row>
  598           <entry><para>Contributor</para></entry>
  599           <entry><para>Neil Roeth, Peter O'Gorman et al</para></entry>
  600         </row>
  601         <row>
  602           <entry><para>Category</para></entry>
  603           <entry><para>Enhancement/Fixes</para></entry>
  604         </row>
  605         <row>
  606           <entry><para>Description</para></entry>
  607           <entry><para>Support for Mac OS/X, Darwin has been improved.
  608 Build infrastructure and localisation fixes and enhancements. Improved
  609 compiler support</para></entry>
  610         </row>
  611       </tbody>
  612     </tgroup>
  613       </table>
  614     </sect1>
  615 
  616     <sect1><title>Version 1.5</title>
  617       <formalpara><title>Released November 2002.</title>
  618     <para>In addition to many new features this version also supports the
  619 latest GNU C++ compiler: gcc 3.2 at the time of writing.</para>
  620       </formalpara>
  621       <para>The following table details the major improvements in OpenSP
  622 1.5</para>
  623 
  624       <table id="opensp15fixes" frame="topbot"><title>Changes for release
  625 1.5.1</title>
  626     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  627       <colspec colname="c1" colwidth="1*" />
  628       <colspec colname="c2" colwidth="3*" />
  629       <thead>
  630         <row rowsep="1">
  631           <entry>Item 1</entry>
  632           <entry>"--restricted" option</entry>
  633         </row>
  634       </thead>
  635       <tbody>
  636         <row>
  637           <entry><para>Contributor</para></entry>
  638           <entry><para>Liam Quinn</para></entry>
  639         </row>
  640         <row>
  641           <entry><para>Category</para></entry>
  642           <entry><para>Security Enhancement</para></entry>
  643         </row>
  644         <row>
  645           <entry><para>Description</para></entry>
  646           <entry><para>This new option restricts parsing of web based
  647 documents to local files. This can be classed as a security fix and is
  648 especially useful when using OpenSP within a CGI (Common Gateway Interface)
  649 application on a web server.</para></entry>
  650         </row>
  651       </tbody>
  652     </tgroup>
  653     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  654       <colspec colname="c1" colwidth="1*" />
  655       <colspec colname="c2" colwidth="3*" />
  656       <thead>
  657         <row rowsep="1">
  658           <entry>Item 2</entry>
  659           <entry>UNIX on-line manual pages</entry>
  660         </row>
  661       </thead>
  662       <tbody>
  663         <row>
  664           <entry><para>Contributor</para></entry>
  665           <entry><para>Ian Castle</para></entry>
  666         </row>
  667         <row>
  668           <entry><para>Category</para></entry>
  669           <entry><para>Documentation Bug</para></entry>
  670         </row>
  671         <row>
  672           <entry><para>Description</para></entry>
  673           <entry><para>on-line manual (man) pages for the commands
  674 included in the OpenSP package are now available for UNIX
  675 platforms</para></entry>
  676         </row>
  677       </tbody>
  678     </tgroup>
  679     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  680       <colspec colname="c1" colwidth="1*" />
  681       <colspec colname="c2" colwidth="3*" />
  682       <thead>
  683         <row rowsep="1">
  684           <entry>Item 3</entry>
  685           <entry>Upgrade GNU source configuration tools</entry>
  686         </row>
  687       </thead>
  688       <tbody>
  689         <row>
  690           <entry><para>Contributor</para></entry>
  691           <entry><para>Various</para></entry>
  692         </row>
  693         <row>
  694           <entry><para>Category</para></entry>
  695           <entry><para>Software Bug</para></entry>
  696         </row>
  697         <row>
  698           <entry><para>Description</para></entry>
  699           <entry><para>If you wish to create the various autoconf files
  700 then newer versions are required (autoconf 2.52 and later). As a result of the
  701 upgrades more platforms are potentially supported.</para></entry>
  702         </row>
  703       </tbody>
  704     </tgroup>
  705     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  706       <colspec colname="c1" colwidth="1*" />
  707       <colspec colname="c2" colwidth="3*" />
  708       <thead>
  709         <row rowsep="1">
  710           <entry>Item 4</entry>
  711           <entry>"-x" option to <command>osx</command> and other
  712 enhancements</entry>
  713         </row>
  714       </thead>
  715       <tbody>
  716         <row>
  717           <entry><para>Contributor</para></entry>
  718           <entry><para>Jessica Hekman</para></entry>
  719         </row>
  720         <row>
  721           <entry><para>Category</para></entry>
  722           <entry><para>Software Enhancement</para></entry>
  723         </row>
  724         <row>
  725           <entry><para>Description</para></entry>
  726           <entry><para>The "-x" command line option enables SDATA entities
  727 to be transformed into PIs or treated like normal entities (the
  728 default).</para></entry>
  729         </row>
  730       </tbody>
  731     </tgroup>
  732     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  733       <colspec colname="c1" colwidth="1*" />
  734       <colspec colname="c2" colwidth="3*" />
  735       <thead>
  736         <row rowsep="1">
  737           <entry>Item 5</entry>
  738           <entry>New Translations</entry>
  739         </row>
  740       </thead>
  741       <tbody>
  742         <row>
  743           <entry><para>Contributors</para></entry>
  744           <entry><para>Various</para></entry>
  745         </row>
  746         <row>
  747           <entry><para>Category</para></entry>
  748           <entry><para>Documentation Bug</para></entry>
  749         </row>
  750         <row>
  751           <entry><para>Description</para></entry>
  752           <entry><para>New and updated translations are available for
  753 "ja", "fr", "de" and "sv" languages.</para></entry>
  754     
  755         </row>
  756       </tbody>
  757     </tgroup>
  758     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  759       <colspec colname="c1" colwidth="1*" />
  760       <colspec colname="c2" colwidth="3*" />
  761       <thead>
  762         <row rowsep="1">
  763           <entry>Item 6</entry>
  764           <entry>Enhanced Message Handling</entry>
  765         </row>
  766       </thead>
  767       <tbody>
  768         <row>
  769           <entry><para>Contributor</para></entry>
  770           <entry><para>Epremis Corporation (Peter Newcomb)</para></entry>
  771         </row>
  772         <row>
  773           <entry><para>Category</para></entry>
  774           <entry><para>Software Enhancement</para></entry>
  775         </row>
  776         <row>
  777           <entry><para>Description</para></entry>
  778           <entry><para>Improvement in message handling within the library.
  779 This allows Windows (Win32) applications which make use of the OpenSP DLL to
  780 include other DLLs which can also make use of the message handling
  781 facility.</para></entry>
  782         </row>
  783       </tbody>
  784     </tgroup>
  785     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  786       <colspec colname="c1" colwidth="1*" />
  787       <colspec colname="c2" colwidth="3*" />
  788       <thead>
  789         <row rowsep="1">
  790           <entry>Item 7</entry>
  791           <entry>Error Messages formatted as XML</entry>
  792         </row>
  793       </thead>
  794       <tbody>
  795         <row>
  796           <entry><para>Contributor</para></entry>
  797           <entry><para>Nick Kew</para></entry>
  798         </row>
  799         <row>
  800           <entry><para>Category</para></entry>
  801           <entry><para>Software Enhancement</para></entry>
  802         </row>
  803         <row>
  804           <entry><para>Description</para></entry>
  805           <entry><para>A build time option to allow error messages to be
  806 output in XML format as opposed to plain old ASCII. Specify with the
  807 ./configure option <command>--enable-xml-messages</command></para></entry>
  808         </row>
  809       </tbody>
  810     </tgroup>
  811     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  812       <colspec colname="c1" colwidth="1*" />
  813       <colspec colname="c2" colwidth="3*" />
  814       <thead>
  815         <row rowsep="1">
  816           <entry>Item 8</entry>
  817           <entry>New syntax for  PI based architecture
  818 declarations</entry>
  819         </row>
  820       </thead>
  821       <tbody>
  822         <row>
  823           <entry><para>Contributor</para></entry>
  824           <entry><para>Epremis Corporation (Peter Newcomb)</para></entry>
  825         </row>
  826         <row>
  827           <entry><para>Category</para></entry>
  828           <entry><para>Software Enhancement</para></entry>
  829         </row>
  830         <row>
  831           <entry><para>Description</para></entry>
  832           <entry><para> Added support for the PI-based architecture using
  833 declaration syntax defined by Amendment 1 to ISO/IEC 10744:1997 (HyTime). This
  834 makes it possible to specify architectural support attributes when using
  835 architectures with XML, and is generally simpler than the original syntax. See
  836 http://www.ornl.gov/sgml/wg8/document/1985.htm for details. </para></entry>
  837         </row>
  838       </tbody>
  839     </tgroup>
  840     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  841       <colspec colname="c1" colwidth="1*" />
  842       <colspec colname="c2" colwidth="3*" />
  843       <thead>
  844         <row rowsep="1">
  845           <entry>Item 9</entry>
  846           <entry>Support name based virtual hosts when parsing a
  847 URI</entry>
  848         </row>
  849       </thead>
  850       <tbody>
  851         <row>
  852           <entry><para>Contributor</para></entry>
  853           <entry><para>Liam Quinn (and others)</para></entry>
  854         </row>
  855         <row>
  856           <entry><para>Category</para></entry>
  857           <entry><para>Software Enhancement</para></entry>
  858         </row>
  859         <row>
  860           <entry><para>Description</para></entry>
  861           <entry><para>Adds an HTTP/1.0 host header to HTTP requests. This
  862 makes it possible to parse and fetch DTDs specified in SYSTEM identifiers when
  863 the DTD resides on a name-based "Virutal Host".</para></entry>
  864         </row>
  865       </tbody>
  866     </tgroup>
  867     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  868       <colspec colname="c1" colwidth="1*" />
  869       <colspec colname="c2" colwidth="3*" />
  870       <thead>
  871         <row rowsep="1">
  872           <entry>Item 10</entry>
  873           <entry>64 Bit Platform Support</entry>
  874         </row>
  875       </thead>
  876       <tbody>
  877         <row>
  878           <entry><para>Category</para></entry>
  879           <entry><para>Software Enhancements</para></entry>
  880         </row>
  881         <row>
  882           <entry><para>Description</para></entry>
  883           <entry><para>Remove 32-bit assumptions so that 64 bit platforms
  884 such as Alpha, IA64, UltraSparc are supported.</para></entry>
  885         </row>
  886       </tbody>
  887     </tgroup>
  888     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  889       <colspec colname="c1" colwidth="1*" />
  890       <colspec colname="c2" colwidth="3*" />
  891       <thead>
  892         <row rowsep="1">
  893           <entry>Item 11</entry>
  894           <entry>New output options: comment, omitted, tagomit,
  895 attromit</entry>
  896         </row>
  897       </thead>
  898       <tbody>
  899         <row>
  900           <entry><para>Contributor</para></entry>
  901           <entry><para>Robert Braddock</para></entry>
  902         </row>
  903         <row>
  904           <entry><para>Category</para></entry>
  905           <entry><para>Software Enhancement</para></entry>
  906         </row>
  907         <row>
  908           <entry><para>Description</para></entry>
  909           <entry><para>Support for new output options: this allows
  910 comments and implied elements and/or attributes to be produced.</para></entry>
  911         </row>
  912       </tbody>
  913     </tgroup>
  914     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  915       <colspec colname="c1" colwidth="1*" />
  916       <colspec colname="c2" colwidth="3*" />
  917       <thead>
  918         <row rowsep="1">
  919           <entry>Item 12</entry>
  920           <entry>Enhanced Support for Annex K of ISO 8879</entry>
  921         </row>
  922       </thead>
  923       <tbody>
  924         <row>
  925           <entry><para>Category</para></entry>
  926           <entry><para>Software Enhancement</para></entry>
  927         </row>
  928         <row>
  929           <entry><para>Description</para></entry>
  930           <entry><para>More of Annex K is now supported. Common data
  931 attributes can now be specified in external entity
  932 declarations.</para></entry>
  933         </row>
  934       </tbody>
  935     </tgroup>
  936     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  937       <colspec colname="c1" colwidth="1*" />
  938       <colspec colname="c2" colwidth="3*" />
  939       <thead>
  940         <row rowsep="1">
  941           <entry>Item 13</entry>
  942           <entry>Support for GCC 3.2</entry>
  943         </row>
  944       </thead>
  945       <tbody>
  946         <row>
  947           <entry><para>Category</para></entry>
  948           <entry><para>Software Enhancement</para></entry>
  949         </row>
  950         <row>
  951           <entry><para>Description</para></entry>
  952           <entry><para>GCC 3.2 is now supported.</para></entry>
  953         </row>
  954       </tbody>
  955     </tgroup>
  956     <tgroup cols="2" align="left" colsep="0" rowsep="0">
  957       <colspec colname="c1" colwidth="1*" />
  958       <colspec colname="c2" colwidth="3*" />
  959       <thead>
  960         <row rowsep="1">
  961           <entry>Item 14</entry>
  962           <entry>Enhance Unicode support</entry>
  963         </row>
  964       </thead>
  965       <tbody>
  966         <row>
  967           <entry><para>Category</para></entry>
  968           <entry><para>Software Enhancement</para></entry>
  969         </row>
  970         <row>
  971           <entry><para>Description</para></entry>
  972           <entry><para>The multibyte version of OpenSP now uses 32 bit
  973 characters and supports the full UTF-16 range 0x000000-0x10ffff</para></entry>
  974         </row>
  975       </tbody>
  976     </tgroup>
  977       </table>
  978     </sect1>
  979     <sect1>
  980       <title>Version 1.4</title>
  981       <formalpara><title>Released February 2000</title>
  982     <para>Version 1.4 added many improvements. Changes
  983 included:</para></formalpara>
  984 
  985       <itemizedlist>
  986     <listitem>
  987       <para>Support for the koi8-r (RFC 1489) encoding.</para>
  988     </listitem>
  989 
  990     <listitem>
  991       <para>OpenSP now supports long (GNU Style) command line
  992 options.</para>
  993     </listitem>
  994 
  995     <listitem>
  996       <para>OpenSP is internationalized</para>
  997     </listitem>
  998 
  999     <listitem>
 1000       <para>New option -h or --help shows a list of all available options
 1001 with descriptions.</para>
 1002     </listitem>
 1003 
 1004     <listitem>
 1005       <para>New option -n and -x to see message numbers/relevant clauses
 1006 with messages.</para>
 1007     </listitem>
 1008 
 1009     <listitem>
 1010       <para>More of Annex K of ISO 8879 supported: SGML declarations on
 1011 subdocs, DATA declared value for attribures, DTD data entities and DTD
 1012 notations for doctypes, complete IMPLYDEF support, ENTITIES REF constraints,
 1013 URN parsing. Many new -w flags.</para>
 1014     </listitem>
 1015 
 1016     <listitem>
 1017       <para>DTDDECL support</para>
 1018     </listitem>
 1019 
 1020     <listitem>
 1021       <para>New spcat command line interface to the catalog
 1022 manager.</para>
 1023     </listitem>
 1024       </itemizedlist>
 1025     </sect1>
 1026     <sect1><title>Version 1.3.4</title>
 1027       <formalpara><title>Released October 1999</title>
 1028     <para>The second release from the OpenJade project. This version was
 1029 distributed as part of OpenJade 1.3</para>
 1030       </formalpara>
 1031 
 1032       <para>Changes in OpenJade 1.3.4</para>
 1033 
 1034       <itemizedlist>
 1035     <listitem>
 1036       <para>
 1037 Added the Entity classes to the public interface of the library/DLL.
 1038     </para>
 1039     </listitem>
 1040 
 1041       </itemizedlist>
 1042     </sect1>
 1043     <sect1><title>Version 1.3.3</title>
 1044       <para>The first release from the OpenJade project</para>
 1045     </sect1>
 1046   </chapter>
 1047 </book>