OpenJade 1.3.2

Release Notes

OpenJade Project


Table of Contents
1. OpenJade 1.3.2 Release Notes
Applications of OpenJade
Obtaining OpenJade
Supported Platforms
Building OpenJade from Source
Binary Distributions
Installation
Support
Version 1.3.2
Version 1.3.1
Version 1.3
Version 1.2.2
Jade Version 1.2.1
List of Tables
1-1. Platforms on which OpenJade 1.3.2 is known to build.
1-2. OpenJade specific configure options
1-3. Changes for release 1.3.2
1-4. Changes for release 1.3.1

Chapter 1. OpenJade 1.3.2 Release Notes

OpenJade is a suite of tools for validating, processing and applying DSSSL (Document Style Semantics and Specification Language) style sheets to SGML and XML documents.

OpenJade is a project undertaken by the DSSSL 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.


Building OpenJade from Source

OpenJade requires 40Mb to 50Mb of disk space to build. An installation will require around 15Mb to 20Mb depending on architecture.

OpenJade 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 OpenJade tools (onsgmls, openjade, osgmlnorm, ospam, ospent, osx) and libraries are as follows:

gzip -d openjade-1.3.2.tar.gz | tar xvf -
cd openjade-1.3.2
./configure [options…]
make
You may need to switch to the super user root to complete the installation

make install
If you wish to install man pages for the various commands you should then do

make install-man
The configure script supports many options. These can be displayed using the command

./configure --help
In addition to the standard options, the following table describes options specific to openjade.

Please refer to the system documentation for details on building on the Win32 platform.


Version 1.3.2


Version 1.3.1

The following table details the major improvements in Openjade 1.3.1

Table 1-4. Changes for release 1.3.1

Item 1Support for MacOS X/ Darwin

References

Fink Project; Kogulé, Ryo

Category

Software Bug

Problem

OpenJade 1.3 does not build and run on the Mac OS X/Darwin platform

Resolution

OpenJade 1.3.1 has been enhanced to support Mac OS X/Darwin 1.4. The autoconf configuration system has been upgraded and also includes specific platform support. Some minor code alterations to improve code portability (C++ style changes). Note that the POSIX locale feature is not available on this platform.

Item 2UNIX on-line manual pages

References

None

Category

Documentation Bug

Problem

No on-line manual (man) pages available on UNIX platforms

Resolution

OpenJade 1.3.1 now has a man page for every command. Additionally, if OpenJade is used as a replacement for Jade, then compatibility man pages are included (i.e. man jade is synonymous with man openjade).

Item 3Upgrade GNU source configuration tools

References

Various sourceforge problem reports, SuSE Linux 7.3, Red Hat 7.2, Red Hat Bugzilla #46212

Category

Software Bug

Problem

The source configuration system is based on old versions of libtool and autoconf. In addition, there are problems with the generated Makefile files such that installation directories are not created.

Resolution

Upgraded to autoconf 2.52 and libtool 1.4. Upgraded the various support files. Included elements of automake support. Made the Makefiles more robust. These changes should facilitate porting to new/updated environments (i.e. those supported by newer versions of autoconf). Work has been done to enhance some of the custom autoconf tests to improve reliability.

Item 4Support for XML Byte Order Marks (BOM)

References

Source Forge bug #442560 (Terje Bless/Liam Quinn)

Category

Software Bug

Problem

Since OpenJade 1.3 was released, a second edition of the XML 1.0 specification has been released (REC-xml-20001006). This specification introduced the concept of Byte Order Marks to increase the sophistication of the detection of the character encoding system. OpenJade 1.3 would not recognize these, and rejected any XML file which included these as invalid.

Resolution

XML 1.0 Byte Order Marks are now accepted as valid XML.

Item 5Fix missing white space problem in processing instruction flow object

References

Source Forge Ref #505113, #505124 (Markus Hoenicka)

Category

Software Bug

Problem

No white space was emitted between the public-id and the system-id causing a malformed XML file to be generated.

Resolution

Fixed OpenJade to output a space between the public-id and the system-id.

Item 6Jadetex is now distributed independently

References

None

Category

Software Bug

Problem

OpenJade 1.3 shipped with Jadetex 2.7. Jadetex is developed and released separately from OpenJade.

Resolution

Removed jadetex files. Jadetex can be obtained from http://jadetex.sourceforge.net

Item 7Support for FreeBSD 4.4

References

FreeBSD 4.4 openjade port

Category

Software Bug

