Changes since the 0.0 release

Note: This document lists changes only since the 0.0 release. If you instead want a record of the complete list of changes for the codebase over its entire history, you can obtain one by running the following commands:

  svn checkout https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/xsl2
  svn log --xml --verbose xsl2 > ChangeHistory.xml

Table of Contents

Release Notes: snapshot_7715

Gentext
Common
FO
HTML
Slides
Website
Params
Tools
Extensions

Release Notes: snapshot_7715

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

Gentext

The following changes have been made to the gentext code since the 0.0 release.

Michael(tm) Smith: Makefile

Renamed cvstools dir to buildtools, and replaced all
references to "cvstools" in makefiles and elsewhere
with "buildtools".

Common

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

Norman Walsh: functions.xsl

Fix typo in orderedlist support (@startingnumber not @startinglinenumber)

Norman Walsh: normalize.xsl

Add mode for generating normalized titles

Norman Walsh: functions.xsl

Support startinglinenumber on orderedlist

Norman Walsh: verbatim.xsl

Add support for minlines in verbatim environment numbering

Norman Walsh: verbatim.xsl

Fix verbatim formatting; support programlistingco in linenumbering param

Norman Walsh: table.xsl

Put colgroup in XHTML namespace; there's still a DocBook namespace leaking through somewhere though

Norman Walsh: verbatim.xsl
```
Added lineNumbering function
```
Norman Walsh: functions.xsl
```
Added lineNumbering function
```
Norman Walsh: table.xsl
```
Fix XSLT2 bugs
```

Norman Walsh: olink.xsl

Remove parameters that now appear in /xsl2/params

Norman Walsh: common.xsl
```
Improve handling of personal names
```

Norman Walsh: titlepages.xsl

Support t:conditional attribute on titlepage literal result elements

Norman Walsh: gentext.xsl

Let's make boolean parameters 0/1 only (not also no/yes)

Norman Walsh: functions.xsl

Added a fake-eval-evt function to expand (a limited set of) AVTs at runtime

Norman Walsh: common.xsl

Fix handling of personal names in author/editor/etc.; make root-messages and id templates common

Norman Walsh: olink.xsl

Let's not worry about using role as xrefstyle in 5.0

Norman Walsh: mkparam.xsl; table.xsl
```
Documenting more parameters.
```

Norman Walsh: normalize.xsl

Mark automatically generated titles with 'ghost:title' so that ghost titles can be ignored if necessary

Norman Walsh: verbatim.xsl

Make sure inlinemediaobject/textobjects are expanded before attempting to number verbatim environments

Norman Walsh: labels.xsl

Label from root in the absense of any recognized wrapper

Norman Walsh: spspace.xsl; normalize.xsl; titlepages.xsl; olink.xsl; root.xsl; inlines.xsl⋯
```
Updated xpath-functions URI to CR draft URI
```
Norman Walsh: mkparam.xsl; gentext.xsl; normalize.xsl; labels.xsl
```
Switch to using /params
```
Norman Walsh: functions.xsl
```
Use .elements instead of .autolabel
```

Norman Walsh: normalize.xsl

Support the notion of remapping elements based on schema annotations; this is for some work I've done to implement DITA in DocBook, it shoudn't have any effect on the normal case

Norman Walsh: verbatim.xsl

Don't always number verbatim environments

Norman Walsh: labels.xsl
```
Handle top-level sections
```
Norman Walsh: functions.xsl
```
Added f:resolve-barename-xpointer
```
Norman Walsh: functions.xsl
```
Support annotations
```
Norman Walsh: inlines.xsl; root.xsl
```
Support annotations of inline elements
```
Norman Walsh: normalize.xsl; labels.xsl; table.xsl
```
Yet more hacking
```

Norman Walsh: functions.xsl; verbatim.xsl

Footnotes in programlistings--that was tricky.

Norman Walsh: olink.xsl; gentext.xsl; normalize.xsl
```
Yet more hacking
```

Norman Walsh: root.xsl

Make sure original base URI is preserved after normalizing

Norman Walsh: normalize.xsl
```
Improve glossary.collection handling
```
Norman Walsh: verbatim.xsl
```
More hacking
```

Norman Walsh: functions.xsl; labels.xsl

Snapshot; support for another bunch of elements

Norman Walsh: functions.xsl; gentext.xsl; table.xsl; common.xsl; titlepages.xsl; titles.xs⋯
```
Random checkpoint
```

