Changes since the 1.71.1 release


Table of Contents

Release: 1.72.0
Common
FO
HTML
Manpages
Params
Template
Tools
Roundtrip

Release: 1.72.0

The following is a list of changes that have been made since the 1.71.1 release.

Common

The following changes have been made to the common code since the 1.71.1 release.

  • Add empty template for sidebar in label.markup mode.

  • Add utility template tabstyle to return the tabstyle from
    any table element.

  • Add support for arabicindic numbering to autolabel.format template.

  • Moved the index entity declarations to a separate common file.

  • Add title.markup mode for glossdiv to support info/title.

  • Remove link.title.attribute, replaced in html/html.xsl

  • Fixed typo in xsl:with-param

  • Use number() in some comparisons to ensure number data type.

  • Fix bug #1596737 extra white space introduced by olink.
    Now output indent="no" for target data.

  • Use copy-of instead of value-of for xreftext to preserve markup.

  • Add template link.title.attribute.

  • Modify gentext.template to respect parameter verbose = 0.
    Modify gentext.template.exists to use gentext.template with verbose = 0.

  • Finish support for @xml:id everywhere @id is used.

  • replace name() with local-name() in most cases.

  • Add support for info.

  • Fixed add-xml-base for Windows and Xalan case.

  • Added NodeInfo prefix to list of exclude-result-prefixes

FO

The following changes have been made to the fo code since the 1.71.1 release.

  • Added index.page.number.properties attribute set to the set of
    reference documentation for the FO stylesheets.

  • Changed VERSION file to include distro title (DocBook XSL
    Stylesheets), and updated HTML, FO, and manpages stylesheets to
    use that in their metadata sections (e.g., in HTML, the
    <meta name="generator" ...> contents).

  • Remove duplicate orgname template.
    Switch org templates to using inline.charseq which
    handles simple.xlink.

  • Add index.page.number.properties attribute-set to format page numbers.

  • Pass the toc-context down to the toc.line template.

  • Fixed bug in use of isogen key.

  • Add support for crop marks in Antenna House.

  • Obsolete now that info is supported.

  • Move show-destination="replace" property from template to attribute-set
    so it can be customized.

  • Add table.row.properties template to customize table rows.

  • Moved the entities declarations to a separate common file.

  • Add support for sorting glossary entries

  • Remove obsolete dobookng.xsl, since info now supported.

  • Fix bug #1614469 for citation linking to biblioentry.

  • Moved all properties to attribute-sets so can be customized more easily.

  • Fixed bug #1603790: no space between package and classname.

  • include stub file for annotations.xsl

  • Add simple.xlink processing to term and member elements.

  • Initial checkin of file for annotation processing.

  • Some more inlines to use simple.xlink.

  • xref now supports xlink:href, using simple.xlink template.

  • modified link template to use simple.xlink now.

  • Use number() in some comparisons to ensure number data type.

  • Rewrote simple.xlink, and call it with all charseq templates.

  • Finish support for @xml:id everywhere @id is used.

  • replace name() with local-name() in most cases.

  • Add support for info element.

  • support title in info too.

HTML

The following changes have been made to the html code since the 1.71.1 release.

  • Changed VERSION file to include distro title (DocBook XSL
    Stylesheets), and updated HTML, FO, and manpages stylesheets to
    use that in their metadata sections (e.g., in HTML, the
    <meta name="generator" ...> contents).

  • Add support in imageobjectco for otherunits="imagemap" to allow
    direct authoring of imagemap units.

  • Use areaspec id as imagemap map name.

  • Fixed imagemaps so they work properly going from calspair coords
    to HTML area coords.

  • qandaset was not outputting an anchor id, now it is.

  • Obsolete now that info is supported.

  • Moved the entities declarations to a separate common file.

  • Add support for sorting glossary entries

  • Remove docbookng.xsl since info now supported.

  • Add support for qanda.in.toc to add qandaentry questions to document TOC.

  • Fix bug #1614469 for citation linking to biblioentry.

  • Fixed bug #1603790: no space between package and classname.

  • Fixed two next/prev bugs.

  • *.propagates.style now handled in class.attribute mode.

  • add simple.xlink support to variablelist term and simplelist member.

  • fix class attribute on sgmltag.

  • 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.

  • Add class.attribute mode to generate class attributes.

  • Added simple.xlink to most remaining inlines.
    Changed class attributes to applying class.attributes mode.

  • Changed xref template to use simple.xlink tempalte.

  • Improve generate.html.title to work with link targets too.

  • Improved simple.xlink to support link and xref.

  • Use number() in some comparisons to ensure number data type.

  • Convert link element template to use simple.xlink.

  • Improvements in simple.xlink.

  • Use new link.title.attribute now.

  • Rewrote simple.xlink to handle linkend also.
    Better computation of title attribute on link too.

  • Fix syntax errors.

  • Finish support for @xml:id everywhere @id is used.

  • replace name() with local-name() in most cases.

  • Handle Xalan quirk as special case.

  • Add support for info.

