$Revision: 7393 $ $Date: 2007-08-30 22:13:49 +0900 (Thu, 30 Aug 2007) $
2007-08-30
This release-notes document is available in the following formats: HTML, PDF, plain text; it provides a per-release list of enhancements and changes to the stylesheets’ public APIs (user-configurable parameters) and excludes descriptions of most bug fixes. For a complete list of all changes (including all bug fixes) that have been made since the previous release, see the separate NEWS (plain text) or NEWS.html files. Also available: An online hyperlinked change history (warning: big file) of all changes made over the entire history of the codebase.
As with all DocBook Project “dot one plus” releases, this release aspires to be stable (in contrast to dot-zero releases, which are experimental).
Table of Contents
This is solely a minor bug-fix update to the 1.73.1 release. It fixes a packaging error in the 1.73.1 package, as well as a bug in footnote handling in FO output.
This is mostly a bug-fix update to the 1.73.0 release.
The following changes have been made to the
gentext code
since the 1.73.0 release.
Mauritz Jeanson: locale/de.xml
Michael(tm) Smith: locale/lv.xml
The following changes have been made to the
fo code
since the 1.73.0 release.
Mauritz Jeanson: table.xsl
Mauritz Jeanson: graphics.xsl
Mauritz Jeanson: admon.xsl
The following changes have been made to the
html code
since the 1.73.0 release.
Mauritz Jeanson: titlepage.xsl
Michael(tm) Smith: pi.xsl; synop.xsl
Michael(tm) Smith: formal.xsl
Robert Stayton: glossary.xsl
Mauritz Jeanson: titlepage.xsl
Mauritz Jeanson: graphics.xsl
Mauritz Jeanson: pi.xsl
The following changes have been made to the
manpages code
since the 1.73.0 release.
Michael(tm) Smith: endnotes.xsl
The following changes have been made to the
htmlhelp code
since the 1.73.0 release.
Michael(tm) Smith: htmlhelp-common.xsl
The following changes have been made to the
eclipse code
since the 1.73.0 release.
Michael(tm) Smith: eclipse.xsl
The following changes have been made to the
javahelp code
since the 1.73.0 release.
Michael(tm) Smith: javahelp.xsl
The following changes have been made to the
roundtrip code
since the 1.73.0 release.
Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl
This release includes important bug fixes and adds the following significant feature changes:
We added two new localizations: Latvian and Esperanto, and made updates to the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian localizations.
Set the
bibliography.style parameter to
iso690 to use ISO690 style.
The reference documentation that ships with the release now includes documentation on all PIs that you can use to control output from the stylesheets.
audience and wordsizeYou can now do profiling based on the values of the
audience and
wordsize attributes.
The manpages stylesheet now supports single-pass
profiling and single-pass DocBook 5 namespace stripping
(just as the HTML and FO stylesheets also do). Also, added
handling for mediaobject &
inlinemediaobject. (Each imagedata,
audiodata, or videodata element
within a mediaobject or inline
mediaobject is now treated as a "notesource"
and so handled in much the same way as links and
annotation/alt/footnote
are in manpages output.) And added the
man.authors.section.enabled and
man.copyright.section.enabled
parameters to enable control over whether output includes
auto-generated AUTHORS and
COPYRIGHT sections.
The highlighting mechanism for generating syntax-highlighted code snippets in output now supports C code listings (along with Java, PHP, XSLT, and others).
docbook-xsl-update scriptWe added an experimental docbook-xsl-update
script, the purpose of which is to facilitate
easy sync-up to the latest docbook-xsl snapshot (by means
of rsync).
The following changes have been made to the
gentext code
since the 1.72.0 release.
Michael(tm) Smith: locale/lv.xml; Makefile
Dongsheng Song: locale/zh_cn.xml
Jirka Kosek: locale/cs.xml
Robert Stayton: locale/eo.xml
Robert Stayton: locale/mn.xml
Jirka Kosek: locale/en.xml; locale/cs.xml
Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
Robert Stayton: locale/ja.xml
Robert Stayton: locale/it.xml
Mauritz Jeanson: locale/uk.xml
The following changes have been made to the
common code
since the 1.72.0 release.
Michael(tm) Smith: labels.xsl
Michael(tm) Smith: common.xsl
Michael(tm) Smith: refentry.xsl
Robert Stayton: titles.xsl
Michael(tm) Smith: titles.xsl
Mauritz Jeanson: pi.xsl
The following changes have been made to the
fo code
since the 1.72.0 release.
Robert Stayton: component.xsl
Mauritz Jeanson: xref.xsl
Michael(tm) Smith: inline.xsl
Robert Stayton: lists.xsl
Robert Stayton: table.xsl
Mauritz Jeanson: inline.xsl
Robert Stayton: param.xweb; param.ent
Robert Stayton: param.xweb; param.ent
Robert Stayton: inline.xsl; xref.xsl
Robert Stayton: autotoc.xsl; param.xweb; param.ent
Robert Stayton: component.xsl
Robert Stayton: division.xsl
Robert Stayton: param.xweb; param.ent; sections.xsl
Robert Stayton: param.xweb; param.ent; component.xsl
Robert Stayton: htmltbl.xsl; table.xsl
Robert Stayton: table.xsl
Robert Stayton: refentry.xsl
David Cramer: qandaset.xsl
Jirka Kosek: lists.xsl
Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl
Robert Stayton: param.xweb; param.ent; pagesetup.xsl
Robert Stayton: inline.xsl
The following changes have been made to the
html code
since the 1.72.0 release.
Mauritz Jeanson: param.xweb; param.ent
Michael(tm) Smith: admon.xsl
Mauritz Jeanson: xref.xsl
Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
Michael(tm) Smith: formal.xsl; pi.xsl
Michael(tm) Smith: pi.xsl; synop.xsl
Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
Michael(tm) Smith: chunk-code.xsl; graphics.xsl
Michael(tm) Smith: titlepage.xsl
Michael(tm) Smith: chunk-code.xsl
David Cramer: xref.xsl
David Cramer: lists.xsl
David Cramer: qandaset.xsl
David Cramer: lists.xsl
Mauritz Jeanson: inline.xsl
Robert Stayton: param.xweb; param.ent
Robert Stayton: inline.xsl; xref.xsl
Jirka Kosek: glossary.xsl
Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
Robert Stayton: lists.xsl
Robert Stayton: refentry.xsl
Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl
Robert Stayton: inline.xsl; xref.xsl
Mauritz Jeanson: glossary.xsl
The following changes have been made to the
manpages code
since the 1.72.0 release.
Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
Michael(tm) Smith: docbook.xsl
Michael(tm) Smith: Makefile
Michael(tm) Smith: info.xsl
Michael(tm) Smith: docbook.xsl
Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl; endnotes.xsl; ut⋯
Michael(tm) Smith: block.xsl
Michael(tm) Smith: utility.xsl
Michael(tm) Smith: endnotes.xsl
Michael(tm) Smith: utility.xsl
Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl; refentry.xsl; end⋯
Michael(tm) Smith: lists.xsl
Michael(tm) Smith: lists.xsl
Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl; links.xsl; param.ent
The following changes have been made to the
eclipse code
since the 1.72.0 release.
Mauritz Jeanson: Makefile
David Cramer: eclipse.xsl
The following changes have been made to the
javahelp code
since the 1.72.0 release.
Mauritz Jeanson: javahelp.xsl
Mauritz Jeanson: javahelp.xsl
The following changes have been made to the
roundtrip code
since the 1.72.0 release.
Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl; sections2blocks.⋯
Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
The following changes have been made to the
params code
since the 1.72.0 release.
Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml; htmlhelp.button.zo⋯
Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml; htmlhelp.alias.f⋯
Mauritz Jeanson: javahelp.encoding.xml
Mauritz Jeanson: generate.id.attributes.xml
Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml; annotation.graphic.close.⋯
Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.standalone.xm⋯
Michael(tm) Smith: label.from.part.xml
Mauritz Jeanson: callout.graphics.extension.xml
Michael(tm) Smith: abstract.notitle.enabled.xml
Michael(tm) Smith: man.string.subst.map.xml
Jirka Kosek: margin.note.float.type.xml; title.font.family.xml; table.frame.border.color.x⋯
Robert Stayton: profile.wordsize.xml; profile.audience.xml
Robert Stayton: callout.graphics.number.limit.xml; callout.graphics.extension.xml
Robert Stayton: callout.icon.size.xml
Jirka Kosek: default.units.xml; chunker.output.method.xml; toc.list.type.xml; output.inden⋯
Jirka Kosek: man.output.quietly.xml; title.font.family.xml; footnote.sep.leader.properties⋯
Robert Stayton: section.container.element.xml
Robert Stayton: component.titlepage.properties.xml
Jirka Kosek: bibliography.style.xml
Robert Stayton: make.year.ranges.xml
Robert Stayton: id.warnings.xml
Jirka Kosek: bibliography.style.xml
Robert Stayton: header.table.properties.xml; footer.table.properties.xml
The following changes have been made to the
highlighting code
since the 1.72.0 release.
Jirka Kosek: c-hl.xml; xslthl-config.xml
The following changes have been made to the
profiling code
since the 1.72.0 release.
Robert Stayton: profile-mode.xsl
The following changes have been made to the
lib code
since the 1.72.0 release.
Michael(tm) Smith: lib.xweb
The following changes have been made to the
tools code
since the 1.72.0 release.
Michael(tm) Smith: bin; bin/docbook-xsl-update
The following changes have been made to the
xsl-saxon code
since the 1.72.0 release.
Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/⋯
Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x⋯
Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan⋯
The following changes have been made to the
xsl-xalan code
since the 1.72.0 release.
Michael(tm) Smith: Makefile; xalan2
Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/⋯
Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x⋯
Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan⋯
This release includes important bug fixes and adds the following significant feature changes:
The HTML and FO stylesheets now support automatic sorting
of glossary entries. To enable glossary sorting, set
the value of the glossary.sort parameter
to 1 (by default, it’s value is
0). When you enable glossary sorting,
glossentry elements within a glossary,
glossdiv, or glosslist are sorted on the
glossterm, using the current language setting. If you
don’t enable glossary sorting, then the order of
glossentry elements is left “as is” — that is, they
are not sorted but are instead just displayed in document
order.
Stylesheets for “roundtrip” conversion between documents in OpenOffice format (ODF) and DocBook XML have been added to the set of stylesheets that formerly had the collective title WordML, and that set of stylesheets has been renamed to Roundtrip to better reflect the actual scope and purpose of its contents.
So the DocBook XSL Stylesheets now support roundtrip conversion (with certain limitations) of WordML, OpenOffice, and Apple Pages documents to and from DocBook XML.
The HTML stylesheet now provides support for including
QandASet questions in the document TOC. To
enable display of questions in the document TOC, set
the value of the qanda.in.toc to
1 (by default, it’s 0). When you
enable qanda.in.toc, then the generated
table of contents for a document will include
qandaset titles, qandadiv titles, and
question elements. The default value of zero
excludes them from the TOC.
The qanda.in.toc parameter does
not affect any tables of contents that may be generated
within a qandaset or
qandadiv (only in the document TOC).
Added new parameter man.output.lang.in.name.enabled, which controls whether
a language identifier is included in man-page filenames and
pathnames. It works like this:
If the value of man.output.lang.in.name.enabled is non-zero,
man-page files are output with a language identifier included in
their filenames or pathnames as follows:
if
man.output.subdirs.enabled is non-zero,
each file is output to, e.g., a
/$lang/man8/foo.8 pathname
if
man.output.subdirs.enabled is zero,
each file is output with a foo.$lang.8
filename
index.page.number.properties property setFor FO output, use the
index.page.number.properties to control
formatting of page numbers in index output — to (for
example) to display page numbers in index output in a
different color (to indicate that they are links).
Support has been added for generating crop marks in print/PDF output generated using Antenna House XSL Formatter
The man.string.subst.map.local.pre
and man.string.subst.map.local.post
parameters have been added to enable easier control over
custom string substitutions.
The hardcoded properties used in verbatim elements (literallayout, programlisting, screen) were moved to the verbatim.properties attribute-set so they can be more easily customized.
Now the simple.xlink template in inline.xsl works with cross reference elements xref and link as well. Also, more elements call simple.xlink, which enables DB5 xlink functionality.
Stylesheets now consistently support DocBook 5 attributes (such as xml:id). Also, DocBook 5 info elements are now checked along with other *info elements, and the use of name() function was replaced by local-name() so it also matches on DocBook 5 elements. These changes enable reusing the stylesheets with DocBook 5 documents with minimal fixup.
The HTML class attributes were formerly hardcoded to the element name. Now the class attribute is generated by applying templates in class.attribute mode so class attribute names can be customized. The default is still the element name.
Numbering of chapter, sections, and pages can now use arabic-indic numbering when number format is set to 'arabicindic' or to ١.
The following is a detailed list of changes (not including bug fixes) that have been made since the 1.71.1 release.
This is a minor update to the 1.71.0 release. Along with a number of bug fixes, it includes two feature changes:
Added support for profiling based on xml:lang and status attributes.
Added initial support in manpages output for
footnote, annotation, and alt
instances. Basically, they all now get handled the same way
ulink instances are. They are treated as a class as
"note sources": A numbered marker is generated at the place in the
main text flow where they occur, then their contents are displayed
in an endnotes section at the end of the man page.
The following changes have been made to the
highlighting code
since the 1.71.1 release.