## Changes since the 1.71.1 release

## 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