Problem

OpenJade 1.3 would not build on FreeBSD 4.x

Resolution

The source configuration system has been enhanced to support FreeBSD out of the box. Note that the POSIX locale feature of OpenJade is not available under FreeBSD.

Item 8Allow non alpha numeric characters in Table of Contents

References

Red Hat Bugzilla #31525

Category

Software Bug

Problem

Certain non alpha-numeric characters (such as $) do not appear correctly in the table of contents. This problem is confined to the TeX backend.

Resolution

Special characters are now correctly escaped in the TeX output file.

Item 9Support for latest Win32 build environments

References

None

Category

Software Bug

Problem

OpenJade 1.3 does not build with Visual C++ 6.0

Resolution

Fix C++ style to be compatible with Visual C++. Update build environment. OpenJade 1.3.1 should run in all Windows 32 environments from Windows 95 through Windows NT to Windows XP.

Item 10Enhancements for Software Packaging

References

SuSE Linux 7.3

Category

Software Bug

Problem

Numerous patches need to be applied to OpenJade 1.3 to enable packages to be built (RPM)

Resolution

Enhance Makefiles to ensure that packages are easy to build (including addition of DESTDIR environment variable). It should now be possible to build RPM packages and BSD ports without resorting to patches.

Item 11Support for newer GNU C++ compilers

References

SuSE Linux 7.3 (Andreas Schwab), Red Hat Linux 7.2, Connectiva Linux

Category

Software Bug

Problem

C++ is a shifting target. New compilers/standards demand changes.

Resolution

Various enhancements to allow OpenJade to build with the new GNU GCC 3.0 and the soon to be released GNU GCC 3.1 c++ compilers

Item 12Support for jadetex 3.4 and greater macros for two sided support

References

Sourceforge patch #439755, http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)

Category

Software Bug

Problem

Two Sided output support with the TeX backend is unreliable in OpenJade 1.3 and Jadetex 2.x.

Resolution

Enhance the TeX backend two sided output support and bring into line with advances in the jadetex latex front end. Two extension characteristics are introduced to allow control of two-side and two-side-start-on-right. This also fixes the "blank page at the end of the document" problem. The following new characteristics are available:


  "UNREGISTERED::OpenJade//Characteristic::page-two-side?"

  "UNREGISTERED::OpenJade//Characteristic::two-side-start-on-right?"

Item 13Prevent incorrect generation of ligatures in the TeX Backend

References

Red Hat Bugzilla #11497, #11779

Category

Software Bug

Problem

Certain sequences of characters (such as --) are not correctly escaped in the TeX backend, so that TeX incorrectly creates ligatures out of them (so that -- becomes an em dash —).

Resolution

OpenJade 1.3.1 now correctly escapes these character sequences. This is a particular problem when representing program code where sequences such as -- are often operators.

Item 14Improved time string handling

References

http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)

Category

Software Bug

Problem

OpenJade 1.3 does not support the (time<=?) comparison

Resolution

Various bugs fixed in the time string support of OpenJade. It is now possible to compare time, date and datetime. Also partial formats (such as YY-MM-DD, YYYY-MM or HH:MM) are now supported

Item 15Improvements in handling sosofo-append

References

http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)

Category

Software Bug

Problem

sosofo-append has problems with memory/stack usage when handling large lists of sosofo

Resolution

The fix optimizes sosofo-append to reduce its memory and stack usage when using it to build long list of sosofo :


    (let loop ( (res (empty-sosofo))
        (nl  (node-list-rest (children (current-node)))))
	    (loop (sosofo-append res (process-node-list
        (node-list-first nl)))
            (node-list-rest nl)))

Item 16Improved Table handling in TeX Backend

References

http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)

Category

Software Bug

Problem

Table handling in the TeX backend has numerous problems.

Resolution

Support for tables in the TeX backend has been improved with:

  • Support for nested tables.

  • cell-after-column-margin: and cell-before-column-margin: wasn't really working.

  • Row spanning was broken. This fix only supports 'start row alignment though.

  • Paragraphs in cell spanning multiple column are now working.

  • Support for the row-alignment: characteristic.

  • Support for cell-background? and background-color properties

Item 17Support for 'asis and 'asis-wrap

References

http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)

Category

Software Bug

Problem

The lines: characteristic in the paragraph flow object does not support the 'asis and 'asis-wrap values.

Resolution

This adds support for the 'asis and 'asis-wrap values for the paragraph's lines: characteristic.


Version 1.3