7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
21 NAME="AEN2">OpenJade 1.3.2</H1
30 >Copyright © 2002 by OpenJade Project</P
42 >OpenJade 1.3.2 Release Notes</A
49 >Applications of OpenJade</A
54 >Obtaining OpenJade</A
59 >Supported Platforms</A
64 >Building OpenJade from Source</A
69 >Binary Distributions</A
104 >Jade Version 1.2.1</A
121 >Platforms on which OpenJade 1.3.2 is known to build.</A
126 >OpenJade specific configure options</A
130 HREF="#openjade132fixes"
131 >Changes for release 1.3.2</A
135 HREF="#openjade131fixes"
136 >Changes for release 1.3.1</A
144 NAME="AEN11">Chapter 1. OpenJade 1.3.2 Release Notes</H1
146 >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.</P
148 >OpenJade is a project undertaken by the DSSSL community to maintain
149 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.</P
155 NAME="AEN15">Applications of OpenJade</H2
157 >Many different projects, organizations and companies make use of OpenJade to publish documentation. The SGML/XML backend enables the generation of "world wide web ready" documents while the TeX backend allows high quality "ready for press" output to be obtained. The FreeBSD Handbook (second edition) ISBN: 1571763031 is one such example of a book created using OpenJade.</P
164 NAME="AEN18">Obtaining OpenJade</H2
166 >OpenJade is a project hosted at sourceforge.net and is available
167 from the OpenJade web site at http://openjade.sourceforge.net or directly
168 from the OpenJade project page at http://sourceforge.net/projects/openjade</P
170 >OpenJade is provided in source code form. However as a courtesy
171 to Win32 users where development tools are not always available, a binary release for the Win32 platform is usually available.</P
178 NAME="AEN22">Supported Platforms</H2
180 >OpenJade is intended to be as portable as possible. It should be
181 possible to compile and build on most contemporary UNIX type platforms. In
182 addition OpenJade will also build on Microsoft's Win32 based operating systems.
185 >OpenJade is known to compile with both the GNU gcc c++ compiler and
186 Microsoft Visual C++. Other compilers have not been extensively tested.</P
188 >OpenJade has been successfully built with the following GNU compilers:
189 Red Hat g++ 2.96, GCC g++ 2.95.3, GCC g++ 3.2</P
191 >OpenJade has been built on a number of architectures including Intel i386 and ia64, Alpha AXP, Sparc, PPC and S/390, S/390x.</P
193 >The following table details known successful builds</P
199 >Table 1-1. Platforms on which OpenJade 1.3.2 is known to build.</B
323 >Red Hat Linux 7.3</TD
328 >Red Hat gcc 2.96</TD
340 >Red Hat Linux 7.3</TD
505 >Please report any successful builds not mentioned above to <TT
508 HREF="mailto:openjade-devel@lists.sourceforge.net"
509 >openjade-devel@lists.sourceforge.net</A
511 >, including any diffs/patches you have used.</P
518 NAME="AEN107">Building OpenJade from Source</H2
520 >OpenJade requires 40Mb to 50Mb of disk space to build. An installation
521 will require around 15Mb to 20Mb depending on architecture.</P
523 >OpenJade makes use of the GNU software configuration tools (autoconf, libtool, automake etc).
524 The GNU C++ compiler and make utility should also be used.
525 The steps required to build the OpenJade tools (<B
543 >) and libraries are as follows:
546 >gzip -d openjade-1.3.2.tar.gz | tar xvf -
563 You may need to switch to the super user <B
566 > to complete the installation
572 If you wish to install man pages for the various commands you should then do
575 > make install-man</PRE
580 > script supports many options. These can be displayed using the command
583 > ./configure --help
586 In addition to the standard options, the following table describes options specific to openjade.</P
592 >Table 1-2. OpenJade specific configure options</B
624 >--enable-spincludedir=path</TT
630 >/usr/include/OpenSP</TD
635 >Define the path where the OpenSP include files may be found.</TD
644 >--enable-splibdir=path</TT
655 >Define the path where the OpenSP library (libosp) may be found.</TD
670 >MIF support is enabled</TD
675 >disable support for FrameMaker MIF output (the <TT
696 >html support enabled</TD
701 >disable support for HTML+CSS output (the <TT
716 >--enable-default-catalog=<TT
732 >Provide one or more default catalog files or sysids, e.g. /usr/local/lib/sgml/catalog</TD
741 >--enable-default-search-path=<TT
757 >Provide a default value for <TT
759 >SGML_SEARCH_PATH</TT
766 >Please refer to the system documentation for details on building on the Win32 platform.</P
773 NAME="AEN176">Binary Distributions</H2
775 >Although the OpenJade project does not make binary distributions available, OpenJade 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 OpenJade to be available from your distributor in due course.</P
782 NAME="AEN179">Installation</H2
784 >In addition to the OpenJade executables and libraries you will also need various DTDs and stylesheets.
785 Some DTDs and associated files (entity definitions) are available in the <TT
788 > directory of the distribution.
789 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 (<TT
792 >) is provided in the <TT
795 >, but more complete or recent versions may be available from other sources.</P
797 >OpenJade supports the standard SGML catalog facility; it is
798 recommended that you set up and use such a catalog system.
800 you will create your own DSSSL stylesheets for use with OpenJade, however, users
801 of the OASIS DocBook DTD should be aware that extensive, and modular, stylesheets are available from the DocBook project at http://docbook.sourceforge.net.</P
803 >If you wish to make use of the TeX backend you will require an up to
804 date distribution of laTeX such as teTeX, TeXlive or fpTeX. In addition you
805 will also require the jadetex package, available from http://jadetex.sourceforge.net.</P
812 NAME="AEN187">Support</H2
814 >If, after reading the documentation, you still have a problem, then you
815 may require some additional help.
816 The OpenJade project is a volunteer effort and as such does not provide any formal support.
817 Instead, you should look to the community for support.
818 Once part of the community, you, in turn, will be able to play your part in
819 helping those that come after you. Here are some pointers to obtaining help:</P
825 >If you obtained your OpenJade tools in binary form from your operating system distributor and you have a build related problem -
826 such as openjade crashing, then your first port of call should be your distributor.</P
830 >If you have a problem with the usage of openjade and tools, or general queries about DSSSL then you should try the DSSSL mailing list, see http://www.mulberrytech.com/dsssl/dssslist/ for details.</P
834 >If you are using the DocBook DTD and especially if you are also using the Modular DocBook DSSSL stylesheets, then the docbook-apps mailing list is the place to go.
835 See http://www.oasis-open.org/docbook/mailinglist/ for details.</P
839 >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.</P
843 >Please choose only one mailing list to post to, as cross-posting is generally frowned upon.
844 The various mailing lists are archived and searchable.
845 It is always worth searching for your problem first, as it is often the case that someone has had the same problem before.</P
852 NAME="AEN200">Version 1.3.2</H2
857 >Released December 2002. </B
858 >This release allows openjade to be built against the most recent OpenSP release - version 1.5. It also contains some fixes for the MIF backend which were omitted from the 1.3.1 release. OpenSP is now distributed in a separate package and made available on its own release cycle</P
863 NAME="openjade132fixes"><P
865 >Table 1-3. Changes for release 1.3.2</B
881 >MIF Backend Fixes</TH
898 >G. Seshadri et al.</P
930 >Issues with page size and page header/footers</P
946 >Fix to make sure that right header is shown in documents and
947 that document page size is initialised correctly.</P
966 >Support for building OpenSP 1.5</TH
983 >Ian Castle, Karl Eichwalder</P
1015 >OpenSP is now at version 1.5 which has many improvements
1032 >It is desirable to use OpenSP 1.5 which has many improvements
1033 over version 1.3.4 which shipped with openjade 1.3.1. However, it is
1034 awkward having to have two versions of OpenSP at the same time. OpenJade
1035 1.4 is not ready for release yet, so version 1.3.2 will link against
1036 OpenSP 1.5 and later - and no longer includes the old version 1.3.4 of OpenSP. </P
1055 >Correct definition of "attribute" in builtin.dsl</TH
1072 >Toby Speight, Debian Bug #145242</P
1104 >The definition of "attribute" (ISO/IEC 10179:1996, section 10.2.5) for SGML property operations was not correct.</P
1120 >The definition has been corrected in accordance
1121 with the standard.</P
1140 >XML backend doesn't quote "&" in attribute values</TH
1157 >Toby Speight, Debian Bug #147073</P
1189 >When using OpenJade with the XML or SGML backend to output
1190 attribute values containing the '&' character, the output is not
1207 >Fixed the Transform FOT Builder so that for XML output the
1208 '&' character is properly quoted.</P
1220 NAME="AEN319">Version 1.3.1</H2
1225 >Released January 2002. </B
1226 >This release is primarily a maintenance release. It delivers two key advantages over the OpenJade 1.3 release: Support for contemporary platforms (operating systems and compilers) and incorporates the various patches and improvements, especially to the TeX backend, which have been extensively used over the last few years. Probably the biggest benefit to TeX backend users are the enhanced table support and improved two sided output support (in conjunction with improvements to the companion jadetex package).</P
1229 >The following table details the major improvements in Openjade 1.3.1</P
1233 NAME="openjade131fixes"><P
1235 >Table 1-4. Changes for release 1.3.1</B
1251 >Support for MacOS X/ Darwin</TH
1268 >Fink Project; Kogulé, Ryo</P
1300 >OpenJade 1.3 does not build and run on the Mac OS X/Darwin platform</P
1316 >OpenJade 1.3.1 has been enhanced to support Mac OS X/Darwin 1.4. The
1317 autoconf configuration system has been upgraded and also includes specific
1318 platform support. Some minor code alterations to improve code portability (C++
1319 style changes). Note that the POSIX locale feature is not available on this platform.</P
1338 >UNIX on-line manual pages</TH
1371 >Documentation Bug</P
1387 >No on-line manual (man) pages available on UNIX platforms</P
1403 >OpenJade 1.3.1 now has a man page for every command. Additionally, if
1404 OpenJade is used as a replacement for Jade, then compatibility man pages are included (i.e.
1405 man jade is synonymous with man openjade).</P
1424 >Upgrade GNU source configuration tools</TH
1441 >Various sourceforge problem reports, SuSE Linux 7.3, Red Hat 7.2, Red Hat Bugzilla #46212</P
1473 >The source configuration system is based on old versions of libtool and autoconf.
1474 In addition, there are problems with the generated Makefile files such that installation
1475 directories are not created.</P
1491 >Upgraded to autoconf 2.52 and libtool 1.4. Upgraded the various support files.
1492 Included elements of automake support. Made the Makefiles more robust. These changes
1493 should facilitate porting to new/updated environments (i.e. those supported by
1494 newer versions of autoconf). Work has been done to enhance some of the custom autoconf tests to
1495 improve reliability.</P
1514 >Support for XML Byte Order Marks (BOM)</TH
1531 >Source Forge bug #442560 (Terje Bless/Liam Quinn)</P
1563 >Since OpenJade 1.3 was released, a second edition of the XML 1.0 specification
1564 has been released (REC-xml-20001006). This specification introduced the concept
1565 of Byte Order Marks to increase the sophistication of the detection of
1566 the character encoding system. OpenJade 1.3 would not recognize these, and rejected
1567 any XML file which included these as invalid.</P
1583 >XML 1.0 Byte Order Marks are now accepted as valid XML.</P
1602 >Fix missing white space problem in processing instruction flow object</TH
1619 >Source Forge Ref #505113, #505124 (Markus Hoenicka)</P
1651 >No white space was emitted between the public-id and the system-id
1652 causing a malformed XML file to be generated.</P
1668 >Fixed OpenJade to output a space between the public-id and the system-id.</P
1687 >Jadetex is now distributed independently</TH
1736 >OpenJade 1.3 shipped with Jadetex 2.7. Jadetex is developed and released
1737 separately from OpenJade.</P
1753 >Removed jadetex files. Jadetex can be obtained from http://jadetex.sourceforge.net</P
1772 >Support for FreeBSD 4.4</TH
1789 >FreeBSD 4.4 openjade port</P
1821 >OpenJade 1.3 would not build on FreeBSD 4.x</P
1837 >The source configuration system has been enhanced to support
1838 FreeBSD out of the box. Note that the POSIX locale feature of OpenJade is not
1839 available under FreeBSD.</P
1858 >Allow non alpha numeric characters in Table of Contents</TH
1875 >Red Hat Bugzilla #31525</P
1907 > Certain non alpha-numeric characters (such as $) do not appear correctly in the table of contents. This problem is confined to the TeX backend.
1924 >Special characters are now correctly escaped in the TeX output file.</P
1943 >Support for latest Win32 build environments</TH
1992 >OpenJade 1.3 does not build with Visual C++ 6.0</P
2008 >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.</P
2027 >Enhancements for Software Packaging</TH
2076 >Numerous patches need to be applied to OpenJade 1.3 to enable packages to be built (RPM)</P
2092 >Enhance Makefiles to ensure that packages are easy to build (including addition of <TT
2095 > environment variable). It should now be possible to build RPM packages and BSD ports without resorting to patches.</P
2114 >Support for newer GNU C++ compilers</TH
2131 >SuSE Linux 7.3 (Andreas Schwab), Red Hat Linux 7.2, Connectiva Linux</P
2163 >C++ is a shifting target. New compilers/standards demand changes.</P
2179 >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</P
2198 >Support for jadetex 3.4 and greater macros for two sided support</TH
2215 >Sourceforge patch #439755,
2216 http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</P
2248 >Two Sided output support with the TeX backend is unreliable in OpenJade 1.3 and Jadetex 2.x.</P
2264 >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 <TT
2269 >two-side-start-on-right</TT
2270 >. This also fixes the "blank page at the end of the document" problem. The following new characteristics are available:
2273 > "UNREGISTERED::OpenJade//Characteristic::page-two-side?"
2275 "UNREGISTERED::OpenJade//Characteristic::two-side-start-on-right?"
2296 >Prevent incorrect generation of ligatures in the TeX Backend</TH
2313 >Red Hat Bugzilla #11497, #11779</P
2345 >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 —).</P
2361 >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.</P
2380 >Improved time string handling</TH
2397 >http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</P
2429 >OpenJade 1.3 does not support the <TT
2448 >Various bugs fixed in the time string support of OpenJade.
2449 It is now possible to compare time, date and datetime.
2450 Also partial formats (such as YY-MM-DD, YYYY-MM or HH:MM) are now supported</P
2469 >Improvements in handling <TT
2489 >http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</P
2521 >sosofo-append has problems with memory/stack usage when
2522 handling large lists of sosofo</P
2538 >The fix optimizes <TT
2541 > to reduce its memory and stack
2542 usage when using it to build long list of sosofo :
2545 > (let loop ( (res (empty-sosofo))
2546 (nl (node-list-rest (children (current-node)))))
2547 (loop (sosofo-append res (process-node-list
2548 (node-list-first nl)))
2549 (node-list-rest nl)))
2570 >Improved Table handling in TeX Backend</TH
2587 >http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</P
2619 >Table handling in the TeX backend has numerous problems.
2636 >Support for tables in the TeX backend has been improved with:</P
2643 >Support for nested tables.</P
2649 >cell-after-column-margin:</TT
2652 >cell-before-column-margin:</TT
2653 > wasn't really working.</P
2657 >Row spanning was broken. This fix only supports
2661 > row alignment though.</P
2665 >Paragraphs in cell spanning multiple column are now
2670 >Support for the <TT
2673 > characteristic.</P
2679 >cell-background?</TT
2682 >background-color</TT
2728 >http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</P
2763 > characteristic in the paragraph flow object does not
2786 > This adds support for the <TT
2793 paragraph's lines: characteristic.
2806 NAME="AEN837">Version 1.3</H2
2811 >Released October 1999. </B
2812 >Version 1.3 added many improvements to increase the scope of the implementation of DSSSL. Changes include:</P
2819 >The SGML backend will now emit linebreaks when used as <TT
2826 > Jade can bind variables to arbitrary values on the command line with the <TT
2837 > module of the SGML property set is supported.
2842 > Style sheet <TT
2846 external procedures ready for easy inclusion
2849 >external-specification</TT
2855 > External procedure with public identifier
2858 > "UNREGISTERED::OpenJade//Procedure::expt"
2861 to provide integral powers of quantities.
2866 > External procedure with public identifier
2869 > "UNREGISTERED::OpenJade//Procedure::sgml-parse"
2872 allows to parse w.r.t. an architecture.
2877 > Jade supports <TT
2880 > for inherited characteristics.
2885 > Jade supports character properties.
2890 > Jade supports <TT
2892 >special-query-expressions</TT
2898 > Jade can bind variables to string values on the command line.
2903 > All standard color spaces supported.
2908 > Jade ignores duplicate keywords in make expressions, as
2914 > External procedure with public identifier
2917 > "UNREGISTERED::OpenJade//Procedure::language"
2920 to create a language object by reference to a POSIX locale.
2925 > Language-dependent procedures of the expression language:
2932 >current-language,</TT
2936 >declare-default-language,</TT
2944 >define-language,</TT
2976 >char-ci<=?,</TT
2980 >char-ci<=?,</TT
3016 >string-ci<?,</TT
3020 >string-ci>?,</TT
3024 >string-ci<=?,</TT
3028 >string-ci>=?.</TT
3034 > The style-sheet.dtd derived from the DSSSL architecture
3035 has been extended (in a backward compatible way) to
3036 include the declaration element type forms supported by
3037 Jade. The public identifier for the dtd is
3040 > "-//OpenJade//DTD DSSSL Style Sheet//EN"
3049 >char-repertoire</TT
3055 >add-separator-chars</TT
3057 declaration element type forms are supported. When given
3061 > command line flag, Jade doesn't use its built in
3062 character repertoire.
3067 > Most of the derived procedures in the query language:
3074 >node-list-reduce</TT
3078 >node-list-contains?</TT
3082 >node-list-remove-duplicates</TT
3086 >node-list-union</TT
3090 >node-list-intersection</TT
3094 >node-list-difference</TT
3098 >node-list-symmetric-difference</TT
3102 >node-list-union-map</TT
3106 >node-list-some?</TT
3110 >node-list-every?</TT
3114 >node-list-filter</TT
3118 >node-list->list</TT
3130 >node-list-sublist</TT
3134 >node-list-count</TT
3142 >node-list-property</TT
3150 >origin-to-subnode-rel</TT
3178 >grove-root-path</TT
3198 >sort-in-tree-order</TT
3210 >property-lookup</TT
3214 >select-by-property</TT
3218 >select-by-null-property</TT
3222 >select-by-missing-property</TT
3253 NAME="AEN962">Version 1.2.2</H2
3258 >Released June 1999. </B
3259 >The first release of OpenJade.</P
3262 >Changes in OpenJade 1.2.2</P
3268 > The HTML and MIF backends are now enabled by default.
3273 > The TeX backend has support for PDF bookmarks. This is
3274 supported by the new version of jadetex which is included.
3279 > Predefined character names <TT
3284 >carriage-return</TT
3286 for the character numbers 10 and 13.
3291 > standard-chars and map-sdata-entity declaration element
3292 type forms are supported.
3297 > Style language additions: map-constructor.
3311 > if any of there arguments
3320 > Most of the DSSSL non-core expression language:
3331 >keyword->string</TT
3335 >string->keyword</TT
3403 >exact->inexact</TT
3407 >inexact->exact</TT
3411 >quantity->number</TT
3415 >string->list</TT
3419 >list->string</TT
3450 NAME="AEN1019">Jade Version 1.2.1</H2
3455 >Released October 1998. </B
3456 >Jade 1.2.1 was the final release of jade from James Clark. OpenJade is based on this code base.</P