Release Notes for the DocBook XSL Stylesheets
-$Revision: 10010 $ $Date: 2015-12-26 23:05:24 +0000 (Sat, 26 Dec 2015) $
-
-2015-12-26
+2016-12-09
This release-notes document is available in the following formats: HTML, 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.
+NEWS (plain text) or NEWS.html files.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Table of Contents
+Release Notes: 1.79.2
Release Notes: 1.79.1
Gentext
Older releases
About dot-zero releases
+Release Notes: 1.79.2
+
+This release doesn't contain any functional changes to the stylesheets. Rather,
+it includes changes that reflect the recent transition from sourceforge.net to
+github.com both as source repository as well as content delivery network. See
+the NEWS.xml file for a complete unedited list of commits.
+
Release Notes: 1.79.1
The following is a list of changes that have been made since the 1.78.1
If a source refentry contains a Documentation or DOCUMENTATION
section, don't report it as having missing AUTHOR information.
Also, if missing a contrib/personblurb for a person or org, report
- pointers to http://docbook.sf.net/el/personblurb and to
- http://docbook.sf.net/el/contrib
+ pointers to http://www.docbook.org/tdg5/en/html/personblurb and to
+ http://www.docbook.org/tdg5/en/html/contrib
• Michael(tm) Smith: info.xsl
• Keith Fahlgren: Makefile
- Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER
+ Use repo_dir variable everywhere, please; build with PDF_MAKER
• Michael(tm) Smith: Makefile
The following changes have been made to the common code since the 1.71.1
release.
- • Add support for arabicindic numbering to autolabel.format template.
+ • Add support for arabicindic numbering to autolabel.format template.
- • Finish support for @xml:id everywhere @id is used.
+ • Finish support for @xml:id everywhere @id is used.
- • replace name() with local-name() in most cases.
+ • replace name() with local-name() in most cases.
- • Add support for info.
+ • Add support for info.
- • Add utility template tabstyle to return the tabstyle from
- any table element.
+ • Add utility template tabstyle to return the tabstyle from
+ any table element.
FO
The following changes have been made to the fo code since the 1.71.1 release.
- • Add support for sorting glossary entries
+ • Add support for sorting glossary entries
- • Add table.row.properties template to customize table rows.
+ • Add table.row.properties template to customize table rows.
- • Moved all properties to attribute-sets so can be customized more easily.
+ • Moved all properties to attribute-sets so can be customized more easily.
- • Add index.page.number.properties attribute-set to format page numbers.
+ • Add index.page.number.properties attribute-set to format page numbers.
- • xref now supports xlink:href, using simple.xlink template.
+ • xref now supports xlink:href, using simple.xlink template.
- • Rewrote simple.xlink, and call it with all charseq templates.
+ • Rewrote simple.xlink, and call it with all charseq templates.
- • Add simple.xlink processing to term and member elements.
+ • Add simple.xlink processing to term and member elements.
- • Add support for crop marks in Antenna House.
+ • Add support for crop marks in Antenna House.
HTML
The following changes have been made to the html code since the 1.71.1 release.
- • Add support for sorting glossary entries
+ • Add support for sorting glossary entries
- • Add support for qanda.in.toc to add qandaentry questions to document TOC.
+ • Add support for qanda.in.toc to add qandaentry questions to document TOC.
- • add simple.xlink support to variablelist term and simplelist member.
+ • add simple.xlink support to variablelist term and simplelist member.
- • *.propagates.style now handled in class.attribute mode.
+ • *.propagates.style now handled in class.attribute mode.
- • add class parameter to class.attribute mode to set default class.
+ • add class parameter to class.attribute mode to set default class.
- • Convert all class attributes to use the class.attribute mode
- so class names can be customized more easily.
+ • Convert all class attributes to use the class.attribute mode
+ so class names can be customized more easily.
- • Add class.attribute mode to generate class attributes.
+ • Add class.attribute mode to generate class attributes.
- • Added simple.xlink to most remaining inlines.
- Changed class attributes to applying class.attributes mode.
+ • Added simple.xlink to most remaining inlines.
+ Changed class attributes to applying class.attributes mode.
- • Changed xref template to use simple.xlink tempalte.
+ • Changed xref template to use simple.xlink tempalte.
- • Improve generate.html.title to work with link targets too.
+ • Improve generate.html.title to work with link targets too.
- • Improved simple.xlink to support link and xref.
+ • Improved simple.xlink to support link and xref.
- • Use new link.title.attribute now.
+ • Use new link.title.attribute now.
- • Rewrote simple.xlink to handle linkend also.
- Better computation of title attribute on link too.
+ • Rewrote simple.xlink to handle linkend also.
+ Better computation of title attribute on link too.
- • Handle Xalan quirk as special case.
+ • Handle Xalan quirk as special case.
- • Add support for info.
+ • Add support for info.
- • Fixed imagemaps so they work properly going from calspair coords
- to HTML area coords.
+ • Fixed imagemaps so they work properly going from calspair coords
+ to HTML area coords.
Manpages
The following changes have been made to the manpages code since the 1.71.1
release.
- • Added doc for man.output.lang.in.name.enabled parameter. This
- checkin completes support for writing file/pathnames for man-pages
- with $lang include in the names. Closes #1585967. knightly
- accolades to Daniel Leidert for providing the feature request.
-
- • Added new param man.output.lang.in.name.enabled, which
- controls whether $LANG value is included in manpages
- 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 the $lang value 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
-
- • Use "\e" instead of "\\" for backslash output, because the
- groff docs say that's the correct thing to do; also because
- testing (thanks, Paul Dubois) shows that "\\" doesn't always
- work as expected; for example, "\\" within a table seems to
- mess things up.
-
- • Added the man.string.subst.map.local.pre and
- man.string.subst.map.local.post parameters. Those parameters
- enable local additions and changes to string-substitution mappings
- without the need to change the value of man.string.subst.map
- parameter (which is for standard system mappings). Closes
- #1456738. Thanks to Sam Steingold for constructing a true
- stylesheet torture test (the clisp docs) that exposed the need for
- these params.
-
- • Added the Markup element to the list of elements that get output
- in bold. Thanks to Eric S. Raymond.
-
- • Replaced all dots in roff requests with U+2302 ("house"
- character), and added escaping in output for all instances of dot
- that are not in roff requests. This fixes the problem case where a
- string beginning with a dot (for example, the string ".bashrc")
- might occur at the beginning of a line in output, in which case
- would mistakenly get interpreted as a roff request. Thanks to Eric
- S. Raymond for pushing to fix this.
-
- • Made change to ensure that list content nested in
- itemizedlist and orderedlist instances is properly indented. This
- is a switch from using .TP to format those lists to using .RS/.RE
- to format them instead (because .TP does not allow nesting). Closes bug #
+ • Added doc for man.output.lang.in.name.enabled parameter. This
+ checkin completes support for writing file/pathnames for man-pages
+ with $lang include in the names. Closes #1585967. knightly
+ accolades to Daniel Leidert for providing the feature request.
+
+ • Added new param man.output.lang.in.name.enabled, which
+ controls whether $LANG value is included in manpages
+ 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 the $lang value 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
+
+ • Use "\e" instead of "\\" for backslash output, because the
+ groff docs say that's the correct thing to do; also because
+ testing (thanks, Paul Dubois) shows that "\\" doesn't always
+ work as expected; for example, "\\" within a table seems to
+ mess things up.
+
+ • Added the man.string.subst.map.local.pre and
+ man.string.subst.map.local.post parameters. Those parameters
+ enable local additions and changes to string-substitution mappings
+ without the need to change the value of man.string.subst.map
+ parameter (which is for standard system mappings). Closes
+ #1456738. Thanks to Sam Steingold for constructing a true
+ stylesheet torture test (the clisp docs) that exposed the need for
+ these params.
+
+ • Added the Markup element to the list of elements that get output
+ in bold. Thanks to Eric S. Raymond.
+
+ • Replaced all dots in roff requests with U+2302 ("house"
+ character), and added escaping in output for all instances of dot
+ that are not in roff requests. This fixes the problem case where a
+ string beginning with a dot (for example, the string ".bashrc")
+ might occur at the beginning of a line in output, in which case
+ would mistakenly get interpreted as a roff request. Thanks to Eric
+ S. Raymond for pushing to fix this.
+
+ • Made change to ensure that list content nested in
+ itemizedlist and orderedlist instances is properly indented. This
+ is a switch from using .TP to format those lists to using .RS/.RE
+ to format them instead (because .TP does not allow nesting). Closes bug #
1602616.
- Thanks to Daniel Leidert.
+ Thanks to Daniel Leidert.
Params
The following changes have been made to the params code since the 1.71.1
release.
- • Added doc for man.output.lang.in.name.enabled parameter. This
- checkin completes support for writing file/pathnames for man-pages
- with $lang include in the names. Closes #1585967. knightly
- accolades to Daniel Leidert for providing the feature request.
+ • Added doc for man.output.lang.in.name.enabled parameter. This
+ checkin completes support for writing file/pathnames for man-pages
+ with $lang include in the names. Closes #1585967. knightly
+ accolades to Daniel Leidert for providing the feature request.
- • Added new param man.output.lang.in.name.enabled, which
- controls whether $LANG value is included in manpages
- filenames and pathnames. It works like this:
+ • Added new param man.output.lang.in.name.enabled, which
+ controls whether $LANG value is included in manpages
+ 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 the $lang value included in
- their filenames or pathnames as follows;
+ If the value of man.output.lang.in.name.enabled is non-zero,
+ man-page files are output with the $lang value 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 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
+ - if man.output.subdirs.enabled is zero, each file is output
+ with a foo.$lang.8 filename
- • Added the man.string.subst.map.local.pre and
- man.string.subst.map.local.post parameters. Those parameters
- enable local additions and changes to string-substitution mappings
- without the need to change the value of man.string.subst.map
- parameter (which is for standard system mappings). Closes
- #1456738. Thanks to Sam Steingold for constructing a true
- stylesheet torture test (the clisp docs) that exposed the need for
- these params.
+ • Added the man.string.subst.map.local.pre and
+ man.string.subst.map.local.post parameters. Those parameters
+ enable local additions and changes to string-substitution mappings
+ without the need to change the value of man.string.subst.map
+ parameter (which is for standard system mappings). Closes
+ #1456738. Thanks to Sam Steingold for constructing a true
+ stylesheet torture test (the clisp docs) that exposed the need for
+ these params.
- • Add index.page.number.properties by default.
+ • Add index.page.number.properties by default.
- • Added index.page.number.properties
- to allow customizations of page numbers in indexes.
+ • Added index.page.number.properties
+ to allow customizations of page numbers in indexes.
- • Move show-destination="replace" property from template to attribute-set
- so it can be customized.
+ • Move show-destination="replace" property from template to attribute-set
+ so it can be customized.
- • Add support for sorting glossary entries
+ • Add support for sorting glossary entries
- • Add option to include qanda in tables of contents.
+ • Add option to include qanda in tables of contents.
- • Moved all properties to attribute-sets so can be customized more easily.
+ • Moved all properties to attribute-sets so can be customized more easily.
Template
The following changes have been made to the template code since the 1.71.1
release.
- • Added workaround for Xalan bug: use for-each and copy instead of copy-of (#
+ • Added workaround for Xalan bug: use for-each and copy instead of copy-of (#
1604770).
Roundtrip
The following changes have been made to the roundtrip code since the 1.71.1
release.
- • rename to roundtrip, add OpenOffice support
+ • rename to roundtrip, add OpenOffice support
Release: 1.71.1
The following changes have been made to the common code since the 1.71.1
release.
- • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
+ • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
- • Add support for Xalan generating a root xml:base like saxon.
+ • 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.1 release.
- • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
+ • 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.
+ • Add support for Xalan to add root node xml:base for db5 docs.
- • Added support for profiling based on xml:lang and status attributes.
+ • 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.1 release.
- • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
+ • 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.
+ • Add support for Xalan to add root node xml:base for db5 docs.
- • Added support for profiling based on xml:lang and status attributes.
+ • 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.
+ • 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/
+ - 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/
+ 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".
+ 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#
+ - 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".
+ 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/
+ - 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.)
+ • 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.1
release.
- • Added license information
+ • Added license information
Manpages
The following changes have been made to the manpages code since the 1.71.1
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).
+ • 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.
+ 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.1
release.
- • Added support for profiling based on xml:lang and status attributes.
+ • 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.)
+ • 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.1
release.
- • Added support for profiling based on xml:lang and status attributes.
+ • Added support for profiling based on xml:lang and status attributes.
Release: 1.71.0
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.
+ • Added reference.autolabel parameter for controlling labels on
+ reference output.
- • Support rows that are *completely* overlapped by the preceding row
+ • Support rows that are *completely* overlapped by the preceding row
- • New modules for supporting indexing extensions.
+ • New modules for supporting indexing extensions.
- • Support startinglinenumber on orderedlist
+ • 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
+ • 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.
+ • 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").
+ • 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".
+ 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
+ • Added support for the reference.autolabel param in (X)HTML and FO
output.
- • Support rows that are *completely* overlapped by the preceding row
+ • Support rows that are *completely* overlapped by the preceding row
- • Rearranged templates for the 3 indexing methods
- and changed method named 'english' to 'basic'.
+ • Rearranged templates for the 3 indexing methods
+ and changed method named 'english' to 'basic'.
- • New modules for supporting indexing extensions.
+ • New modules for supporting indexing extensions.
- • Turn off blank-body for fop1.extensions too since fop 0.92
- does not support it either.
+ • 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().
+ • 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.
+ • 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.
+ • 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 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.
+ • Initial support of syntax highlighting of programlistings.
- • Chapter after preface should restart numbering of pages.
+ • 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.
+ • 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").
+ • 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".
+ 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
+ • Added support for the reference.autolabel param in (X)HTML and FO
output.
- • Support rows that are *completely* overlapped by the preceding row
+ • Support rows that are *completely* overlapped by the preceding row
- • Rearranged templates for the 3 indexing methods
- and changed method named 'english' to 'basic'.
+ • Rearranged templates for the 3 indexing methods
+ and changed method named 'english' to 'basic'.
- • New modules for supporting indexing extensions.
+ • New modules for supporting indexing extensions.
- • Added several new HTML parameters for controlling appearance of
- content on HTML title pages:
+ • 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.
+ 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.
+ 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).
+ 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.
+ 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().
+ • 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.
+ • 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.
+ • 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 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).
+ • 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
+ • Improved handling of relative locations generated files
- • Initial support of syntax highlighting of programlistings.
+ • Initial support of syntax highlighting of programlistings.
- • Support org
+ • Support org
- • Support person
+ • Support person
- • Support $keep.relative.image.uris also when chunking
+ • 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.
+ • 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.
+ • 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.
+ • 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 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.
+ • 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 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.
+ • 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 reference.autolabel parameter for controlling labels on
+ reference output.
- • Added namespace declarations to document elements for all param files.
+ • Added namespace declarations to document elements for all param files.
- • Updated index.method doc to describe revised setup for importing index
- extensions.
+ • 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:
+ • 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.
+ 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.
+ 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).
+ 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.
+ 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 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).
+ • 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.
+ • 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.
+ • 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.
+ • Added param and attribute set to example makefile, for getting
+ wrapping in verbatims in FO output.
- • Renamed Makefile.paramDoc to Makefile.docParam.
+ • Renamed Makefile.paramDoc to Makefile.docParam.
- • Added Makefile.paramDoc file, for creating versions of param.xsl
- files with doc embedded.
+ • 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.
+ • Added variable to example makefile for controlling whether HTML or
+ XHTML is generated.
Release: 1.70.1
Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton
- • Added parameter ulink.hyphenate.chars. Added parameter insert.link
- .page.number.
+ • Added parameter ulink.hyphenate.chars. Added parameter
+ insert.link.page.number.
Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton
• Implemented RFE #1292615.
Added bunch of new parameters (attribute sets) that affect list
- presentation: list.block.properties, itemizedlist.properties, orderedlist
- .properties, itemizedlist.label.properties and orderedlist.label
- .properties. Default behaviour of stylesheets has not been changed but
- further customizations will be much more easier.
+ presentation: list.block.properties, itemizedlist.properties,
+ orderedlist.properties, itemizedlist.label.properties and
+ orderedlist.label.properties. Default behaviour of stylesheets has not been
+ changed but further customizations will be much more easier.
Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
itemizedlist.label.properties.xml,1.1; params/
param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
Smith
- • Added two new params: html.head.legalnotice.link.types and html.head.
- legalnotice.link.multiple.
+ • Added two new params: html.head.legalnotice.link.types and
+ html.head.legalnotice.link.multiple.
If the value of the generate.legalnotice.link is non-zero, then the
stylesheet generates (in the head section of the HTML source) either a
- single HTML link element or, if the value of the html.head.legalnotice.link
- .multiple is non-zero, one link element for each link type specified. Each
- link has the following attributes:
+ single HTML link element or, if the value of the
+ html.head.legalnotice.link.multiple is non-zero, one link element for each
+ link type specified. Each link has the following attributes:
- - a rel attribute whose value is derived from the value of html.head.
- legalnotice.link.types
+ - a rel attribute whose value is derived from the value of
+ html.head.legalnotice.link.types
- an href attribute whose value is set to the URL of the file containing
the legalnotice
• Added man.table.footnotes.divider param.
- In each table that contains footenotes, the string specified by the man.
- table.footnotes.divider parameter is output before the list of footnotes
- for the table.
+ In each table that contains footenotes, the string specified by the
+ man.table.footnotes.divider parameter is output before the list of
+ footnotes for the table.
Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
param.ent,1.21; manpages/param.xweb,1.23; params/
param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
Smith
- • Added two new params: html.head.legalnotice.link.types and html.head.
- legalnotice.link.multiple.
+ • Added two new params: html.head.legalnotice.link.types and
+ html.head.legalnotice.link.multiple.
If the value of the generate.legalnotice.link is non-zero, then the
stylesheet generates (in the head section of the HTML source) either a
- single HTML link element or, if the value of the html.head.legalnotice.link
- .multiple is non-zero, one link element for each link type specified. Each
- link has the following attributes:
+ single HTML link element or, if the value of the
+ html.head.legalnotice.link.multiple is non-zero, one link element for each
+ link type specified. Each link has the following attributes:
- - a rel attribute whose value is derived from the value of html.head.
- legalnotice.link.types
+ - a rel attribute whose value is derived from the value of
+ html.head.legalnotice.link.types
- an href attribute whose value is set to the URL of the file containing
the legalnotice
• Added man.table.footnotes.divider param.
- In each table that contains footenotes, the string specified by the man.
- table.footnotes.divider parameter is output before the list of footnotes
- for the table.
+ In each table that contains footenotes, the string specified by the
+ man.table.footnotes.divider parameter is output before the list of
+ footnotes for the table.
Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
param.ent,1.21; manpages/param.xweb,1.23; params/
• Implemented RFE #1292615.
Added bunch of new parameters (attribute sets) that affect list
- presentation: list.block.properties, itemizedlist.properties, orderedlist
- .properties, itemizedlist.label.properties and orderedlist.label
- .properties. Default behaviour of stylesheets has not been changed but
- further customizations will be much more easier.
+ presentation: list.block.properties, itemizedlist.properties,
+ orderedlist.properties, itemizedlist.label.properties and
+ orderedlist.label.properties. Default behaviour of stylesheets has not been
+ changed but further customizations will be much more easier.
Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
itemizedlist.label.properties.xml,1.1; params/
be processed using the following URI for the driver Website tabular.xsl
file:
- http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl
+ http://cdn.docbook.org/release/xsl/current/website/tabular.xsl
• A procedure without a title is now treated as an “informal” procedure
(meaning that it is not added to any generated “list of procedures” and has
To indicate that you want a choice separator generated for a particular
list, you need to put a processing instruction (PI) of the form <?
- dbchoice choice="foo"?> as a child of the list. For example:
+ dbchoice choice="foo"?> as a child of the list. For example:
<para>Choose from
ONE and ONLY ONE of the following:
As a temporary workaround for the fact that most of the DocBook non-English
locale files don't have a localization for the word “or”, you can put in a
- literal string to be used; example for French: <?dbchoice choice="ou">.
+ literal string to be used; example for French: <?dbchoice choice="ou">.
That is, use “ou” instead of “or”.
FO
• Added content-type property to external-graphic element, based on imagedata
format attribute.
- • Added support for generating <rx:meta-field creator="$VERSION"/> field for
+ • Added support for generating <rx:meta-field creator="$VERSION"/> field for
XEP output. This makes the DocBook XSL stylesheet version information
available through the Document Properties menu in Acrobat Reader and other
PDF viewers.
HTML
- • Added a first cut at support in HTML output for DocBook 5 style annotation
- s. Controlled using the annotation.support parameter, and implemented using
- JavaScript and CSS styling. For more details, see the documentation for the
- annotation.js, annotation.css, annotation.graphic.open, and
- annotation.graphic.close parameters.
+ • Added a first cut at support in HTML output for DocBook 5 style
+ annotations. Controlled using the annotation.support parameter, and
+ implemented using JavaScript and CSS styling. For more details, see the
+ documentation for the annotation.js, annotation.css,
+ annotation.graphic.open, and annotation.graphic.close parameters.
• Generate client-side image map for imageobjectco with areas using calspair
units
• Added initial, experimental support for generating content for the HTML
title attribute from content of the alt element. This change adds support
- for the following inline elements only (none of them are block elements):
+ for the following inline elements only (none of them are block elements):
abbrev, accel, acronym, action, application, authorinitials, beginpage,
citation, citerefentry, citetitle, city, classname, code, command,
computeroutput, constant, country, database, email, envar, errorcode,
errorname, errortext, errortype, exceptionname, fax, filename, firstname,
- firstterm, foreignphrase, function, glossterm, guibutton, guiicon, guilabel
- , guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,
+ firstterm, foreignphrase, function, glossterm, guibutton, guiicon,
+ guilabel, guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,
interfacename, keycap, keycode, keysym, lineage, lineannotation, literal,
markup, medialabel, methodname, mousebutton, option, optional, otheraddr,
othername, package, parameter, personname, phone, pob, postcode,
man.justify and man.hyphenate.
Note that the default for the both of those is zero (off), because
- justified text looks good only when it is also hyphenated; to quote the
- “Hyphenation” node from the groff info page:
+ justified text looks good only when it is also hyphenated; to quote the “
+ Hyphenation” node from the groff info page:
Since the odds are not great for finding a set of words, for every
output line, which fit nicely on a line without inserting excessive
• Added parameters for controlling hyphenation of computer inlines,
filenames, and URLs. By default, even when hyphenation is enabled
(globally), hyphenation is now suppressed for "computer inlines"
- (currently, just classname, constant, envar, errorcode, option, replaceable
- , userinput, type, and varname, and for filenames, and for URLs from link.
- It can be (re)enabled using the man.hyphenate.computer.inlines,
+ (currently, just classname, constant, envar, errorcode, option,
+ replaceable, userinput, type, and varname, and for filenames, and for URLs
+ from link. It can be (re)enabled using the man.hyphenate.computer.inlines,
man.hyphenate.filenames, and man.hyphenate.urls parameters.
• Implemented a new system for replacing Unicode characters. There are two
In addition to those common symbols, certain users may have a need to use
symbols from other Unicode blocks. Say, somebody who is documenting an
- application related to math might need to use a bunch of symbols from the
- “Mathematical Operators” Unicode block (there are about 65 characters in
+ application related to math might need to use a bunch of symbols from the “
+ Mathematical Operators” Unicode block (there are about 65 characters in
that block that have reasonable roff equivalents). Or somebody else might
really like Dingbats -- such as the checkmark character -- and so might use
a bunch of things from the “Dingbat” block (141 characters in that that
gracefully into roff).
So, the old replace-entities mechanism was replaced with a completely
- different mechanism that is based on use of two “maps”: a “substitution
- map” and a “character map” (the latter in a format compliant with the XSLT
- 2.0 spec and therefore completely “forward compatible” with XSLT 2.0).
+ different mechanism that is based on use of two “maps”: a “substitution map
+ ” and a “character map” (the latter in a format compliant with the XSLT 2.0
+ spec and therefore completely “forward compatible” with XSLT 2.0).
The substitution map is controlled through the man.string.subst.map
parameter, and is used to replace things like the backslash character
In practice, there are many pages that simply have a version number in
the “source” field. So, it looks like what we have is a two-part field,
- Name Version, where:
+ Name Version, where:
Name
• Added support for processing funcparams.
• Removed the space that was being output between funcdef and paramdef;
- example: was: float rand (void); now: float rand(void)
+ example: was: float rand (void); now: float rand(void)
• Turned off bold formatting for the type element when it occurs within a
funcdef or paramdef
- • Corrected rendering of simplelist. Any <simplelist type="inline" instance
- is now rendered as a comma-separated list (also with an optional localized
+ • Corrected rendering of simplelist. Any <simplelist type="inline" instance
+ is now rendered as a comma-separated list (also with an optional localized
“and” or “or” before the last item -- see description elsewhere in these
release notes). Any simplelist instance whose type is not inline is
rendered as a one-column vertical list (ignoring the values of the type and
kludge for generating “curly” quotes in Emacs and in X-Windows fonts. While
Emacs still seems to support that, I don't think X-Windows has for a long
time now. And, anyway, it looks (and has always looked) like crap when
- viewed on a normal tty/console. In addition, it breaks localiztion of quote
- . By default, quote content is output with localized quotation marks,
+ viewed on a normal tty/console. In addition, it breaks localiztion of
+ quote. By default, quote content is output with localized quotation marks,
which, depending on the locale, may or may not be left and right double
quotation marks.
• Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with
the windows-1252 character set, which is particularly useful when
- generating HTML Help for Western European Languages (code from Pontus
+ generating HTML Help for Western European Languages (code from Pontus
Haglund and contributed to the DocBook community by Sectra AB, Sweden).
To use:
<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version='1.0'>
- <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
+ <xsl:import href="http://cdn.docbook.org/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
<xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
<xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
<xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
- <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
- <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
+ <xsl:import href="http://cdn.docbook.org/release/xsl/current/fo/docbook.xsl"/>
+ <xsl:include href="http://cdn.docbook.org/release/xsl/current/fo/autoidx-ng.xsl"/>
</xsl:stylesheet>