Jirka Kosek: gentext.xsl

XSLT 2.0 is type aware, it is not possible to compare numbers and strings without cast. Probably XSLT 2.0 stylesheets should use real boolean values (true(), false()) for boolean parameters.

Michael(tm) Smith: .cvsignore
```
Ignore stuff.
```
Norman Walsh: functions.xsl; l10n.xsl; spspace.xsl; normalize.xsl; titlepages.xsl; verbati⋯
```
Convert to the official DocBook V5.0 namespace
```
Norman Walsh: functions.xsl; table.xsl; common.xsl; titlepages.xsl
```
Snapshot; more hacking
```
Norman Walsh: functions.xsl; verbatim.xsl; l10n.xsl; gentext.xsl; table.xsl; common.xsl; l⋯
```
Checkpoint: it compiles, but I don't promise anything else :-)
```

Norman Walsh: table.xsl

Unit tests now work with Saxon 8.4 (patched)

Norman Walsh: functions.xsl; verbatim.xsl; table.xsl
```
More documentation updates
```
Norman Walsh: table.xsl
```
Documentation updates
```

Jirka Kosek: functions.xsl

Initial indexing support. Indexing is by default internationalized. This is merely rewrite of XSLT 1.0+extensions indexing code  into pure XSLT 2.0. Not all XSLT 2.0 features are used now, I will study specifications more and improve code in future. Inline documentation will follow shortly, I just want to backup code into CVS.

Norman Walsh: verbatim.xsl

Handle line numbering and callouts; seems to expose Saxon 8.4 bug though

Norman Walsh: spspace.xsl; normalize.xsl; titlepages.xsl; root.xsl; common.xsl; inlines.xs⋯
```
Updated xpath-functions namespace
```

Norman Walsh: table.xsl

Initial efforts at processing CALS tables

Norman Walsh: functions.xsl

Updated xpath-functions namespace; added unit tests for f:node-id()

Norman Walsh: l10n.xsl; inlines.xsl

More hacking: lists, cross referneces, qandasets, admonitions

Norman Walsh: functions.xsl; spspace.xsl; normalize.xsl; titlepages.xsl; root.xsl; common.⋯
```
Checkpoint
```
Norman Walsh: inlines.xsl
```
Fixed reference to format-tag
```
Norman Walsh: common.xsl
```
Added a doc:reference
```
Norman Walsh: functions.xsl; l10n.xsl; gentext.xsl; root.xsl; common.xsl; normalize.xsl; i⋯
```
Updates; documentation and bug fixes
```
Norman Walsh: common.xsl
```
More documentation updates
```
Norman Walsh: common.xsl
```
More hacks; mostly adding documentation
```
Norman Walsh: functions.xsl; root.xsl; common.xsl; spspace.xsl; inlines.xsl; titlepages.xs⋯
```
More hacking
```
Norman Walsh: spspace.xsl
```
Initial checkin of some hacking
```
Norman Walsh: Makefile; functions.xsl; l10n.xsl; gentext.xsl; l10n.dtd; root.xsl; common.x⋯
```
Initial checkin of some hacking
```

FO

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

Norman Walsh: titlepages.xml
```
Added template for chapter
```

Norman Walsh: docbook.xsl

Added xref.xsl and ../common/verbatim.xsl

Norman Walsh: xref.xsl
```
Initial checkin
```
Norman Walsh: blocks.xsl; pagesetup.xsl; autotoc.xsl; docbook.xsl; graphics.xsl; inlines.x⋯
```
Hey, it actually produces output now
```

Michael(tm) Smith: .cvsignore; Makefile

Adjustments to incorporate fo/ build into snapshot build.

Norman Walsh: pagesetup.xsl; titlepages.xsl; docbook.xsl; inlines.xsl; component.xsl; Make⋯
```
Checkpoint: the FO stylesheets do not even come close to working yet
```

HTML

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

Norman Walsh: xref.xsl
```
Whitespace
```
Norman Walsh: inlines.xsl
```
Fix processing of foreignphrase
```
Norman Walsh: refentry.xsl
```
Added template for refentrytitle
```

Norman Walsh: docbook.xsl; html.xsl

Support named template for adding attributes to body element in HTML

Norman Walsh: lists.xsl
```
Make terms links
```

Norman Walsh: graphics.xsl

