[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [docbook-apps] ANNOUNCE: DocBook XSL 1.71.1 released
Version 1.71.1 of the DocBook XSL stylesheets is now available for
download from the DocBook project site.
http://docbook.sf.net/files/xsl/latest
http://docbook.sf.net/files/xsl-doc/latest
http://sourceforge.net/projects/docbook
The release notes are included below. HTML and PDF versions of the
release notes are also available:
http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.html
http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.pdf
------------------------------------------------------------------------------
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.
Common
The following changes have been made to the common code since the 1.71.0
release.
* For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
* Add support for Xalan generating a root xml:base like saxon.
FO
The following changes have been made to the fo code since the 1.71.0 release.
* For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
* Add support for Xalan to add root node xml:base for db5 docs.
* Added support for profiling based on xml:lang and status attributes.
HTML
The following changes have been made to the html code since the 1.71.0
release.
* For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
* Add support for Xalan to add root node xml:base for db5 docs.
* Added support for profiling based on xml:lang and status attributes.
* Made changes in namespace declarations to prevent xmllint's
canonicalizer from treating them as relative namespace URIs.
- Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";;
Saxon accepts either form
(see http://www.saxonica.com/documentation/extensibility/functions.html);
to Saxon, "the part of the URI before the final '/' is immaterial".
- Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
either form
(see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
just as Saxon does, it will "simply use the string to the
right of the rightmost forward slash as the Java class name".
- Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
to xmlns:redirect="http://xml.apache.org/xalan/redirect";, and
adjusted associated code to make the current Xalan redirect spec.
(see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/Redirect.html)
* Added the html.append and chunk.append parameters. By default, the
value of both is empty; but the internal DocBook XSL stylesheets
build sets their value to "<xsl:text>
</xsl:text>", in order
to ensure that all files in the docbook-xsl-doc package end in a
newline character. (Because diff and some other tools may emit
error messages and/or not behave as expected when processing
files that are not newline-terminated.)
Highlighting
The following changes have been made to the highlighting code since the 1.71.0
release.
* Added license information
Manpages
The following changes have been made to the manpages code since the 1.71.0
release.
* 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 (currently titled
REFERENCES, for English output, but will be changed to NOTES).
This support is not yet complete. It works for most "normal"
cases, but probably mishandles a good number of cases. More
testing will be needed to expose the problems. It may well also
introduce some bugs and regressions in other areas, including
basic paragraph handling, handling of "mixed block" content,
handling of other indented content, and handling of authorblurb
and personblurb in the AUTHORS section.
Params
The following changes have been made to the params code since the 1.71.0
release.
* Added support for profiling based on xml:lang and status attributes.
* Added the html.append and chunk.append parameters. By default, the
value of both is empty; but the internal DocBook XSL stylesheets
build sets their value to "<xsl:text>
</xsl:text>", in order
to ensure that all files in the docbook-xsl-doc package end in a
newline character. (Because diff and some other tools may emit
error messages and/or not behave as expected when processing
files that are not newline-terminated.)
Profiling
The following changes have been made to the profiling code since the 1.71.0
release.
* Added support for profiling based on xml:lang and status attributes.
Release: 1.71.0
This is mainly a bug fix release, but it also includes two significant feature
changes:
Highlighting support added
The stylesheets now include support for source-code highlighting in output
of programlisting instances (controlled through the highlight.source
parameter). The Java-based implementation requires Saxon and makes use of
Michal Molhanecs XSLTHL. More details are available at Jirka Koseks
website:
http://xmlguru.cz/2006/07/docbook-syntax-highlighting
The support is currently limited to highlighting of XML, Java, PHP,
Delphi, Modula-2 sources, and INI files.
Changes to autoindexing
The templates that handle alternative indexing methods were reworked to
avoid errors produced by certain processors not being able to tolerate the
presence of unused functions. With this release, none of the code for the
'kimber' or 'kosek' methods is included in the default stylesheets. In
order to use one of those methods, your customization layer must import
one of the optional stylesheet modules:
* html/autoidx-kosek.xsl
* html/autoidx-kimber.xsl
* fo/autoidx-kosek.xsl
* fo/autoidx-kimber.xsl
See the index.method parameter reference page for more information.
Two other changes to note:
* The default indexing method now can handle accented characters in
latin-based alphabets, not just English. This means accented latin
letters will group and sort with their unaccented counterpart.
* The default value for the index.method parameter was changed from
'english' to 'basic' because now the default method can handle
latin-based alphabets, not just English.
The following is a list of changes that have been made since the 1.70.1
release.
Common
The following changes have been made to the common code since the 1.70.1
release.
* Added reference.autolabel parameter for controlling labels on
reference output.
* Support rows that are *completely* overlapped by the preceding row
* New modules for supporting indexing extensions.
* Support startinglinenumber on orderedlist
Extensions
The following changes have been made to the extensions code since the 1.70.1
release.
* Completely reworked extensions build system; now uses NetBeans and ant
FO
The following changes have been made to the fo code since the 1.70.1 release.
* xsl:sort lang attribute now uses two-char substring of lang attribute.
* Support titlecase "Java", "Perl", and "IDL" as values for the
language attribute on classsynopsis, etc. (instead of just
lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
(instead of just "cpp").
Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
to "Brian A. Vanderburg II".
* Added support for the reference.autolabel param in (X)HTML and FO
output.
* Support rows that are *completely* overlapped by the preceding row
* Rearranged templates for the 3 indexing methods
and changed method named 'english' to 'basic'.
* New modules for supporting indexing extensions.
* Turn off blank-body for fop1.extensions too since fop 0.92
does not support it either.
* Add Xalan variant to test for exslt:node-set function.
Xalan can use function named node-set(), but doesn't
recognize it using function-available().
* Added support to FO stylesheets for handling instances of Org
where it occurs outside of *info content. In HTML stylesheets,
moved handling of Org out of info.xsl and into inline.xsl. In both
FO and HTML stylesheets, added support for correctly processing
Affiliation and Jobtitle.
* Don't output punctuation between Refname and Refpurpose if
Refpurpose is empty. Also corrected handling of Refsect2/title
instances, and removed some debugging stuff that was generated in
manpages output to mark the ends of sections.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* Initial support of syntax highlighting of programlistings.
* Chapter after preface should restart numbering of pages.
HTML
The following changes have been made to the html code since the 1.70.1
release.
* xsl:sort lang attribute now uses two-char substring of lang attribute.
* Support titlecase "Java", "Perl", and "IDL" as values for the
language attribute on classsynopsis, etc. (instead of just
lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
(instead of just "cpp").
Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
to "Brian A. Vanderburg II".
* Added support for the reference.autolabel param in (X)HTML and FO
output.
* Support rows that are *completely* overlapped by the preceding row
* Rearranged templates for the 3 indexing methods
and changed method named 'english' to 'basic'.
* New modules for supporting indexing extensions.
* Added several new HTML parameters for controlling appearance of
content on HTML title pages:
contrib.inline.enabled:
If non-zero (the default), output of the contrib element is
displayed as inline content rather than as block content.
othercredit.like.author.enabled:
If non-zero, output of the othercredit element on titlepages is
displayed in the same style as author and editor output. If zero
(the default), othercredit output is displayed using a style
different than that of author and editor.
blurb.on.titlepage.enabled:
If non-zero, output from authorblurb and personblurb elements is
displayed on title pages. If zero (the default), output from
those elements is suppressed on title pages (unless you are
using a titlepage customization that causes them to be included).
editedby.enabled
If non-zero (the default), a localized Edited by heading is
displayed above editor names in output of the editor element.
* Add Xalan variant to test for exslt:node-set function.
Xalan can use function named node-set(), but doesn't
recognize it using function-available().
* Added support to FO stylesheets for handling instances of Org
where it occurs outside of *info content. In HTML stylesheets,
moved handling of Org out of info.xsl and into inline.xsl. In both
FO and HTML stylesheets, added support for correctly processing
Affiliation and Jobtitle.
* Don't output punctuation between Refname and Refpurpose if
Refpurpose is empty. Also corrected handling of Refsect2/title
instances, and removed some debugging stuff that was generated in
manpages output to mark the ends of sections.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* Added qanda.nested.in.toc param. Default value is zero. If
non-zero, instances of "nested" Qandaentry (ones that are children
of Answer elements) are displayed in the TOC. Closes patch 1509018
(from Daniel Leidert). Currently on affects HTML output (no patch
for FO output provided).
* Improved handling of relative locations generated files
* Initial support of syntax highlighting of programlistings.
* Support org
* Support person
* Support $keep.relative.image.uris also when chunking
Highlighting
The following changes have been made to the highlighting code since the 1.70.1
release.
* Initial support of syntax highlighting of programlistings.
Manpages
The following changes have been made to the manpages code since the 1.70.1
release.
* Suppress footnote markers and output warning that footnotes are
not yet supported.
* Handle instances of address/otheraddr/ulink in author et al in the
same way as email instances; that is, display them on the same
linke as the author, editor, etc., name.
* Don't number or link-list any Ulink instance whose string value is
identical to the value of its url attribute. Just display it inline.
* Don't output punctuation between Refname and Refpurpose if
Refpurpose is empty. Also corrected handling of Refsect2/title
instances, and removed some debugging stuff that was generated in
manpages output to mark the ends of sections.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* In manpages output, if the last/nearest *info element for
particular Refentry has multiple Copyright and/or Legalnotice
children, process them all (not just the first ones). Closes bug
1524576. Thanks to Sam Steingold for the report and to Daniel
Leidert for providing a patch.
Params
The following changes have been made to the params code since the 1.70.1
release.
* Added reference.autolabel parameter for controlling labels on
reference output.
* Added namespace declarations to document elements for all param files.
* Updated index.method doc to describe revised setup for importing index
extensions.
* Added several new HTML parameters for controlling appearance of
content on HTML title pages:
contrib.inline.enabled:
If non-zero (the default), output of the contrib element is
displayed as inline content rather than as block content.
othercredit.like.author.enabled:
If non-zero, output of the othercredit element on titlepages is
displayed in the same style as author and editor output. If zero
(the default), othercredit output is displayed using a style
different than that of author and editor.
blurb.on.titlepage.enabled:
If non-zero, output from authorblurb and personblurb elements is
displayed on title pages. If zero (the default), output from
those elements is suppressed on title pages (unless you are
using a titlepage customization that causes them to be included).
editedby.enabled
If non-zero (the default), a localized Edited by heading is
displayed above editor names in output of the editor element.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* Added qanda.nested.in.toc param. Default value is zero. If
non-zero, instances of "nested" Qandaentry (ones that are children
of Answer elements) are displayed in the TOC. Closes patch 1509018
(from Daniel Leidert). Currently on affects HTML output (no patch
for FO output provided).
* Initial support of syntax highlighting of programlistings.
Tools
The following changes have been made to the tools code since the 1.70.1
release.
* Racheted down font sizes of headings in example makefile FO output.
* Added param and attribute set to example makefile, for getting
wrapping in verbatims in FO output.
* Renamed Makefile.paramDoc to Makefile.docParam.
* Added Makefile.paramDoc file, for creating versions of param.xsl
files with doc embedded.
* Added variable to example makefile for controlling whether HTML or
XHTML is generated.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]