Manpages

The following changes have been made to the manpages code since the 1.71.1 release.

  • Changed VERSION file to include distro title (DocBook XSL
    Stylesheets), and updated HTML, FO, and manpages stylesheets to
    use that in their metadata sections (e.g., in HTML, the
    <meta name="generator" ...> contents).

  • Removed single-pass namespace stripping from manpages stylesheet.
    To process DocBook 5 instances, either use the experimental
    namespace-aware DocBook 5 XSL 1.0 stylesheets, or pre-process your
    source to do the namespace stripping (two-pass processing).

  • 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.

  • Use U+2592 as an internal marker for linebreak around sbr output
    (to prevent the break from getting eaten by some normalization
    that the stylesheet does on synopses).
    Use U+2580 as an internal marker for no-break space (to work
    around a similar issue). Closes bug #1612808. Thanks to Simon
    Walter for reporting it (the sbr bug).

  • Adjusted manpages stylesheet to use U+2593 as the internal
    representation for the backslash character within the stylesheet.
    This prevents backslashes in source content from getting eaten.
    Closes #1609425. Thanks to Paul DuBois for reporting the bug.

  • Changed manpages stylesheet to always output a U+2591 character as
    the internal representation of a dash. The string-substitution
    map is then used to output a real dash when the final contents are
    serialized. Also, made a change that causes dots and dashes in the
    top comment to be unescaped.

  • Output newline after admonitions (Note, Warning, etc.)

  • Added the Markup element to the list of elements that get output
    in bold. Thanks to Eric S. Raymond.

  • Changed dot output to mark end of tbl(1) table format sections
    (changed from real dot to internal U+2302 representation).

  • 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.

  • This is a first attempt at ensuring 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). This
    probably breaks something else and therefore will likely need some
    refinement after more testing. Closes bug #1602616. Thanks to
    Daniel Leidert.

  • Fix bug: change <text> to <xsl:text>

  • Fixed two element name typos.

Params

The following changes have been made to the params code since the 1.71.1 release.

  • Repaired bizarro-superman talk.

  • 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.

  • 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.

  • Use U+2592 as an internal marker for linebreak around sbr output
    (to prevent the break from getting eaten by some normalization
    that the stylesheet does on synopses).
    Use U+2580 as an internal marker for no-break space (to work
    around a similar issue). Closes bug #1612808. Thanks to Simon
    Walter for reporting it (the sbr bug).

  • Changed order of string replacements so that backslash is escaped
    and replaced after backslash and dot (as it needs to be).

  • Adjusted manpages stylesheet to use U+2593 as the internal
    representation for the backslash character within the stylesheet.
    This prevents backslashes in source content from getting eaten.
    Closes #1609425. Thanks to Paul DuBois for reporting the bug.

  • Changed manpages stylesheet to always output a U+2591 character as
    the internal representation of a dash. The string-substitution
    map is then used to output a real dash when the final contents are
    serialized. Also, made a change that causes dots and dashes in the
    top comment to be unescaped.

  • output "\&." instead of just plain "\." (because plain "\." does
    not work...)

  • Fixed problem where newlines were dropped before dots.

  • Only escape dot if it actually occurs at the beginning of a line.

  • fixed well-formedness errors

  • 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.

  • Add index.page.number.properties by default.

  • Added to allow customizations of page numbers in indexes.

  • Improved wording.

  • Move show-destination="replace" property from template to attribute-set
    so it can be customized.

  • dd support for sorting glossary entries

  • Improved wording.

  • Add option to include qanda in tables of contents.

  • This is a first attempt at ensuring 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). This
    probably breaks something else and therefore will likely need some
    refinement after more testing. Closes bug #1602616. Thanks to
    Daniel Leidert.

  • 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 (#1604770).

Tools

The following changes have been made to the tools code since the 1.71.1 release.

  • Updated master makefile to enable docbook5-xsl build and
    packaging.

  • Updated automated xsl-param markup system to handle
    wordml->roundtrip name change.

  • wordml->roundtrip name change

  • 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.

Roundtrip

The following changes have been made to the roundtrip code since the 1.71.1 release.

  • wordml->roundtrip name change

  • rename to roundtrip, add OpenOffice support