Initial commit
[profile/ivi/openjade.git] / docsrc / releasenotes.xml
1 <?xml version='1.0'?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" [
3 ]>
4 <book>
5 <bookinfo>
6         <title>OpenJade 1.3.2</title>
7         <subtitle>Release Notes</subtitle>
8         <corpauthor>OpenJade Project</corpauthor>
9         <edition>Release 1.3.2</edition>
10         <pubdate>December 2002</pubdate>
11         <copyright>
12                 <year>2002</year>
13                 <holder>OpenJade Project</holder>
14         </copyright>
15 </bookinfo>
16
17 <chapter><title>OpenJade 1.3.2 Release Notes</title>
18
19 <para>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.</para>
20 <para>OpenJade is a project undertaken by the DSSSL community to maintain
21 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>
22
23 <sect1><title>Applications of OpenJade</title>
24 <para>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.</para>
25 </sect1>
26
27 <sect1><title>Obtaining OpenJade</title>
28 <para>OpenJade is a project hosted at sourceforge.net and is available
29 from the OpenJade web site at http://openjade.sourceforge.net or directly
30 from the OpenJade project page at http://sourceforge.net/projects/openjade</para>
31 <para>OpenJade is provided in source code form. However as a courtesy
32 to Win32 users where development tools are not always available, a binary release for the Win32 platform is usually available.</para>
33 </sect1>
34 <sect1><title>Supported Platforms</title>
35 <para>OpenJade is intended to be as portable as possible. It should be
36 possible to compile and build on most contemporary UNIX type platforms. In
37 addition OpenJade will also build on Microsoft's Win32 based operating systems.
38 </para>
39 <para>OpenJade is known to compile with both the GNU gcc c++ compiler and
40 Microsoft Visual C++. Other compilers have not been extensively tested.</para>
41 <para>OpenJade has been successfully built with the following GNU compilers: 
42 Red Hat g++ 2.96, GCC g++ 2.95.3, GCC g++ 3.2</para>
43 <para>OpenJade has been built on a number of architectures including Intel i386 and ia64, Alpha AXP, Sparc, PPC and S/390, S/390x.</para>
44 <para>The following table details known successful builds</para>
45 <table id="platforms" frame="topbot"><title>Platforms on which OpenJade 1.3.2 is known to build.</title>
46 <tgroup cols="4" align="left" colsep="0" rowsep="0">
47 <colspec align="left" colname="c1" colwidth="1*" />
48 <colspec colname="c2" colwidth="2*" />
49 <colspec colname="c3" colwidth="2*" />
50 <colspec colname="c4" colwidth="3*" />
51 <thead>
52 <row rowsep="1">
53         <entry>Arch.</entry>
54         <entry>OS</entry>
55         <entry>Compiler</entry>
56         <entry>Notes</entry>
57 </row>
58 </thead>
59 <tbody>
60 <row>
61    <entry align="left">alpha</entry>
62    <entry>Debian 3.0</entry>
63    <entry>GNU gcc 3.2</entry>
64    <entry></entry>
65 </row>
66 <row>
67    <entry align="left">arm</entry>
68    <entry>Debian 3.0</entry>
69    <entry>GNU gcc 3.2</entry>
70    <entry></entry>
71 </row>
72 <row>
73    <entry align="left">hppa</entry>
74    <entry>Debian 3.0</entry>
75    <entry>GNU gcc 3.2</entry>
76    <entry></entry>
77 </row>
78 <row>
79    <entry align="left" morerows="3">i386</entry>
80    <entry>Debian 3.0</entry>
81    <entry>GNU gcc 3.2</entry>
82    <entry></entry>
83 </row>
84 <row>
85    <entry>Red Hat Linux 7.3</entry>
86    <entry>Red Hat gcc 2.96</entry>
87    <entry></entry>
88 </row>
89 <row>
90    <entry>Red Hat Linux 7.3</entry>
91    <entry>GNU gcc 3.2</entry>
92    <entry></entry>
93 </row>
94 <row>
95    <entry>SuSE Linux 8.1</entry>
96    <entry>GNU gcc 3.2</entry>
97    <entry></entry>
98 </row>
99 <row>
100    <entry align="left">ia64</entry>
101    <entry>Debian 3.0</entry>
102    <entry>GNU gcc 3.2</entry>
103    <entry></entry>
104 </row>
105 <row>
106    <entry align="left">m68k</entry>
107    <entry>Debian 3.0</entry>
108    <entry>GNU gcc 3.2</entry>
109    <entry></entry>
110 </row>
111 <row>
112    <entry align="left">mips, mipsel</entry>
113    <entry>Debian 3.0</entry>
114    <entry>GNU gcc 3.2</entry>
115    <entry></entry>
116 </row>
117 <row>
118    <entry align="left">powerpc</entry>
119    <entry>Debian 3.0</entry>
120    <entry>GNU gcc 3.2</entry>
121    <entry></entry>
122 </row>
123 <row>
124    <entry align="left">s390</entry>
125    <entry>Debian 3.0</entry>
126    <entry>GNU gcc 3.2</entry>
127    <entry></entry>
128 </row>
129 <row>
130    <entry align="left">sparc</entry>
131    <entry>Debian 3.0</entry>
132    <entry>GNU gcc 3.2</entry>
133    <entry></entry>
134 </row>
135 </tbody>
136 </tgroup>
137 </table>
138 <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>
139 </sect1>
140 <sect1><title>Building OpenJade from Source</title>
141 <para>OpenJade requires 40Mb to 50Mb of disk space to build. An installation
142 will require around 15Mb to 20Mb depending on architecture.</para>
143 <para>OpenJade makes use of the GNU software configuration tools (autoconf, libtool, automake etc).
144 The GNU C++ compiler and make utility should also be used.
145 The steps required to build the OpenJade tools (<command>onsgmls</command>, <command>openjade</command>, <command>osgmlnorm</command>, <command>ospam</command>, <command>ospent</command>, <command>osx</command>) and libraries are as follows:
146 <screen>gzip -d openjade-1.3.2.tar.gz | tar xvf -
147 cd openjade-1.3.2
148 ./configure <optional><option><replaceable>options&hellip;</replaceable></option></optional>
149 make
150 </screen>
151 You may need to switch to the super user <command>root</command> to complete the installation
152 <screen>
153 make install
154 </screen>
155 If you wish to install man pages for the various commands you should then do
156 <screen>
157 make install-man</screen>
158 The <command>configure</command> script supports many options. These can be displayed using the command
159 <screen>
160 ./configure --help
161 </screen>
162 In addition to the standard options, the following table describes options specific to openjade.</para>
163 <table id="configure" frame="topbot"><title>OpenJade specific configure options</title>
164 <tgroup cols="3" align="left" colsep="0" rowsep="0">
165 <colspec colname="c1" colwidth="1*" />
166 <colspec colname="c2" colwidth="1*" />
167 <colspec colname="c3" colwidth="2*" />
168 <thead>
169 <row rowsep="1">
170         <entry>Option</entry>
171         <entry>Default</entry>
172         <entry>Explanation</entry>
173 </row>
174 </thead>
175 <tbody>
176 <row>
177   <entry><option>--enable-spincludedir=path</option></entry>
178   <entry>/usr/include/OpenSP</entry>
179   <entry>Define the path where the OpenSP include files may be found.</entry>
180 </row>
181 <row>
182   <entry><option>--enable-splibdir=path</option></entry>
183   <entry>/usr/lib</entry>
184   <entry>Define the path where the OpenSP library (libosp) may be found.</entry>
185 </row>
186 <row>
187   <entry><option>--disable-mif</option></entry>
188   <entry>MIF support is enabled</entry>
189   <entry>disable support for FrameMaker MIF output (the <option>-t mif</option> option) to <command>openjade</command>.</entry>
190 </row>
191 <row>
192   <entry><option>--disable-html</option></entry>
193   <entry>html support enabled</entry>
194   <entry>disable support for HTML+CSS output (the <option>-t html</option> to <command>openjade</command>).</entry>
195 </row>
196 <row>
197   <entry><option>--enable-default-catalog=<replaceable>pathlist</replaceable></option></entry>
198   <entry>Not enabled</entry>
199   <entry>Provide one or more default catalog files or sysids, e.g. /usr/local/lib/sgml/catalog</entry>
200 </row>
201 <row>
202   <entry><option>--enable-default-search-path=<replaceable>pathlist</replaceable></option></entry>
203   <entry>Not enabled</entry>
204   <entry>Provide a default value for <varname>SGML_SEARCH_PATH</varname></entry>
205 </row>
206 </tbody>
207 </tgroup>
208 </table>
209 <para>Please refer to the system documentation for details on building on the Win32 platform.</para>
210 </sect1>
211 <sect1><title>Binary Distributions</title>
212 <para>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.</para>
213 </sect1>
214 <sect1><title>Installation</title>
215 <para>In addition to the OpenJade executables and libraries you will also need various DTDs and stylesheets.
216 Some DTDs and associated files (entity definitions) are available in the <filename>pubtext</filename> directory of the distribution.
217 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>
218 <para>OpenJade supports the standard SGML catalog facility; it is
219 recommended that you set up and use such a catalog system.
220 Generally speaking
221 you will create your own DSSSL stylesheets for use with OpenJade, however, users
222 of the OASIS DocBook DTD should be aware that extensive, and modular, stylesheets are available from the DocBook project at http://docbook.sourceforge.net.</para>
223 <para>If you wish to make use of the TeX backend you will require an up to
224 date distribution of laTeX such as teTeX, TeXlive or fpTeX. In addition you
225 will also require the jadetex package, available from http://jadetex.sourceforge.net.</para>
226 </sect1>
227 <sect1><title>Support</title>
228 <para>If, after reading the documentation, you still have a problem, then you
229 may require some additional help.
230 The OpenJade project is a volunteer effort and as such does not provide any formal support.
231 Instead, you should look to the community for support.
232 Once part of the community, you, in turn, will be able to play your part in
233 helping those that come after you. Here are some pointers to obtaining help:</para>
234
235 <itemizedlist>
236 <listitem>
237 <para>If you obtained your OpenJade tools in binary form from your operating system distributor and you have a build related problem -
238 such as openjade crashing, then your first port of call should be your distributor.</para>
239 </listitem>
240
241 <listitem>
242 <para>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.</para>
243 </listitem>
244
245 <listitem>
246 <para>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.
247 See http://www.oasis-open.org/docbook/mailinglist/ for details.</para>
248 </listitem>
249
250 <listitem>
251 <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>
252 </listitem>
253
254 </itemizedlist>
255
256 <para>Please choose only one mailing list to post to, as cross-posting is generally frowned upon.
257 The various mailing lists are archived and searchable.
258 It is always worth searching for your problem first, as it is often the case that someone has had the same problem before.</para>
259
260 </sect1>
261 <sect1><title>Version 1.3.2</title>
262 <formalpara><title>Released December 2002.</title>
263 <para>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</para>
264 </formalpara>
265 <table id="openjade132fixes" frame="topbot"><title>Changes for release 1.3.2</title>
266 <tgroup cols="2" align="left" colsep="0" rowsep="0">
267 <colspec colname="c1" colwidth="1*" />
268 <colspec colname="c2" colwidth="3*" />
269 <thead>
270 <row rowsep="1">
271         <entry>Item 1</entry>
272         <entry>MIF Backend Fixes</entry>
273 </row>
274 </thead>
275 <tbody>
276 <row>
277         <entry><para>References</para></entry>
278         <entry><para>G. Seshadri et al.</para></entry>
279 </row>
280 <row>
281         <entry><para>Category</para></entry>
282         <entry><para>Software Bug</para></entry>
283 </row>
284 <row>
285 <entry><para>Problem</para></entry>
286 <entry><para>Issues with page size and page header/footers</para></entry>
287 </row>
288 <row>
289 <entry><para>Resolution</para></entry>
290 <entry><para>Fix to make sure that right header is shown in documents and
291 that document page size is initialised correctly.</para></entry>
292 </row>
293 </tbody>
294 </tgroup>
295 <tgroup cols="2" align="left" colsep="0" rowsep="0">
296 <colspec colname="c1" colwidth="1*" />
297 <colspec colname="c2" colwidth="3*" />
298 <thead>
299 <row rowsep="1">
300         <entry>Item 2</entry>
301         <entry>Support for building OpenSP 1.5</entry>
302 </row>
303 </thead>
304 <tbody>
305 <row>
306         <entry><para>References</para></entry>
307         <entry><para>Ian Castle, Karl Eichwalder</para></entry>
308 </row>
309 <row>
310         <entry><para>Category</para></entry>
311         <entry><para>Software Bug</para></entry>
312 </row>
313 <row>
314 <entry><para>Problem</para></entry>
315 <entry><para>OpenSP is now at version 1.5 which has many improvements
316 over 1.3.4</para></entry>
317 </row>
318 <row>
319 <entry><para>Resolution</para></entry>
320 <entry><para>It is desirable to use OpenSP 1.5 which has many improvements
321 over version 1.3.4 which shipped with openjade 1.3.1. However, it is
322 awkward having to have two versions of OpenSP at the same time. OpenJade
323 1.4 is not ready for release yet, so version 1.3.2 will link against
324 OpenSP 1.5 and later - and no longer includes the old version 1.3.4 of OpenSP.  </para></entry>
325 </row>
326 </tbody>
327 </tgroup>
328 <tgroup cols="2" align="left" colsep="0" rowsep="0">
329 <colspec colname="c1" colwidth="1*" />
330 <colspec colname="c2" colwidth="3*" />
331 <thead>
332 <row rowsep="1">
333         <entry>Item 3</entry>
334         <entry>Correct definition of "attribute" in builtin.dsl</entry>
335 </row>
336 </thead>
337 <tbody>
338 <row>
339         <entry><para>References</para></entry>
340         <entry><para>Toby Speight, Debian Bug #145242</para></entry>
341 </row>
342 <row>
343         <entry><para>Category</para></entry>
344         <entry><para>Software Bug</para></entry>
345 </row>
346 <row>
347 <entry><para>Problem</para></entry>
348 <entry><para>The definition of "attribute" (ISO/IEC 10179:1996, section 10.2.5) for SGML property operations was not correct.</para></entry>
349 </row>
350 <row>
351 <entry><para>Resolution</para></entry>
352 <entry><para>The definition has been corrected in accordance
353 with the standard.</para></entry>
354 </row>
355 </tbody>
356 </tgroup>
357 <tgroup cols="2" align="left" colsep="0" rowsep="0">
358 <colspec colname="c1" colwidth="1*" />
359 <colspec colname="c2" colwidth="3*" />
360 <thead>
361 <row rowsep="1">
362         <entry>Item 4</entry>
363         <entry>XML backend doesn't quote "&" in attribute values</entry>
364 </row>
365 </thead>
366 <tbody>
367 <row>
368         <entry><para>References</para></entry>
369         <entry><para>Toby Speight, Debian Bug #147073</para></entry>
370 </row>
371 <row>
372         <entry><para>Category</para></entry>
373         <entry><para>Software Bug</para></entry>
374 </row>
375 <row>
376 <entry><para>Problem</para></entry>
377 <entry><para>When using OpenJade with the XML or SGML backend to output
378 attribute values containing the '&amp;' character, the output is not
379 well-formed.</para></entry>
380 </row>
381 <row>
382 <entry><para>Resolution</para></entry>
383 <entry><para>Fixed the Transform FOT Builder so that for XML output the
384 '&amp;' character is properly quoted.</para></entry>
385 </row>
386 </tbody>
387 </tgroup>
388 </table>
389 </sect1>
390 <sect1><title>Version 1.3.1</title>
391 <formalpara><title>Released January 2002.</title>
392 <para>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).</para>
393 </formalpara>
394 <para>The following table details the major improvements in Openjade 1.3.1</para>
395
396 <table id="openjade131fixes" frame="topbot"><title>Changes for release 1.3.1</title>
397 <tgroup cols="2" align="left" colsep="0" rowsep="0">
398 <colspec colname="c1" colwidth="1*" />
399 <colspec colname="c2" colwidth="3*" />
400 <thead>
401 <row rowsep="1">
402         <entry>Item 1</entry>
403         <entry>Support for MacOS X/ Darwin</entry>
404 </row>
405 </thead>
406 <tbody>
407 <row>
408         <entry><para>References</para></entry>
409         <entry><para>Fink Project; Kogul&eacute;, Ryo</para></entry>
410 </row>
411 <row>
412         <entry><para>Category</para></entry>
413         <entry><para>Software Bug</para></entry>
414 </row>
415 <row>
416 <entry><para>Problem</para></entry>
417 <entry><para>OpenJade 1.3 does not build and run on the Mac OS X/Darwin platform</para></entry>
418 </row>
419 <row>
420 <entry><para>Resolution</para></entry>
421 <entry><para>OpenJade 1.3.1 has been enhanced to support Mac OS X/Darwin 1.4. The
422 autoconf configuration system has been upgraded and also includes specific
423 platform support. Some minor code alterations to improve code portability (C++
424 style changes). Note that the POSIX locale feature is not available on this platform.</para></entry>
425 </row>
426 </tbody>
427 </tgroup>
428 <tgroup cols="2" align="left" colsep="0" rowsep="0">
429 <colspec colname="c1" colwidth="1*" />
430 <colspec colname="c2" colwidth="3*" />
431 <thead>
432 <row rowsep="1">
433         <entry>Item 2</entry>
434         <entry>UNIX on-line manual pages</entry>
435 </row>
436 </thead>
437 <tbody>
438 <row>
439         <entry><para>References</para></entry>
440         <entry><para>None</para></entry>
441 </row>
442 <row>
443         <entry><para>Category</para></entry>
444         <entry><para>Documentation Bug</para></entry>
445 </row>
446 <row>
447 <entry><para>Problem</para></entry>
448 <entry><para>No on-line manual (man) pages available on UNIX platforms</para></entry>
449 </row>
450 <row>
451 <entry><para>Resolution</para></entry>
452 <entry><para>OpenJade 1.3.1 now has a man page for every command. Additionally, if
453 OpenJade is used as a replacement for Jade, then compatibility man pages are included (i.e.
454 man jade is synonymous with man openjade).</para></entry>
455 </row>
456 </tbody>
457 </tgroup>
458 <tgroup cols="2" align="left" colsep="0" rowsep="0">
459 <colspec colname="c1" colwidth="1*" />
460 <colspec colname="c2" colwidth="3*" />
461 <thead>
462 <row rowsep="1">
463         <entry>Item 3</entry>
464         <entry>Upgrade GNU source configuration tools</entry>
465 </row>
466 </thead>
467 <tbody>
468 <row>
469         <entry><para>References</para></entry>
470         <entry><para>Various sourceforge problem reports, SuSE Linux 7.3, Red Hat 7.2, Red Hat Bugzilla #46212</para></entry>
471 </row>
472 <row>
473         <entry><para>Category</para></entry>
474         <entry><para>Software Bug</para></entry>
475 </row>
476 <row>
477 <entry><para>Problem</para></entry>
478 <entry><para>The source configuration system is based on old versions of libtool and autoconf.
479 In addition, there are problems with the generated Makefile files such that installation
480 directories are not created.</para></entry>
481 </row>
482 <row>
483 <entry><para>Resolution</para></entry>
484 <entry><para>Upgraded to autoconf 2.52 and libtool 1.4. Upgraded the various support files.
485 Included elements of automake support. Made the Makefiles more robust. These changes
486 should facilitate porting to new/updated environments (i.e. those supported by
487 newer versions of autoconf). Work has been done to enhance some of the custom autoconf tests to
488 improve reliability.</para></entry>
489 </row>
490 </tbody>
491 </tgroup>
492 <tgroup cols="2" align="left" colsep="0" rowsep="0">
493 <colspec colname="c1" colwidth="1*" />
494 <colspec colname="c2" colwidth="3*" />
495 <thead>
496 <row rowsep="1">
497         <entry>Item 4</entry>
498         <entry>Support for XML Byte Order Marks (BOM)</entry>
499 </row>
500 </thead>
501 <tbody>
502 <row>
503         <entry><para>References</para></entry>
504         <entry><para>Source Forge bug #442560 (Terje Bless/Liam Quinn)</para></entry>
505 </row>
506 <row>
507         <entry><para>Category</para></entry>
508         <entry><para>Software Bug</para></entry>
509 </row>
510 <row>
511 <entry><para>Problem</para></entry>
512 <entry><para>Since OpenJade 1.3 was released, a second edition of the XML 1.0 specification
513 has been released (REC-xml-20001006). This specification introduced the concept
514 of Byte Order Marks to increase the sophistication of the detection of
515 the character encoding system. OpenJade 1.3 would not recognize these, and rejected
516 any XML file which included these as invalid.</para></entry>
517 </row>
518 <row>
519 <entry><para>Resolution</para></entry>
520 <entry><para>XML 1.0 Byte Order Marks are now accepted as valid XML.</para></entry>
521 </row>
522 </tbody>
523 </tgroup>
524 <tgroup cols="2" align="left" colsep="0" rowsep="0">
525 <colspec colname="c1" colwidth="1*" />
526 <colspec colname="c2" colwidth="3*" />
527 <thead>
528 <row rowsep="1">
529         <entry>Item 5</entry>
530         <entry>Fix missing white space problem in processing instruction flow object</entry>
531 </row>
532 </thead>
533 <tbody>
534 <row>
535         <entry><para>References</para></entry>
536         <entry><para>Source Forge Ref #505113, #505124 (Markus Hoenicka)</para></entry>
537 </row>
538 <row>
539         <entry><para>Category</para></entry>
540         <entry><para>Software Bug</para></entry>
541 </row>
542 <row>
543 <entry><para>Problem</para></entry>
544 <entry><para>No white space was emitted between the public-id and the system-id
545         causing a malformed XML file to be generated.</para></entry>
546         
547 </row>
548 <row>
549 <entry><para>Resolution</para></entry>
550 <entry><para>Fixed OpenJade to output a space between the public-id and the system-id.</para></entry>
551 </row>
552 </tbody>
553 </tgroup>
554 <tgroup cols="2" align="left" colsep="0" rowsep="0">
555 <colspec colname="c1" colwidth="1*" />
556 <colspec colname="c2" colwidth="3*" />
557 <thead>
558 <row rowsep="1">
559         <entry>Item 6</entry>
560         <entry>Jadetex is now distributed independently</entry>
561 </row>
562 </thead>
563 <tbody>
564 <row>
565         <entry><para>References</para></entry>
566         <entry><para>None</para></entry>
567 </row>
568 <row>
569         <entry><para>Category</para></entry>
570         <entry><para>Software Bug</para></entry>
571 </row>
572 <row>
573 <entry><para>Problem</para></entry>
574 <entry><para>OpenJade 1.3 shipped with Jadetex 2.7. Jadetex is developed and released
575 separately from OpenJade.</para></entry>
576 </row>
577 <row>
578 <entry><para>Resolution</para></entry>
579 <entry><para>Removed jadetex files. Jadetex can be obtained from http://jadetex.sourceforge.net</para></entry>
580 </row>
581 </tbody>
582 </tgroup>
583 <tgroup cols="2" align="left" colsep="0" rowsep="0">
584 <colspec colname="c1" colwidth="1*" />
585 <colspec colname="c2" colwidth="3*" />
586 <thead>
587 <row rowsep="1">
588         <entry>Item 7</entry>
589         <entry>Support for FreeBSD 4.4</entry>
590 </row>
591 </thead>
592 <tbody>
593 <row>
594         <entry><para>References</para></entry>
595         <entry><para>FreeBSD 4.4 openjade port</para></entry>
596 </row>
597 <row>
598         <entry><para>Category</para></entry>
599         <entry><para>Software Bug</para></entry>
600 </row>
601 <row>
602 <entry><para>Problem</para></entry>
603 <entry><para>OpenJade 1.3 would not build on FreeBSD 4.x</para></entry>
604 </row>
605 <row>
606 <entry><para>Resolution</para></entry>
607 <entry><para>The source configuration system has been enhanced to support
608 FreeBSD out of the box. Note that the POSIX locale feature of OpenJade is not
609 available under FreeBSD.</para></entry>
610 </row>
611 </tbody>
612 </tgroup>
613 <tgroup cols="2" align="left" colsep="0" rowsep="0">
614 <colspec colname="c1" colwidth="1*" />
615 <colspec colname="c2" colwidth="3*" />
616 <thead>
617 <row rowsep="1">
618         <entry>Item 8</entry>
619         <entry>Allow non alpha numeric characters in Table of Contents</entry>
620 </row>
621 </thead>
622 <tbody>
623 <row>
624         <entry><para>References</para></entry>
625         <entry><para>Red Hat Bugzilla #31525</para></entry>
626 </row>
627 <row>
628         <entry><para>Category</para></entry>
629         <entry><para>Software Bug</para></entry>
630 </row>
631 <row>
632 <entry><para>Problem</para></entry>
633 <entry><para>
634 Certain non alpha-numeric characters (such as $) do not appear correctly in the table of contents. This problem is confined to the TeX backend.
635 </para></entry>
636 </row>
637 <row>
638 <entry><para>Resolution</para></entry>
639 <entry><para>Special characters are now correctly escaped in the TeX output file.</para></entry>
640 </row>
641 </tbody>
642 </tgroup>
643 <tgroup cols="2" align="left" colsep="0" rowsep="0">
644 <colspec colname="c1" colwidth="1*" />
645 <colspec colname="c2" colwidth="3*" />
646 <thead>
647 <row rowsep="1">
648         <entry>Item 9</entry>
649         <entry>Support for latest Win32 build environments</entry>
650 </row>
651 </thead>
652 <tbody>
653 <row>
654         <entry><para>References</para></entry>
655         <entry><para>None</para></entry>
656 </row>
657 <row>
658         <entry><para>Category</para></entry>
659         <entry><para>Software Bug</para></entry>
660 </row>
661 <row>
662 <entry><para>Problem</para></entry>
663 <entry><para>OpenJade 1.3 does not build with Visual C++ 6.0</para></entry>
664 </row>
665 <row>
666 <entry><para>Resolution</para></entry>
667 <entry><para>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.</para></entry>
668 </row>
669 </tbody>
670 </tgroup>
671 <tgroup cols="2" align="left" colsep="0" rowsep="0">
672 <colspec colname="c1" colwidth="1*" />
673 <colspec colname="c2" colwidth="3*" />
674 <thead>
675 <row rowsep="1">
676         <entry>Item 10</entry>
677         <entry>Enhancements for Software Packaging</entry>
678 </row>
679 </thead>
680 <tbody>
681 <row>
682         <entry><para>References</para></entry>
683         <entry><para>SuSE Linux 7.3</para></entry>
684 </row>
685 <row>
686         <entry><para>Category</para></entry>
687         <entry><para>Software Bug</para></entry>
688 </row>
689 <row>
690 <entry><para>Problem</para></entry>
691 <entry><para>Numerous patches need to be applied to OpenJade 1.3 to enable packages to be built (RPM)</para></entry>
692 </row>
693 <row>
694 <entry><para>Resolution</para></entry>
695 <entry><para>Enhance Makefiles to ensure that packages are easy to build (including addition of <varname>DESTDIR</varname> environment variable). It should now be possible to build RPM packages and BSD ports without resorting to patches.</para></entry>
696 </row>
697 </tbody>
698 </tgroup>
699 <tgroup cols="2" align="left" colsep="0" rowsep="0">
700 <colspec colname="c1" colwidth="1*" />
701 <colspec colname="c2" colwidth="3*" />
702 <thead>
703 <row rowsep="1">
704         <entry>Item 11</entry>
705         <entry>Support for newer GNU C++ compilers</entry>
706 </row>
707 </thead>
708 <tbody>
709 <row>
710         <entry><para>References</para></entry>
711         <entry><para>SuSE Linux 7.3 (Andreas Schwab), Red Hat Linux 7.2, Connectiva Linux</para></entry>
712 </row>
713 <row>
714         <entry><para>Category</para></entry>
715         <entry><para>Software Bug</para></entry>
716 </row>
717 <row>
718 <entry><para>Problem</para></entry>
719 <entry><para>C++ is a shifting target. New compilers/standards demand changes.</para></entry>
720 </row>
721 <row>
722 <entry><para>Resolution</para></entry>
723 <entry><para>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</para></entry>
724 </row>
725 </tbody>
726 </tgroup>
727 <tgroup cols="2" align="left" colsep="0" rowsep="0">
728 <colspec colname="c1" colwidth="1*" />
729 <colspec colname="c2" colwidth="3*" />
730 <thead>
731 <row rowsep="1">
732         <entry>Item 12</entry>
733         <entry>Support for jadetex 3.4 and greater macros for two sided support</entry>
734 </row>
735 </thead>
736 <tbody>
737 <row>
738         <entry><para>References</para></entry>
739         <entry><para>Sourceforge patch #439755,
740         http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</para></entry>
741 </row>
742 <row>
743         <entry><para>Category</para></entry>
744         <entry><para>Software Bug</para></entry>
745 </row>
746 <row>
747 <entry><para>Problem</para></entry>
748 <entry><para>Two Sided output support with the TeX backend is unreliable in OpenJade 1.3 and Jadetex 2.x.</para></entry>
749 </row>
750 <row>
751 <entry><para>Resolution</para></entry>
752 <entry><para>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 <function>two-side</function> and <function>two-side-start-on-right</function>. This also fixes the "blank page at the end of the document" problem. The following new characteristics are available:
753 <screen>
754   "UNREGISTERED::OpenJade//Characteristic::page-two-side?"
755
756   "UNREGISTERED::OpenJade//Characteristic::two-side-start-on-right?"
757 </screen></para></entry>
758 </row>
759 </tbody>
760 </tgroup>
761 <tgroup cols="2" align="left" colsep="0" rowsep="0">
762 <colspec colname="c1" colwidth="1*" />
763 <colspec colname="c2" colwidth="3*" />
764 <thead>
765 <row rowsep="1">
766         <entry>Item 13</entry>
767         <entry>Prevent incorrect generation of ligatures in the TeX Backend</entry>
768 </row>
769 </thead>
770 <tbody>
771 <row>
772         <entry><para>References</para></entry>
773         <entry><para>Red Hat Bugzilla #11497, #11779</para></entry>
774 </row>
775 <row>
776         <entry><para>Category</para></entry>
777         <entry><para>Software Bug</para></entry>
778 </row>
779 <row>
780 <entry><para>Problem</para></entry>
781 <entry><para>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 &mdash;).</para></entry>
782 </row>
783 <row>
784 <entry><para>Resolution</para></entry>
785 <entry><para>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.</para></entry>
786 </row>
787 </tbody>
788 </tgroup>
789 <tgroup cols="2" align="left" colsep="0" rowsep="0">
790 <colspec colname="c1" colwidth="1*" />
791 <colspec colname="c2" colwidth="3*" />
792 <thead>
793 <row rowsep="1">
794         <entry>Item 14</entry>
795         <entry>Improved time string handling</entry>
796 </row>
797 </thead>
798 <tbody>
799 <row>
800         <entry><para>References</para></entry>
801         <entry><para>http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</para></entry>
802 </row>
803 <row>
804         <entry><para>Category</para></entry>
805         <entry><para>Software Bug</para></entry>
806 </row>
807 <row>
808 <entry><para>Problem</para></entry>
809 <entry><para>OpenJade 1.3 does not support the <function>(time<=?)</function> comparison</para></entry>
810 </row>
811 <row>
812 <entry><para>Resolution</para></entry>
813 <entry><para>Various bugs fixed in the time string support of OpenJade.
814 It is now possible to compare time, date and datetime.
815 Also partial formats (such as YY-MM-DD, YYYY-MM or HH:MM) are now supported</para></entry>
816 </row>
817 </tbody>
818 </tgroup>
819 <tgroup cols="2" align="left" colsep="0" rowsep="0">
820 <colspec colname="c1" colwidth="1*" />
821 <colspec colname="c2" colwidth="3*" />
822 <thead>
823 <row rowsep="1">
824         <entry>Item 15</entry>
825         <entry>Improvements in handling <function>sosofo-append</function></entry>
826 </row>
827 </thead>
828 <tbody>
829 <row>
830         <entry><para>References</para></entry>
831         <entry><para>http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</para></entry>
832 </row>
833 <row>
834         <entry><para>Category</para></entry>
835         <entry><para>Software Bug</para></entry>
836 </row>
837 <row>
838 <entry><para>Problem</para></entry>
839 <entry><para>sosofo-append has problems with memory/stack usage when
840 handling large lists of sosofo</para></entry>
841 </row>
842 <row>
843 <entry><para>Resolution</para></entry>
844 <entry><para>The fix optimizes <function>sosofo-append</function> to reduce its memory and stack
845         usage when using it to build long list of sosofo :
846 <screen>
847     (let loop ( (res (empty-sosofo))
848         (nl  (node-list-rest (children (current-node)))))
849             (loop (sosofo-append res (process-node-list
850         (node-list-first nl)))
851             (node-list-rest nl)))
852 </screen></para></entry>
853 </row>
854 </tbody>
855 </tgroup>
856 <tgroup cols="2" align="left" colsep="0" rowsep="0">
857 <colspec colname="c1" colwidth="1*" />
858 <colspec colname="c2" colwidth="3*" />
859 <thead>
860 <row rowsep="1">
861         <entry>Item 16</entry>
862         <entry>Improved Table handling in TeX Backend</entry>
863 </row>
864 </thead>
865 <tbody>
866 <row>
867         <entry><para>References</para></entry>
868         <entry><para>http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</para></entry>
869 </row>
870 <row>
871         <entry><para>Category</para></entry>
872         <entry><para>Software Bug</para></entry>
873 </row>
874 <row>
875 <entry><para>Problem</para></entry>
876 <entry><para>Table handling in the TeX backend has numerous problems.
877 </para></entry>
878 </row>
879 <row>
880 <entry><para>Resolution</para></entry>
881 <entry><para>Support for tables in the TeX backend has been improved with:</para>
882 <itemizedlist>
883   <listitem>
884              <para>Support for nested tables.</para>
885   </listitem>
886   <listitem>
887              <para><function>cell-after-column-margin:</function> and <function>cell-before-column-margin:</function> wasn't really working.</para>
888   </listitem>
889   <listitem>
890              <para>Row spanning was broken. This fix only supports
891                 <function>'start</function> row alignment though.</para>
892   </listitem>
893   <listitem>
894              <para>Paragraphs in cell spanning multiple column are now
895         working.</para>
896   </listitem>
897   <listitem>
898              <para>Support for the <function>row-alignment:</function> characteristic.</para>
899    </listitem>
900    <listitem>
901              <para>Support for <function>cell-background?</function> and <function>background-color</function> properties</para>
902   </listitem>
903   </itemizedlist>
904 </entry>
905 </row>
906 </tbody>
907 </tgroup>
908 <tgroup cols="2" align="left" colsep="0" rowsep="0">
909 <colspec colname="c1" colwidth="1*" />
910 <colspec colname="c2" colwidth="3*" />
911 <thead>
912 <row rowsep="1">
913         <entry>Item 17</entry>
914         <entry>Support for <function>'asis</function> and <function>'asis-wrap</function></entry>
915 </row>
916 </thead>
917 <tbody>
918 <row>
919         <entry><para>References</para></entry>
920         <entry><para>http://iNdev.iNsu.COM/openjade/ (Francis J. Lacoste)</para></entry>
921 </row>
922 <row>
923         <entry><para>Category</para></entry>
924         <entry><para>Software Bug</para></entry>
925 </row>
926 <row>
927 <entry><para>Problem</para></entry>
928 <entry><para>The <function>lines:</function> characteristic in the paragraph flow object does not
929 support the <function>'asis</function> and <function>'asis-wrap</function> values.</para></entry>
930 </row>
931 <row>
932 <entry><para>Resolution</para></entry>
933 <entry><para>
934           This adds support for the <function>'asis</function> and <function>'asis-wrap</function> values for the
935           paragraph's lines: characteristic.
936 </para></entry>
937 </row>
938 </tbody>
939 </tgroup>
940 </table>
941 </sect1>
942 <sect1>
943   <title>Version 1.3</title>
944   <formalpara><title>Released October 1999</title>
945 <para>Version 1.3 added many improvements to increase the scope of the implementation of DSSSL. Changes include:</para></formalpara>
946
947 <itemizedlist>
948   <listitem>
949     <para>The SGML backend will now emit linebreaks when used as <option>-t sgml-raw</option>.</para>
950   </listitem>
951
952   <listitem>
953     <para>
954 Jade can bind variables to arbitrary values on the command line with the <option>-V</option> option. 
955     </para>
956   </listitem>
957
958   <listitem>
959     <para>
960 The <function>prlabs1</function> module of the SGML property set is supported.
961     </para>
962   </listitem>
963
964   <listitem>
965     <para>
966 Style sheet <filename>extensions.dsl</filename> lists all known
967   external procedures ready for easy inclusion
968   as an <function>external-specification</function>.
969     </para>
970   </listitem>
971
972   <listitem>
973     <para>
974 External procedure with public identifier
975 <screen>
976   "UNREGISTERED::OpenJade//Procedure::expt"
977 </screen>
978   to provide integral powers of quantities.
979     </para>
980   </listitem>
981
982   <listitem>
983     <para>
984 External procedure with public identifier
985 <screen>
986   "UNREGISTERED::OpenJade//Procedure::sgml-parse"
987 </screen>
988   allows to parse w.r.t. an architecture.
989     </para>
990   </listitem>
991
992   <listitem>
993     <para>
994 Jade supports <function>force!</function> for inherited characteristics.
995     </para>
996   </listitem>
997
998   <listitem>
999     <para>
1000 Jade supports character properties.
1001     </para>
1002   </listitem>
1003
1004   <listitem>
1005     <para>
1006 Jade supports <function>special-query-expressions</function>.
1007     </para>
1008   </listitem>
1009
1010   <listitem>
1011     <para>
1012 Jade can bind variables to string values on the command line.
1013     </para>
1014   </listitem>
1015
1016   <listitem>
1017     <para>
1018 All standard color spaces supported. 
1019     </para>
1020   </listitem>
1021
1022   <listitem>
1023     <para>
1024 Jade ignores duplicate keywords in make expressions, as 
1025   mandated by DSSSL.
1026     </para>
1027   </listitem>
1028
1029   <listitem>
1030     <para>
1031 External procedure with public identifier
1032 <screen>
1033   "UNREGISTERED::OpenJade//Procedure::language"
1034 </screen>
1035   to create a language object by reference to a POSIX locale.
1036     </para>
1037   </listitem>
1038
1039   <listitem>
1040     <para>
1041 Language-dependent procedures of the expression language:
1042 <function>language?,</function>
1043 <function>current-language,</function>
1044 <function>declare-default-language,</function>
1045 <function>with-language,</function>
1046 <function>define-language,</function>
1047 <function>char&lt;?,</function>
1048 <function>char>?,</function>
1049 <function>char&lt;=?,</function>
1050 <function>char>=?,</function>
1051 <function>char-ci=?,</function>
1052 <function>char-ci&lt;?,</function>
1053 <function>char-ci>?,</function>
1054 <function>char-ci&lt;=?,</function>
1055 <function>char-ci&lt;=?,</function>
1056 <function>char-upcase,</function>
1057 <function>char-downcase,</function>
1058 <function>string-ci=?,</function>
1059 <function>string-equiv?,</function>
1060 <function>string&lt;?,</function>
1061 <function>string>?,</function>
1062 <function>string&lt;=?,</function>
1063 <function>string>=?,</function>
1064 <function>string-ci&lt;?,</function>
1065 <function>string-ci>?,</function>
1066 <function>string-ci&lt;=?,</function>
1067 <function>string-ci>=?.</function>
1068     </para>
1069   </listitem>
1070
1071   <listitem>
1072     <para>
1073 The style-sheet.dtd derived from the DSSSL architecture
1074   has been extended (in a backward compatible way) to
1075   include the declaration element type forms supported by
1076   Jade. The public identifier for the dtd is 
1077 <screen>
1078   "-//OpenJade//DTD DSSSL Style Sheet//EN" 
1079 </screen>
1080     </para>
1081   </listitem>
1082   
1083   <listitem>
1084     <para>
1085 <function>char-repertoire</function>, <function>add-name-chars</function> and <function>add-separator-chars</function>
1086   declaration element type forms are supported. When given
1087   the <option>-s</option> command line flag, Jade doesn't use its built in 
1088   character repertoire.
1089     </para>
1090   </listitem>
1091
1092   <listitem>
1093     <para>
1094 Most of the derived procedures in the query language:
1095 <function>current-root</function>,
1096 <function>node-list-reduce</function>,
1097 <function>node-list-contains?</function>,
1098 <function>node-list-remove-duplicates</function>,
1099 <function>node-list-union</function>, 
1100 <function>node-list-intersection</function>,
1101 <function>node-list-difference</function>, 
1102 <function>node-list-symmetric-difference</function>,
1103 <function>node-list-union-map</function>,
1104 <function>node-list-some?</function>,
1105 <function>node-list-every?</function>,
1106 <function>node-list-filter</function>,
1107 <function>node-list->list</function>,
1108 <function>node-list-tail</function>,
1109 <function>node-list-head</function>,
1110 <function>node-list-sublist</function>,
1111 <function>node-list-count</function>,
1112 <function>node-list-last</function>,
1113 <function>node-list-property</function>,
1114 <function>origin</function>,
1115 <function>origin-to-subnode-rel</function>,
1116 <function>tree-root</function>,
1117 <function>grove-root</function>,
1118 <function>source</function>,
1119 <function>subtree</function>,
1120 <function>subgrove</function>,
1121 <function>ancestors</function>,
1122 <function>grove-root-path</function>,
1123 <function>rsiblings</function>,
1124 <function>ipreced</function>,
1125 <function>ifollow</function>,
1126 <function>grove-before?</function>,
1127 <function>sort-in-tree-order</function>,
1128 <function>tree-before?</function>,
1129 <function>tree-before</function>,
1130 <function>property-lookup</function>,
1131 <function>select-by-property</function>, 
1132 <function>select-by-null-property</function>,
1133 <function>select-by-missing-property</function>,
1134 <function>attribute</function>,
1135 <function>referent</function>,
1136 <function>q-element</function>,
1137 <function>q-class</function>,
1138 <function>q-sdata</function>.
1139     </para>
1140   </listitem>
1141 </itemizedlist>
1142 </sect1>
1143 <sect1><title>Version 1.2.2</title>
1144 <formalpara><title>Released June 1999</title>
1145 <para>The first release of OpenJade.</para>
1146 </formalpara>
1147
1148 <para>Changes in OpenJade 1.2.2</para>
1149
1150 <itemizedlist>
1151   <listitem>
1152     <para>
1153 The HTML and MIF backends are now enabled by default.
1154     </para>
1155   </listitem>
1156
1157   <listitem>
1158     <para>
1159 The TeX backend has support for PDF bookmarks. This is
1160   supported by the new version of jadetex which is included.
1161     </para>
1162   </listitem>
1163
1164   <listitem>
1165     <para>
1166 Predefined character names <function>line-feed</function> and <function>carriage-return</function> 
1167   for the character numbers 10 and 13.
1168     </para>
1169   </listitem>
1170
1171   <listitem>
1172     <para>
1173 standard-chars and map-sdata-entity declaration element
1174 type forms are supported.
1175     </para>
1176   </listitem>
1177
1178   <listitem>
1179     <para>
1180 Style language additions: map-constructor.
1181     </para>
1182   </listitem>
1183  
1184   <listitem>
1185     <para>
1186 <function>+</function> and <function>-</function> return a <function>length-spec</function> if any of there arguments
1187   is a <function>length-spec</function>.
1188     </para>
1189   </listitem>
1190
1191   <listitem>
1192     <para>
1193 Most of the DSSSL non-core expression language:
1194 <function>c...r</function>,
1195 <function>assoc</function>,
1196 <function>keyword->string</function>,
1197 <function>string->keyword</function>,
1198 <function>exact?</function>,
1199 <function>inexact?</function>,
1200 <function>zero?</function>,
1201 <function>positive?</function>,
1202 <function>negative?</function>,
1203 <function>odd?</function>,
1204 <function>even?</function>,
1205 <function>exp</function>,
1206 <function>log</function>,
1207 <function>sin</function>,
1208 <function>cos</function>,
1209 <function>tan</function>,
1210 <function>asin</function>,
1211 <function>acos</function>,
1212 <function>atan</function>,
1213 <function>expt</function>,
1214 <function>exact->inexact</function>,
1215 <function>inexact->exact</function>,
1216 <function>quantity->number</function>,
1217 <function>string->list</function>,
1218 <function>list->string</function>,
1219 <function>map</function>,
1220 <function>time&lt;?</function>,
1221 <function>time>?</function>,
1222 <function>time&lt;=?</function>,
1223 <function>time&gt;=?</function>.
1224     </para>
1225   </listitem>
1226   </itemizedlist>
1227 </sect1>
1228
1229 <sect1><title>Jade Version 1.2.1</title>
1230 <formalpara><title>Released October 1998</title>
1231 <para>Jade 1.2.1 was the final release of jade from James Clark. OpenJade is based on this code base.</para></formalpara>
1232 </sect1>
1233
1234 </chapter>
1235 </book>