Only attempt to use the encoding if it's actually specified

Norman Walsh: qandaset.xsl
```
Add summary to Q&A set table
```

Norman Walsh: callouts.xsl

The current document isn't always $input

Norman Walsh: docbook.xsl

Turn on indenting just as a debugging aid, it should be turned off again before we go to production

Norman Walsh: graphics.xsl; callouts.xsl
```
Fix bugs in callout handling
```
Norman Walsh: inlines.xsl
```
Comment out framework testing hack
```
Norman Walsh: xref.xsl
```
Placeholder support for biblioref
```
Norman Walsh: titlepage.xsl
```
Match numbered refsect headers
```

Norman Walsh: graphics.xsl

Look for :/ to identify absolute URIs (because we sometimes see file:/path URIs); pass parameters to the t:relative-uri template

Norman Walsh: param.xml

Add some properties that are now needed in HTML; note that some shouldn't be

Norman Walsh: graphics.xsl
```
Support alt element in mediaobjects
```
Norman Walsh: html.xsl
```
Moved the id template to common
```
Norman Walsh: autotoc.xsl
```
Generate a toc class on ToCs
```

Michael(tm) Smith: callouts.xsl

Added number() call to cast string value to number in expression
that is doing a numeric comparison. Is this required in XSLT 2.0?
I guess it must be, because Saxon 8.7 emits the following if the
string is not cast to a number.

  Error at xsl:choose on line 87 of
  file:/opt/sgml/share/sgml/stylesheets/docbook-xsl2-snapshot/html/callouts.xsl:
  XPTY0004: Required item type of first operand of '>=' is
  xdt:_numeric_; supplied value has item type xs:string

Thanks to Mark Flacy for the bug report.

Michael(tm) Smith: .cvsignore
```
Ignore param.xsl correctly...
```
Michael(tm) Smith: .cvsignore
```
Ignore param.xsl
```
Michael(tm) Smith: Makefile
```
Fixes to get snapshot build working.
```
Norman Walsh: autotoc.xsl; formal.xsl; callouts.xsl; table.xsl; graphics.xsl; footnotes.xs⋯
```
Documenting more parameters.
```

Norman Walsh: blocks.xsl; inlines.xsl

Fix reference to annotation.graphic.open/close parameters

Norman Walsh: param.xml
```
Parameterize annotation graphics
```

Norman Walsh: verbatim.xsl

Don't bother outputting completely empty spans for linenumber-separators; tidy just throws them all away anyway

Norman Walsh: docbook.xsl

Added a message when saving normalized.xml

Norman Walsh: inlines.xsl
```
Parameterize annotation graphics
```
Norman Walsh: default.css
```
Style fiddling
```
Norman Walsh: blocks.xsl
```
Parameterize annotation graphics
```

Norman Walsh: admonitions.xsl

Revert to HTML tables for alignment; omit ghost:titles in the graphical case.

Norman Walsh: lists.xsl; biblio.xsl; titlepages.xsl; task.xsl; glossary.xsl; html.xsl; xre⋯
```
Updated xpath-functions URI to CR draft URI
```

Norman Walsh: chunker.xsl

Use named xsl:output instructions instead of a whole bunch of string parameters

Norman Walsh: docbook.xsl; param.xsl; Makefile; param.xml
```
Switch to using /params
```

Norman Walsh: docbook.xsl

Make a parameter for saving the normalized.xml file; this is just an interrum thing for debugging

Norman Walsh: blocks.xsl; inlines.xsl
```
Support annotations
```
Norman Walsh: blocks.xsl; annotation.js; docbook.xsl; param.xsl; inlines.xsl; html.xsl; de⋯
```
Support annotations of inline elements
```
Norman Walsh: blocks.xsl; lists.xsl; refentry.xsl; titlepage.xsl; param.xsl; section.xsl; ⋯
```
Yet more hacking
```
Norman Walsh: lists.xsl; titlepage.xsl; docbook.xsl; param.xsl; xref.xsl; callouts.xsl; de⋯
```
Yet more hacking
```
Norman Walsh: docbook.xsl; graphics.xsl; component.xsl; glossary.xsl; callouts.xsl; table.⋯
```
More hacking
```
Norman Walsh: synopsis.xsl
```
Support funcsynopsis
```
Norman Walsh: blocks.xsl; docbook.xsl; footnotes.xsl; formal.xsl; graphics.xsl; default.cs⋯
```
More hacking
```
Norman Walsh: blocks.xsl; lists.xsl; docbook.xsl; formal.xsl; task.xsl; xref.xsl; oosynops⋯
```
Snapshot; support for another bunch of elements
```
Norman Walsh: inlines.xsl; section.xsl; verbatim.xsl; docbook.xsl; callouts.xsl; titlepage⋯
```
Random checkpoint
```
Norman Walsh: lists.xsl; chunker.xsl; biblio.xsl; param.xsl; titlepages.xsl; glossary.xsl;⋯
```
Convert to the official DocBook V5.0 namespace
```
Norman Walsh: param.xsl; graphics.xsl; html.xsl; pi.xsl; blocks.xsl; titlepage.xsl; formal⋯
```
Snapshot; more hacking
```
Norman Walsh: docbook.css; default.css
```
Renamed
```
Norman Walsh: chunker.xsl; qandaset.xsl; graphics.xsl; inlines.xsl; component.xsl; docbook⋯
```
Checkpoint: it compiles, but I don't promise anything else :-)
```

Norman Walsh: html.xsl

Unit tests now work with Saxon 8.4 (patched)

Norman Walsh: verbatim.xsl
```
More documentation updates
```
Norman Walsh: table.xsl
```
Documentation updates
```

Jirka Kosek: autoidx.xsl; docbook.xsl; param.xsl; component.xsl; index.xsl

Initial indexing support. Indexing is by default internationalized. This is merely rewrite of XSLT 1.0+extensions indexing code  into pure XSLT 2.0. Not all XSLT 2.0 features are used now, I will study specifications more and improve code in future. Inline documentation will follow shortly, I just want to backup code into CVS.

Norman Walsh: verbatim.xsl

Handle line numbering and callouts; seems to expose Saxon 8.4 bug though

Norman Walsh: lists.xsl; param.xsl; biblio.xsl; titlepages.xsl; glossary.xsl; xref.xsl; ht⋯
```
Updated xpath-functions namespace
```

Norman Walsh: table.xsl

Initial efforts at processing CALS tables

Norman Walsh: docbook.xsl; formal.xsl; inlines.xsl; xref.xsl; math.xsl

More hacking; support termdef and mathphrase, improve support for other things

Norman Walsh: blocks.xsl
```
Support blockquote
```
Norman Walsh: lists.xsl; qandaset.xsl; admonitions.xsl; html.xsl; xref.xsl; info.xsl; titl⋯
```
More hacking: lists, cross referneces, qandasets, admonitions
```
Norman Walsh: lists.xsl; param.xsl; biblio.xsl; titlepages.xsl; docbook.css; glossary.xsl;⋯
```
Checkpoint
```
Norman Walsh: autotoc.xsl
```
Moved the parameters to param.xsl
```

Norman Walsh: param.xsl

Namespace cleanup and added a few autotoc parameters

Norman Walsh: inlines.xsl
```
Fix broken 'sgmltag' markup
```
Norman Walsh: autotoc.xsl; refentry.xsl; docbook.xsl; division.xsl; synopsis.xsl
```
More hacking; mostly to get the stylesheet reference pages to format
```

Norman Walsh: refentry.xsl; synopsis.xsl

Attempt to support documentation for the stylesheets

Norman Walsh: lists.xsl; param.xsl; biblio.xsl; titlepages.xsl; inlines.xsl; glossary.xsl;⋯
```
Updates; documentation and bug fixes
```
Norman Walsh: html.xsl
```
More documentation updates
```
Norman Walsh: inlines.xsl; titlepages.xsl; html.xsl
```
More hacks; mostly adding documentation
```
Norman Walsh: biblio.xsl; param.xsl; inlines.xsl; component.xsl; glossary.xsl; html.xsl; s⋯
```
More hacking
```
Norman Walsh: titlepages.xml
```
Initial checkin of some hacking
```
Norman Walsh: lists.xsl; param.xsl; biblio.xsl; titlepages.xsl; inlines.xsl; component.xsl⋯
```
Initial checkin of some hacking
```

Slides

The following changes have been made to the slides code since the 0.0 release.

Norman Walsh: html/slides.xsl
```
Use tunneling; refactored a bit
```

Michael(tm) Smith: Makefile; doc/Makefile; demo/frames2/Makefile; demo/frames6/Makefile; t⋯

Renamed cvstools dir to buildtools, and replaced all
references to "cvstools" in makefiles and elsewhere
with "buildtools".

Norman Walsh: html/slides.xsl
```
Fix link in slides
```

Website

The following changes have been made to the website code since the 0.0 release.

Michael(tm) Smith: schema/dtd/Makefile; schema/relaxng/Makefile; Makefile

Renamed cvstools dir to buildtools, and replaced all
references to "cvstools" in makefiles and elsewhere
with "buildtools".

Params

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

Norman Walsh: toc.max.depth.xml
```
Make toc.max.depth an integer
```
Norman Walsh: callout.graphics.path.xml
```
Point to web by default
```
Norman Walsh: autolabel.elements.xml; hyphenate.xml; callout.graphics.number.limit.xml; la⋯
```
Updated parameters
```
Norman Walsh: draft.mode.xml; column.count.back.xml; page.height.portrait.xml; title.margi⋯
```
Checkpoint: the FO stylesheets do not even come close to working yet
```
Norman Walsh: graphicsize.extension.xml; default.image.width.xml; admon.default.titles.xml⋯
```
Documenting more parameters.
```
Norman Walsh: annotation.graphic.open.xml; annotation.graphic.close.xml
```
Parameterize annotation graphics
```
Norman Walsh: refentry.separator.xml; keep.relative.image.uris.xml
```
Switch to using /params
```
Norman Walsh: profile.conformance.xml; xref.label-page.separator.xml; autotoc.label.separa⋯
```
Parameters
```

Tools

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

Norman Walsh: prettyprint.xsl; identity.xsl
```
Make chapter labels print correctly
```
Norman Walsh: writetests.xsl; xsl2db.xsl
```
Updates
```
Norman Walsh: params.xsl
```
Generate params.xsl
```
Norman Walsh: tohtml.xsl; writetests.xsl; assembletests.xsl
```
Random checkpoint
```
Norman Walsh: xsl2book.xsl; formattests.xsl; writetests.xsl; doccheck.xsl; xsl2db.xsl
```
Convert to the official DocBook V5.0 namespace
```
Norman Walsh: formattests.xsl
```
Snapshot; more hacking
```

Norman Walsh: writetests.xsl

Checkpoint: it compiles, but I don't promise anything else :-)

Norman Walsh: writetests.xsl

Unit tests now work with Saxon 8.4 (patched)

Norman Walsh: doccheck.xsl
```
More documentation updates
```
Norman Walsh: writetests.xsl
```
Initial checkin
```

Norman Walsh: doccheck.xsl; expand.xsl

Extracted expand mode into a separate stylesheet

Norman Walsh: doccheck.xsl

The name attribute matters even on templates that have a match attribute

Norman Walsh: doccheck.xsl
```
Checkpoint
```

Norman Walsh: xsl2db.xsl

Change techniques so there aren't so many spurious namespace declarations

Norman Walsh: xsl2book.xsl
```
Convert the whole stylesheet to a book
```

Norman Walsh: xsl2db.xsl

Handle defaults for template parameters; handle multiple declarations of the same function name a little better

Norman Walsh: xsl2db.xsl

Generate documentation from a stylesheet

Norman Walsh: doccheck.xsl
```
Updates; documentation and bug fixes
```

Norman Walsh: doccheck.xsl

Check documentation; every mode, named template, and function will have some

Extensions

The following changes have been made to the extensions code since the 0.0 release.

Michael(tm) Smith: .cvsignore
```
Ignore jar file.
```

Michael(tm) Smith: Makefile

Revised extensions top-level makefile to call ant on build.xml and
copy jar up to top level of extensions subdir.

Norman Walsh: saxon/build.xml; .cvsignore; build.xml; saxon/.cvsignore; saxon/Makefile
```
Updated build process to use ant at the top level
```
Norman Walsh: saxon/src/net/sf/docbook/saxon/ImageIntrinsics.java
```
Fix JavaDoc comment; support image URIs
```

Michael(tm) Smith: .cvsignore; Makefile; saxon/Makefile

Added makefiles for building DocBook Java XSLT 2 extensions for Saxon 8.

Norman Walsh: saxon/src/net/sf; saxon/src; saxon/src/net/sf/docbook/saxon; saxon/build.xml⋯
```
Snapshot; more hacking
```