--- /dev/null
+Changes since the 1.72.0 release
+
+Note: This document lists changes only since the 1.72.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/xsl
+ svn log --xml --verbose xsl > ChangeHistory.xml
+
+------------------------------------------------------------------------------
+
+Table of Contents
+
+Release Notes: 1.73.2
+
+ Gentext
+ Common
+ FO
+ HTML
+ Manpages
+ HTMLHelp
+ Eclipse
+ JavaHelp
+ Roundtrip
+ Slides
+ Website
+ Params
+ Highlighting
+ Profiling
+ Lib
+ Tools
+ Template
+ Extensions
+ XSL-Java
+ XSL-Saxon
+ XSL-Xalan
+
+Release Notes: 1.73.2
+
+The following is a list of changes that have been made since the 1.72.0
+release.
+
+Gentext
+
+The following changes have been made to the gentext code since the 1.72.0
+release.
+
+ * Mauritz Jeanson: locale/de.xml
+
+ Applied patch #1766009.
+
+ * Michael(tm) Smith: locale/lv.xml
+
+ Added localization for ProductionSet.
+
+ * Michael(tm) Smith: locale/lv.xml; Makefile
+
+ Added Latvian localization file, from Girts Ziemelis.
+
+ * Robert Stayton: xsl/xsl.xsl
+
+ Add comment explaining %t etc.
+
+ * Dongsheng Song: locale/zh_cn.xml
+
+ Brought up to date with en.xml in terms of items. A few strings marked for translation.
+
+ * Dongsheng Song: locale/eo.xml
+
+ Remove svn:executable property from xml files.
+
+ * Jirka Kosek: locale/cs.xml
+
+ Added missing translations
+
+ * Robert Stayton: locale/eo.xml
+
+ New locale for Esperanto.
+
+ * Robert Stayton: locale/mn.xml
+
+ Update from Ganbold Tsagaankhuu.
+
+ * Jirka Kosek: locale/en.xml; locale/cs.xml
+
+ Rules for normalizing glossary entries before they are sorted can be now different for each language.
+
+ * Robert Stayton: locale/Auditlocale.pl
+
+ Fix context comparison bug.
+
+ * Norman Walsh: locale/sr.xml
+
+ Fix broken locale: you can't have a comment in a start tag
+
+ * Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
+
+ Committed changes from Milo Komarevi to Serbian files.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Jirka Kosek: xsl/xsl.xsl
+
+ Changed variable expression assignment from RTF to node set, so boolean tests work correctly.
+
+ * Jirka Kosek: xsl/xsl.xsl
+
+ Empty translation in gentext is copied to target locale file (it is not replaced by English variant).
+
+ * Michael(tm) Smith: xsl/xsl.xsl
+
+ Refined gentext build so that transform of gentext sources to
+ output is same whether generated by xsltproc or saxon.
+
+ * Jirka Kosek: locale/en.xml; locale/cs.xml
+
+ Added support for formatting biblioentries according to ISO690 citation style.
+ New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
+ The code was provided by Jana Dvorakova
+
+ * Robert Stayton: locale/ja.xml
+
+ Fix chapter in context xref-number-and-title
+
+ * Robert Stayton: locale/it.xml
+
+ Improved version from contributor.
+
+ * Mauritz Jeanson: locale/uk.xml
+
+ Applied patch 1592083.
+
+Common
+
+The following changes have been made to the common code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: stripns.xsl
+
+ Reverted stripns.xsl to not rely on message-logging template.
+ Thanks to Ville-Pekka Vainio, whose testing with Moin/4suite
+ exposed a problem this caused.
+
+ * Michael(tm) Smith: charmap.xsl
+
+ Set keywords on a number of files.
+
+ * Michael(tm) Smith: l10n.xml
+
+ Added Latvian locale
+
+ * Michael(tm) Smith: charmap.xsl
+
+ Fixed typo.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Mark up PIs with tag@class=xmlpi so that they can get picked up an
+ formatted correctly by the doc build.
+
+ * Michael(tm) Smith: .cvsignore; Makefile
+
+ Added Latvian localization file, from Girts Ziemelis.
+
+ * Michael(tm) Smith: charmap.xsl
+
+ Moved charmap templates out of lib.xweb and into
+ common/charmap.xsl, and added charmap doc to doc build.
+
+ * Michael(tm) Smith: utility.xsl
+
+ Fixed typo.
+
+ * Michael(tm) Smith: refentry.xsl; utility.xsl; table.xsl; common.xsl
+
+ Make all common stylesheets with embedded doc valid against our
+ litprog grammar.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Make pi.xsl files valid against our litprog grammar.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Make PI source files valid against our litprog schema.
+
+ * Michael(tm) Smith: labels.xsl
+
+ Changed handling of reference auto-labeling such that reference
+ (when it appears at the component level) is now affected by the
+ label.from.part param, just as preface, chapter, and appendix.
+
+ * Michael(tm) Smith: refentry.xsl; utility.xsl; common.xsl
+
+ Updated embedded doc in XSL source files:
+
+ - added dbhtml@dir PIs to control where output goes when
+ generation HTML version of docs
+
+ - put xml:id instances on root elements of embedded doc
+
+ - changed all *info instances to just info (DocBook 5) and some
+ @id instance to @xml-id
+
+ * Michael(tm) Smith: .cvsignore
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: common.xsl; pi.xsl
+
+ Added doc for the dbchoice choice PI, and fixes some problems with
+ the db* start PI handling.
+
+ * Michael(tm) Smith: common.xsl; pi.xsl
+
+ Added embedded documentation on the following PIs:
+
+ - dbhtml_start
+ - dbfo_start
+ - dbtex_delims
+ - dbtimestamp
+
+ * Michael(tm) Smith: utility.xsl
+
+ Made minor editorial change to embedded doc for utility templates.
+
+ * Michael(tm) Smith: Makefile
+
+ Set XJPARSEFLAGS = -E 0 -w for xsl/common build too.
+
+ * Michael(tm) Smith: Makefile
+
+ For docbook-xsl builds, feed xjparse the -EO and -w switches.
+ -E0
+ suppresses the "Parse succeeded... with no errors and no warnings"
+ messages that xjparse (actually, the XML Commons resolver)
+ otherwise emits.
+ -w
+ cause xjparse/resolver to only do a well-formedness check,
+ instead of trying to do validation; the reason for adding this
+ is that xjparse gets run against what are now doctype-less,
+ namespaced DocBook instances (after recent changes to the
+ build) and fails to validate those (because they don't have a
+ doctype)
+ What we really need to do long-term is replace xjparse with a
+ better, RELAXNG-aware validation mechanism, so that we can have
+ the build properly validate stuff that it should be checking.
+ That maybe amounts to making an "xslt" wrapper tool that either
+ calls jing or rnv (depending on what the builder wants to use).
+
+ But for now we'll need to tolerate that fact that xjparse isn't
+ doing anything more for us than just simply WF checking...
+
+ * Michael(tm) Smith: common.xsl
+
+ Added support to the HTML stylesheets for proper processing of
+ orgname as a child of author.
+
+ * Michael(tm) Smith: targets.xsl; utility.xsl; titles.xsl; pi.xsl;
+ subtitles.xsl; table.xsl;
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: Makefile
+
+ Added -E0 switch to default xjparse options, in order to suppress
+ "Parse succeeded... with no errors and no warnings." messages.
+ Thanks Norm for letting me know which flag to set.
+
+ * Michael(tm) Smith: refentry.xsl; subtitles.xsl; labels.xsl; utility.xsl;
+ titles.xsl; table
+
+ Added IDs in a bunch of places in embedded template docs that
+ could use them.
+
+ * Michael(tm) Smith: stripns.xsl; utility.xsl; common.xsl
+
+ Moved logging template and related templates to separate
+ utility.xsl file so that can be imported without importing the
+ whole common.xsl file (which is necessary for the build and for
+ using the logging template in standalone namespace-stripping
+ because the common.xsl file assumes it will be imported along with
+ all the params, which it can't be when building lib.xsl).
+
+ * Michael(tm) Smith: stripns.xsl; common.xsl
+
+ Updated stylesheets to use common logging template to log messages
+ emitted during namespace-stripping.
+ Also, moved pad-string template from lib to common because
+ it's needed in order to use logging template in the profiling
+ stylesheets, and the lib build relies on the profiling apparatus
+ (so the profiling apparatus can't rely on lib being built first...)
+
+ * Michael(tm) Smith: .cvsignore
+
+ svn-ignore newly add eo.xml file
+
+ * Michael(tm) Smith: entities.ent
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Michael(tm) Smith: refentry.xsl
+
+ Refined logging output of refentry metadata-gathering template;
+ for some cases of "missing" elements (refmiscinfo stuff, etc.),
+ the log messages now include URL to corresponding page in the
+ Definitive Guide (TDG).
+
+ * Michael(tm) Smith: common.xsl
+
+ Improved general logging template to parameterize some parts that
+ were hardcoded previously.
+
+ * Robert Stayton: l10n.xml; Makefile
+
+ Add eo.xml Esperanto.
+
+ * Robert Stayton: entities.ent
+
+ Add xmlns:xsl declaration to elements in entities.
+
+ * Jirka Kosek: entities.ent
+
+ Rules for normalizing glossary entries before they are sorted can be now different for each language.
+
+ * Robert Stayton: titles.xsl
+
+ fix caption plus title in cals table producing double caption.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Robert Stayton: table.xsl
+
+ Fix bug 1668629 valign on tbody not inherited.
+
+ * Robert Stayton: titles.xsl
+
+ Add refsection/info/title support.
+
+ * Michael(tm) Smith: titles.xsl
+
+ Added support for correct handling of xref to elements that
+ contain info/title descendants but no title children.
+
+ This should be further refined so that it handles any *info
+ elements. And there are probably some other places where similar
+ handling for *info/title should be added.
+
+ * Michael(tm) Smith: refentry.xsl
+
+ Updated copyright notices.
+
+ * Mauritz Jeanson: pi.xsl
+
+ Modified <xsl:when> in datetime.format template to work
+ around Xalan bug.
+
+FO
+
+The following changes have been made to the fo code since the 1.72.0 release.
+
+ * Michael(tm) Smith: highlight.xsl
+
+ Set keywords on a number of files.
+
+ * Mauritz Jeanson: footnote.xsl
+
+ Fixed typo (introduced by me in r6773). Closes bug #1778340.
+
+ * Mauritz Jeanson: table.xsl
+
+ Modified the tgroup template so that, for tables with multiple tgroups,
+ a width attribute is output on all corresponding fo:tables. Previously,
+ there was a test prohibiting this (and a comment saying that outputting more
+ than one width attribute will cause an error). But this seems to be no longer
+ relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.
+
+ * Mauritz Jeanson: graphics.xsl
+
+ Replaced useless <a> elements with warning messages (textinsert extension).
+
+ * Mauritz Jeanson: admon.xsl
+
+ Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
+ references in the index can be created. Closes bug #1775086.
+
+ * Mauritz Jeanson: pi.xsl
+
+ Fixed typo.
+
+ * Mauritz Jeanson: pi.xsl
+
+ Added missing equals sign (dbfo-need).
+
+ * Michael(tm) Smith: pi.xsl
+
+ Mark up PIs with tag@class=xmlpi so that they can get picked up an
+ formatted correctly by the doc build.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Shortened some refpurpose text for embedded doc for PIs.
+
+ * Michael(tm) Smith: table.xsl
+
+ Make fo/table.xsl file valid against our litprog schema.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Make pi.xsl files valid against our litprog grammar.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Make PI source files valid against our litprog schema.
+
+ * Michael(tm) Smith: param.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Robert Stayton: component.xsl
+
+ Add parameters to the page.sequence utility template.
+
+ * Michael(tm) Smith: Makefile
+
+ Make sure that *template.xml files under version control don't get
+ removed when we clean.
+
+ * Michael(tm) Smith: table.xsl
+
+ Updated embedded doc in XSL source files:
+
+ - added dbhtml@dir PIs to control where output goes when
+ generation HTML version of docs
+
+ - put xml:id instances on root elements of embedded doc
+
+ - changed all *info instances to just info (DocBook 5) and some
+ @id instance to @xml-id
+
+ * Michael(tm) Smith: param.xweb
+
+ Changed url for page.png
+
+ * Mauritz Jeanson: xref.xsl
+
+ Added template for xref to area/areaset.
+ Part of fix for bug #1675513 (xref to area broken).
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore intermediate params file.
+
+ * Michael(tm) Smith: .cvsignore; Makefile
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: lists.xsl
+
+ Added doc for the dbchoice choice PI, and fixes some problems with
+ the db* start PI handling.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Added embedded documentation on the following PIs:
+
+ - dbhtml_start
+ - dbfo_start
+ - dbtex_delims
+ - dbtimestamp
+
+ * Michael(tm) Smith: pi.xsl
+
+ made some cleanup to the fo/pi.xsl params doc. Also fixed a couple
+ typos.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Added TCG links and param links to embedded doc of FO PIs. This
+ completes the work on adding this doc for the FO stylesheets.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Made minor editorial to embedded documentation.
+
+ * Michael(tm) Smith: verbatim.xsl
+
+ Made the following changed in the mode="hyphenate.verbatim" template:
+ - <xsl:apply-templates select="node()|@*" mode="hyphenate.verbatim"/>
+ + <xsl:copy-of select="@*"/>
+ + <xsl:apply-templates mode="hyphenate.verbatim"/>
+ ...because as was it caused xsltproc to raise a fatal "Attribute
+ nodes must be added before any child nodes to an element." (though
+ not saxon)
+
+ * Michael(tm) Smith: lists.xsl; titlepage.xsl; formal.xsl; graphics.xsl;
+ qandaset.xsl; gloss
+
+ Consolidated processing of all FO PIs into wrapper templates in
+ one place (the fo/pi.xsl file) and added embedded documentation
+ for all of them. This makes it possible to now include generated
+ documentation for the PIs in the output docs. Next stop: HTML PIs,
+ then on to the common ones...
+
+ This touched a lot of files and it is likely that I made some
+ mistakes in moving the PI processing over. Meaning that some PIs
+ might quit working or not work as expected after this change. So
+ it will need to tested. Which is why we do dot-zero releases...
+
+ * Michael(tm) Smith: param.xweb
+
+ Added an ID on mediaobject that illustrates FO page regions, so
+ that the ID can get picked up and used as the filename for the
+ "long description" chunk for that mediaobject in HTML output.
+
+ * Mauritz Jeanson: lists.xsl
+
+ Fixed bug #1711508.
+
+ * Michael(tm) Smith: division.xsl; toc.xsl; biblio-iso690.xsl; block.xsl;
+ graphics.xsl; html
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Norman Walsh: graphics.xsl
+
+ URIs that start with '/' are absolute too
+
+ * Robert Stayton: xep.xsl
+
+ Whitespace adjustment.
+
+ * Michael(tm) Smith: docbook.xsl; table.xsl
+
+ Moved logging template and related templates to separate
+ utility.xsl file so that can be imported without importing the
+ whole common.xsl file (which is necessary for the build and for
+ using the logging template in standalone namespace-stripping
+ because the common.xsl file assumes it will be imported along with
+ all the params, which it can't be when building lib.xsl).
+
+ * Michael(tm) Smith: docbook.xsl
+
+ Updated stylesheets to use common logging template to log messages
+ emitted during namespace-stripping.
+ Also, moved pad-string template from lib to common because
+ it's needed in order to use logging template in the profiling
+ stylesheets, and the lib build relies on the profiling apparatus
+ (so the profiling apparatus can't rely on lib being built first...)
+
+ * Michael(tm) Smith: inline.xsl
+
+ Added template match for person element to fo stylesheet.
+
+ * Michael(tm) Smith: param.xweb
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Mauritz Jeanson: fo-patch-for-fop.xsl
+
+ fo-patch-for-fop.xsl deleted (obsolete).
+
+ * Robert Stayton: docbook.xsl
+
+ Changed the comments regarding namespace striping to
+ mention the docbook5 namedspaced stylesheets.
+
+ * Robert Stayton: lists.xsl
+
+ Removed old varlistentry accidentally left in.
+
+ * Robert Stayton: lists.xsl
+
+ Added support for spacing="compact" in variablelist, per bug report #1722540.
+
+ * Robert Stayton: table.xsl
+
+ table pgwide="1" should also use pgwide.properties attribute-set.
+
+ * Mauritz Jeanson: inline.xsl
+
+ Make citations numbered if bibliography.numbered != 0.
+
+ * Robert Stayton: table.xsl
+
+ Fixed bug in handling of columns width sum.
+
+ * Robert Stayton: callout.xsl
+
+ Fixed missing quote.
+
+ * Robert Stayton: callout.xsl
+
+ Changed param name to callout.icon.size
+
+ * Robert Stayton: param.xweb; param.ent
+
+ Add new profiling parameters for audience and wordsize.
+
+ * Robert Stayton: callout.xsl
+
+ line break fix
+
+ * Robert Stayton: callout.xsl
+
+ Add callout.icon.size parameter.
+
+ * Robert Stayton: param.xweb; param.ent
+
+ Added callout.icon.size parameter.
+
+ * Robert Stayton: inline.xsl; xref.xsl
+
+ Add support for xlink as olink.
+
+ * Mauritz Jeanson: footnote.xsl
+
+ Fixed bug #1669601.
+
+ * Robert Stayton: pagesetup.xsl
+
+ set.flow.properties now strips '-draft' from master name before tests.
+
+ * Robert Stayton: autotoc.xsl; param.xweb; param.ent
+
+ Add support for qanda.in.toc to fo TOC.
+
+ * Robert Stayton: component.xsl
+
+ Improved the page.sequence utility template for use with book.
+
+ * Robert Stayton: division.xsl
+
+ Use named templates for front and back cover templates.
+
+ * Robert Stayton: division.xsl
+
+ Refactored the big book template into smaller pieces.
+ Used the "page.sequence" utility template in
+ component.xsl to shorten the toc piece.
+ Added placeholder templates for front.cover and back.cover.
+
+ * Jirka Kosek: glossary.xsl
+
+ Rules for normalizing glossary entries before they are sorted can be now different for each language.
+
+ * Jirka Kosek: sections.xsl
+
+ use-attribute-sets is used without prefix on XSLT elements
+
+ * Robert Stayton: component.xsl
+
+ Adjust whitespace.
+
+ * Robert Stayton: param.xweb; param.ent; sections.xsl
+
+ Add section.container.element parameter to enable
+ pgwide spans inside sections.
+
+ * Robert Stayton: param.xweb; param.ent; component.xsl
+
+ Add component.titlepage.properties attribute-set to
+ support span="all" and other properties.
+
+ * Mauritz Jeanson: inline.xsl
+
+ Fixed #1680755 (keycombo joinchar default incorrect).
+
+ * Mauritz Jeanson: lists.xsl
+
+ Corrected typo in calloutlist template.
+
+ * Robert Stayton: lists.xsl
+
+ Fix number test in termlength when NaN.
+
+ * Robert Stayton: htmltbl.xsl; table.xsl
+
+ Apply table.row.properties template to html tr rows too.
+ Add keep-with-next to table.row.properties when row is in thead.
+
+ * Jirka Kosek: math.xsl
+
+ MathML must be surrounded by fo:instream-foreign-object
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Robert Stayton: param.xweb; param.ent
+
+ Add default.table.frame parameter to fo too.
+
+ * Robert Stayton: table.xsl
+
+ Add support for default.table.frame parameter.
+ Fix bug 1575446 rowsep last check for @morerows.
+
+ * Robert Stayton: refentry.xsl
+
+ Add support for info/title in refsections.
+
+ * Robert Stayton: xref.xsl
+
+ Fixed bug 1652360 empty link with xlink:href.
+
+ * Michael(tm) Smith: Makefile
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * David Cramer: qandaset.xsl
+
+ Make fo questions and answers behave the same way as html
+
+ * Jirka Kosek: lists.xsl
+
+ Added missing attribute set for procedure
+
+ * Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
+ biblio-iso690.xsl
+
+ Added support for formatting biblioentries according to ISO690 citation style.
+ New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
+ The code was provided by Jana Dvorakova
+
+ * Robert Stayton: param.xweb; param.ent; pagesetup.xsl
+
+ Add header.table.properties and footer.table.properties attribute-sets.
+
+ * Robert Stayton: inline.xsl
+
+ Add fop1.extensions for menuchoice arrow handling exception.
+
+ * Robert Stayton: pagesetup.xsl
+
+ Fixed master-name used in axf crop mark template call.
+
+ * Robert Stayton: autotoc.xsl
+
+ Moved the end-indent properties from toc.line to the
+ toc.line.properties attribute-set.
+
+ * Michael(tm) Smith: param.xweb
+
+ Updated copyright notices.
+
+HTML
+
+The following changes have been made to the html code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: highlight.xsl
+
+ Set keywords on a number of files.
+
+ * Mauritz Jeanson: titlepage.xsl
+
+ Added <xsl:call-template name="process.footnotes"/> to abstract template
+ so that footnotes in info/abstract are processed. Closes bug #1760907.
+
+ * Michael(tm) Smith: pi.xsl; synop.xsl
+
+ Changed handling of HTML output for the cmdsynopsis and
+ funcsynopsis elements, such that a@id instances are generated for
+ them if they are descendants of any element containing a dbcmdlist
+ or dbfunclist PI. Also, update the embedded reference docs for the
+ dbcmdlist and dbfunclist PIs to make it clear that they can be
+ used within any element for which cmdsynopsis or funcsynopsis are
+ valid children.
+
+ * Michael(tm) Smith: formal.xsl
+
+ Reverted the part of revision 6952 that caused a@id anchors to be
+ generated for output of informal objects. Thanks to Sam Steingold
+ for reporting.
+
+ * Robert Stayton: glossary.xsl
+
+ Account for a glossary with no glossdiv or glossentry children.
+
+ * Mauritz Jeanson: titlepage.xsl
+
+ Modified legalnotice template so that the base.name parameter is calculated
+ in the same way as for revhistory chunks. Using <xsl:apply-templates
+ mode="chunk-filename" select="."/> did not work for single-page output since
+ the template with that mode is in chunk-code.xsl.
+
+ * Mauritz Jeanson: graphics.xsl
+
+ Updated support for SVG (must be a child of imagedata in DB 5).
+ Added support for MathML in imagedata.
+
+ * Mauritz Jeanson: pi.xsl
+
+ Fixed typo.
+
+ * Mauritz Jeanson: inline.xsl
+
+ Fixed typo in tests for @xlink:title.
+
+ * Mauritz Jeanson: pi.xsl
+
+ Added documentation for the dbhh PI (used for context-sensitive HTML Help).
+ (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).
+
+ * Mauritz Jeanson: pi.xsl
+
+ Corrected synopsis of dbhtml-include PI.
+
+ * Mauritz Jeanson: docbook.xsl; highlight.xsl
+
+ Replaced <font> with <span> and/or inline styles. This fixes the problem with <span class="ERROR">
+ in XHTML (and <font> is deprecated anyway). Closes bug #1715774.
+
+ * Michael(tm) Smith: titlepage.xsl
+
+ Fixed test for abstract.notitle.enabled. The way I had it, it was
+ having an effect opposite to its documented effect; that is, it
+ was generating an abstract title only if abstract.notitle.enabled
+ was not zero; but it should actually generate the title only if
+ abstract.notitle.enabled *is* zero. Thanks to Marie Sauvage for
+ testing and reporting this very quickly after 1.73.0 was released.
+
+ * Michael(tm) Smith: xref.xsl; pi.xsl
+
+ Mark up PIs with tag@class=xmlpi so that they can get picked up an
+ formatted correctly by the doc build.
+
+ * Mauritz Jeanson: param.xweb; param.ent
+
+ Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
+ regular "parameter machinery".
+
+ * Michael(tm) Smith: autotoc.xsl; chunk-common.xsl
+
+ Fixed a bug that caused broken links in some TOCs.
+ This change affects the code for generating links in HTML output.
+ It adds a new optional "toc.context" parameter to the href.target
+ template, and based on the value of that parameter, handles
+ link-generation in TOCs differently under a certain condition.
+
+ The gory details:
+
+ The code now checks to see if the output dir of any file being
+ linked to in a particular TOC is different from the output dir
+ the TOC is written to. If it is different, we do not call the
+ trim.common.uri.paths[1] template.
+
+ The reason is that, given the following case:
+
+ 1. we are chunking into separate dirs
+
+ 2. output for the TOC is written to current dir, but the file
+ being linked to is written to some subdir "foo".
+
+ For that case, links to that file in that TOC did not show
+ the correct path - they omitted the "foo".
+
+ The cause of that problem was that the trim.common.uri.paths
+ template was being called under all conditions. But it's
+ apparent that we don't want to call trim.common.uri.paths in
+ the case where a linked file is being written to a different
+ directory than the TOC that contains the link, because doing
+ so will cause a necessary (not redundant) directory-name
+ part of the link to get inadvertently trimmed, resulting in
+ a broken link to that file.
+
+ Thus, the conditional check was added to catch this case and to
+ handle it differently
+
+ [1] The purpose of the trim.common.uri.paths template is to
+ prevent cases where, if we didn't call it, we end up with
+ unnecessary, redundant directory names getting output; for
+ example, "foo/foo/refname.html".
+
+ * Michael(tm) Smith: pi.xsl
+
+ Shortened some refpurpose text for embedded doc for PIs.
+
+ * Michael(tm) Smith: admon.xsl
+
+ Changed handling of titles for note, warning, caution, important,
+ tip admonitions: We now output and HTML h3 head only if
+ admon.textlabel is non-zero or if the admonition actually contains
+ a title; otherwise, we don't output an h3 head at all.
+ (Previously, we were outputting an empty h3 if the admon.textlabel
+ was zero and if the admonition had no title.)
+
+ * Michael(tm) Smith: pi.xsl
+
+ Make pi.xsl files valid against our litprog grammar.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Make PI source files valid against our litprog schema.
+
+ * Michael(tm) Smith: param.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Michael(tm) Smith: Makefile
+
+ Make sure that *template.xml files under version control don't get
+ removed when we clean.
+
+ * Mauritz Jeanson: table.xsl
+
+ Fixed bug #1737581 (table.borders.with.css should suppress border attribute).
+
+ * Mauritz Jeanson: xref.xsl
+
+ Added template for xref to area/areaset.
+ Part of fix for bug #1675513 (xref to area broken).
+
+ * Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
+
+ Added fixes to avoid duplicate ids when generate.id.attributes = 1.
+ This (hopefully) closes bug #1671052.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore intermediate params file.
+
+ * Michael(tm) Smith: .cvsignore; Makefile
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: lists.xsl
+
+ Added doc for the dbchoice choice PI, and fixes some problems with
+ the db* start PI handling.
+
+ * Michael(tm) Smith: pi.xsl; math.xsl
+
+ Added embedded documentation on the following PIs:
+
+ - dbhtml_start
+ - dbfo_start
+ - dbtex_delims
+ - dbtimestamp
+
+ * Michael(tm) Smith: pi.xsl
+
+ made some cleanup to the fo/pi.xsl params doc. Also fixed a couple
+ typos.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Completing adding all doc for HTML PIs. Added "see also" sections
+ with links to related global params, plus links to DocBook XSL: TCG
+ Also tried out adding some additional doc to param doc for the
+ textinsert.extension param that back-references the PI
+ documentation, plus added some TCG links there too.
+
+ * Michael(tm) Smith: pi.xsl
+
+ Added doc for the dbhtml img.src.path PI.
+
+ * Michael(tm) Smith: formal.xsl; pi.xsl
+
+ Made the dbfunclist PI work as intended. Also added doc for
+ dbfunclist and dbcmdlist PIs.
+
+ * Michael(tm) Smith: pi.xsl; synop.xsl
+
+ Made the dbcmdlist work the way it appears to have been intended
+ to work. Restored dbhtml-dir template back to pi.xsl.
+
+ * Michael(tm) Smith: lists.xsl; pi.xsl
+
+ fixed WF error and removed duplicate template
+
+ * Michael(tm) Smith: graphics.xsl
+
+ Fixed WF error.
+
+ * Michael(tm) Smith: chunk-common.xsl; pi.xsl
+
+ Add x-ref links from embedded PI doc to sections in Bob's book.
+ Also, moved dbhtml-dir template to chunk-common.xsl file, because
+ it doesn't really belong in the PI file.
+
+ * Michael(tm) Smith: table.xsl; pi.xsl
+
+ Consolidated all PIs for HTML table stuff into wrapper templates
+ in the "master" pi list (html/pi.xsl) and added embedded doc for
+ all of them. May have made some flubs in copying over, so this
+ change may break some table handling.
+
+ * Michael(tm) Smith: pi.xsl; verbatim.xsl
+
+ Added a verbatim PI that I missed in last commit.
+
+ * Michael(tm) Smith: pi.xsl; synop.xsl; verbatim.xsl
+
+ Consolidated all PIs for HTML synopsis and verbatim stuff into
+ wrapper templates in the "master" pi list (html/pi.xsl) and added
+ embedded doc for all of them. May have made some flubs in copying
+ over, so this change may break some synopsis and verbatim
+ handling. Note: Also added refsee@role=params instances so that we
+ can link to the corresponding global params (if any) for each PI.
+
+ * Michael(tm) Smith: qandaset.xsl; pi.xsl
+
+ Consolidated all PIs for qandaset into wrapper templates in one
+ place (html/pi.xsl) and added embedded doc for all of them. May
+ have made some flubs in copying over, so this change may break
+ some qandaset handling.
+
+ * Michael(tm) Smith: lists.xsl; graphics.xsl; pi.xsl
+
+ Consolidated all PIs for graphics and lists into wrapper templates
+ in one place (html/pi.xsl) and added embedded doc for all of them.
+ May have made some flubs in copying over, so this change may break
+ some graphics and list handling.
+
+ * Michael(tm) Smith: chunktoc.xsl; chunk-code.xsl; pi.xsl
+
+ Initial reorganization of HTML PI processing mechanism.
+
+ * Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
+
+ Added new param abstract.notitle.enabled.
+ If non-zero, in output of the abstract element on titlepages,
+ display of the abstract title is suppressed.
+ Because sometimes you really don't want or need that title
+ there...
+
+ * Michael(tm) Smith: chunk-code.xsl; graphics.xsl
+
+ When we are chunking long descriptions for mediaobject instances
+ into separate HTML output files, and use.id.as.filename is
+ non-zero, if a mediaobject has an ID, use that ID as the basename
+ for the long-description file (otherwise, we generate an ID for it
+ and use that ID as the basename for the file).
+ The parallels the recent change made to cause IDs for legalnotice
+ instances to be used as basenames for legalnotice chunks.
+ Also, made some minor refinements to the recent changes for
+ legalnotice chunk handling.
+
+ * Michael(tm) Smith: titlepage.xsl
+
+ Added support to the HTML stylesheets for proper processing of
+ orgname as a child of author.
+
+ * Michael(tm) Smith: chunk-code.xsl
+
+ When $generate.legalnotice.link is non-zero and
+ $use.id.as.filename is also non-zero, if a legalnotice has an ID,
+ then instead of assigning the "ln-<generatedID>" basename to the
+ output file for that legalnotice, just use its real ID as the
+ basename for the file -- as we do when chunking other elements
+ that have IDs.
+
+ * Michael(tm) Smith: table.xsl; changebars.xsl; qandaset.xsl; index.xsl;
+ maketoc.xsl; glossa
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: docbook.xsl
+
+ Moved logging template and related templates to separate
+ utility.xsl file so that can be imported without importing the
+ whole common.xsl file (which is necessary for the build and for
+ using the logging template in standalone namespace-stripping
+ because the common.xsl file assumes it will be imported along with
+ all the params, which it can't be when building lib.xsl).
+
+ * Michael(tm) Smith: chunk-code.xsl; docbook.xsl
+
+ Updated stylesheets to use common logging template to log messages
+ emitted during namespace-stripping.
+ Also, moved pad-string template from lib to common because
+ it's needed in order to use logging template in the profiling
+ stylesheets, and the lib build relies on the profiling apparatus
+ (so the profiling apparatus can't rely on lib being built first...)
+
+ * Michael(tm) Smith: db5strip.xsl
+
+ Removed the db5strip.xsl stylesheet because it has been obsoleted
+ by the stripns.xsl stylesheet.
+
+ * Michael(tm) Smith: inline.xsl; autoidx-kimber.xsl; biblio-iso690.xsl;
+ autoidx-kosek.xsl; p
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * David Cramer: xref.xsl
+
+ Handle alt text on xrefs to steps when the step doesn't have a title.
+
+ * David Cramer: lists.xsl
+
+ Added <p> element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output
+
+ * David Cramer: qandaset.xsl
+
+ Added <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output
+
+ * David Cramer: lists.xsl
+
+ Added <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output
+
+ * Robert Stayton: footnote.xsl
+
+ Fixed bug #1717196 footnoteref not finding the right chunk for the target.
+
+ * Robert Stayton: chunk-code.xsl; docbook.xsl
+
+ Changed the comments regarding namespace striping to
+ mention the docbook5 namedspaced stylesheets.
+
+ * Mauritz Jeanson: inline.xsl
+
+ Make citations numbered if bibliography.numbered != 0.
+
+ * Robert Stayton: param.xweb; param.ent
+
+ Add support for new profiling attributes audience and wordsize.
+
+ * Robert Stayton: inline.xsl; xref.xsl
+
+ Add support for xlink olinks.
+
+ * Mauritz Jeanson: titlepage.xsl
+
+ Fixed bug #1644874.
+
+ * Jirka Kosek: xref.xsl
+
+ Do not output xlink namespace declaration into HTML output
+
+ * Jirka Kosek: profile-chunk.xsl
+
+ Sync profiling stylesheet with base stylesheet
+
+ * Jirka Kosek: glossary.xsl
+
+ Rules for normalizing glossary entries before they are sorted can be now different for each language.
+
+ * Robert Stayton: inline.xsl
+
+ Fix a couple of class attributes.
+
+ * Robert Stayton: titlepage.xsl
+
+ Remove redundant ./ from xpath statements.
+
+ * Mauritz Jeanson: inline.xsl
+
+ Fixed #1680755 (keycombo joinchar default incorrect).
+
+ * Mauritz Jeanson: lists.xsl
+
+ Corrected typo in calloutlist template.
+
+ * Robert Stayton: formal.xsl
+
+ Set formal object class value with class.value mode.
+
+ * Robert Stayton: graphics.xsl
+
+ Fix bug in contentdepth outputting empty height attribute.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
+
+ Refactored the chunking modules to move all named templates to
+ chunk-common.xsl and all match templates to chunk-code.xsl, in
+ order to enable better chunk customization.
+ See the comments in chunk.xsl for more details.
+
+ * Robert Stayton: lists.xsl
+
+ Add anchor for xml:id for listitem in varlistentry.
+
+ * Robert Stayton: refentry.xsl
+
+ Add support for info/title in refsections for db5.
+
+ * Robert Stayton: xref.xsl
+
+ Fixed bug 1652360 empty link with xlink:href.
+
+ * Robert Stayton: changebars.xsl
+
+ Add underline style to "added".
+
+ * Michael(tm) Smith: Makefile
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
+ biblio-iso690.xsl
+
+ Added support for formatting biblioentries according to ISO690 citation style.
+ New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
+ The code was provided by Jana Dvorakova
+
+ * Robert Stayton: callout.xsl; glossary.xsl; annotations.xsl; autoidx.xsl;
+ footnote.xsl
+
+ Add call to class.attribute on output <a>.
+
+ * Robert Stayton: inline.xsl; xref.xsl
+
+ Add call to class.attribute to <a> output elements so they can
+ have a class value too.
+
+ * Robert Stayton: html.xsl
+
+ Add mode=class.value to generate just the value, not the attribute.
+
+ * Michael(tm) Smith: param.xweb
+
+ Updated copyright notices.
+
+ * Mauritz Jeanson: glossary.xsl
+
+ Fixed bug #1644881:
+ * Added curly braces around all $language attribute values.
+ * Moved declaration of language variable to top level of stylesheet.
+ Tested with Xalan, Saxon, and xsltproc.
+
+Manpages
+
+The following changes have been made to the manpages code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: endnotes.xsl
+
+ In manpages output, generate warnings about notesources with
+ non-para children only if the notesource is a footnote or
+ annotation. Thanks to Sam Steingold for reporting problems with
+ the existing handling.
+
+ * Michael(tm) Smith: synop.xsl
+
+ Made italic handling of
+
+ * Michael(tm) Smith: table.xsl
+
+ Problem:
+ Rows in tables with more than 10 rows get sorted into incorrect
+ order.
+ Cause:
+ Code in manpages table handler does sorting, using xsl:sort, to
+ deal with instances of cells that span multiple rows. But that
+ sorting was being done alphabetically rather than numerically --
+ the reason being that the default sort method for xsl:sort is
+ "text" (alphabetical).
+ Fix:
+ Added @data-type=number to relevant xsl:sort instances in table
+ code.
+
+ Closes #1763332. Thanks to kesuke.
+
+ * Michael(tm) Smith: docbook.xsl
+
+ Added import of common/charmap.xsl to fix problem of calls to
+ missing named templates. Closes #1760697. Thanks to Daniel
+ Leidert.
+
+ * Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
+
+ Added the man.authors.section.enabled and
+ man.copyright.section.enabled parameters. Set those to zero when
+ you want to suppress display of the auto-generated AUTHORS and
+ COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
+ Leidert.
+
+ * Michael(tm) Smith: info.xsl
+
+ Fixed minor typo.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: param.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore intermediate params file.
+
+ * Michael(tm) Smith: Makefile; .cvsignore
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: docbook.xsl
+
+ Took the test that the manpages stylesheet does to see if there
+ are any Refentry chilren in current doc, and made it
+ namespace-agnostic. Reason for that is because the test otherwise
+ won't work when it is copied over into the generated
+ profile-docbook.xsl stylesheet.
+
+ * Michael(tm) Smith: Makefile
+
+ Added a manpages/profile-docbook.xsl file to enable single-pass
+ profiling for manpages output. KNOWN ISSUE: Single-pass namespace
+ stripping does not yet work in combination with the
+ manpages/profile-docbook.xsl stylesheet.
+
+ * Michael(tm) Smith: param.xweb
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: info.xsl
+
+ Output copyright and legalnotice in man-page output in whatever
+ place they are in in document order. Closes #1690539. Thanks to
+ Daniel Leidert for reporting.
+
+ * Michael(tm) Smith: docbook.xsl
+
+ Restored support for single-pass namespace stripping to manpages
+ stylesheet.
+
+ * Michael(tm) Smith: docbook.xsl; other.xsl
+
+ Added check to have the manpages stylesheet log/emit an error
+ message if it is given a namespaced DocBook document, with
+ instructions to instead either use the docbook5-xsl stylesheets to
+ directly process the document, or to use the stripns.xsl
+ stylesheet to pre-process it.
+
+ * Michael(tm) Smith: param.xweb
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Michael(tm) Smith: table.xsl; endnotes.xsl; other.xsl
+
+ Updated manpages logging to work with new-and-improved logging
+ template.
+
+ * Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;
+ endnotes.xsl; ut
+
+ Changed handling of bold and italic/underline output in manpages
+ output. Should be transparent to users, but...
+
+ This touches handling of all bold and italic/underline output. The
+ exact change is that the mode="bold" and mode="italic" utility
+ templates were changed to named templates. (I think maybe I've
+ changed it back and forth from mode to named before, so this is
+ maybe re-reverting it yet again).
+
+ Anyway, the reason for the change is that the templates are
+ sometimes call on dynamically node-sets, and using modes to format
+ those doesn't allow passing info about the current/real context
+ node from the source (not the node-set created by the stylesheet)
+ to that formatting stage.
+
+ The named templates allow the context to be passed in as a
+ parameter, so that the bold/ital formatting template can use
+ context-aware condition checking.
+
+ This was basically necessary in order to suppress bold formatting
+ in titles, which otherwise gets screwed up because of the numbnut
+ way that roff handles nested bold/ital.
+
+ Closes #1674534). Much thanks to Daniel Leidert, whose in his
+ docbook-xsl bug-finding kung-fu has achieved Grand Master status.
+
+ * Michael(tm) Smith: block.xsl
+
+ Fixed handling of example instances by adding the example element
+ to the same template we use for processing figure. Closes
+ #1674538. Thanks to Daniel Leidert.
+
+ * Michael(tm) Smith: utility.xsl
+
+ Don't include lang in manpages filename/pathname if lang=en (that
+ is, only generate lang-qualified file-/pathnames for non-English).
+
+ * Michael(tm) Smith: endnotes.xsl
+
+ In manpages output, emit warnings for notesources (footnote, etc.)
+ that have something other than para as a child.
+
+ The numbered-with-hanging-indent formatting that's used for
+ rendering endnotes in the NOTES section of man pages places some
+ limits/assumptions on how the DocBook source is marked up; namely,
+ for notesources (footnote, annotation, etc.) that can contain
+ block-level children, if the they have a block-level child such as
+ a table or itemizedlist or orderedlist that is the first child of
+ a footnote, we have no way of rendering/indenting its content
+ properly in the endnotes list.
+
+ Thus, the manpages stylesheet not emits a warning message for that
+ case, and suggests the "fix" (which is to wrap the table or
+ itemizedlist or whatever in a para that has some preferatory text.
+
+ * Michael(tm) Smith: utility.xsl
+
+ Added support to mixed-block template for handling tables in
+ mixed-blocks (e.g., as child of para) correctly.
+
+ * Michael(tm) Smith: endnotes.xsl
+
+ Added comment to endnotes code.
+
+ * Michael(tm) Smith: endnotes.xsl
+
+ Normalize text-only endnotes properly.
+
+ * Michael(tm) Smith: utility.xsl
+
+ Fixed problem with lang values not getting added to filenames as
+ expected for all cases. Closes #1674564. Thanks to Daniel Leidert
+ for reporting.
+
+ * Michael(tm) Smith: param.xweb; param.ent; other.xsl; utility.xsl
+
+ Made some minor updates to param docs and comments in
+ manpages stylesheet. Also, removed some params for
+ manpages doc that are already doc'ed as HTML params.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;
+ refentry.xsl; end
+
+ Reverted necessary escaping of backslash, dot, and dash
+ out of the well-intentioned (but it now appears,
+ misguided) "marker" mechanism (introduced in the 1.72.0
+ release) -- which made use of alternative "marker"
+ characters as internal representations of those
+ characters, and then replaced them just prior to
+ serialization -- and back into what's basically the
+ system that was used prior to the 1.69.0 release; that
+ is, into a part of stylesheet code that gets executed
+ at the beginning of processing -- before any other roff
+ markup up is. This change obviates the need for the
+ marker system. It also requires a lot less RAM during
+ processing (for large files, the marker mechanism
+ ending up requiring gigabytes of memory).
+
+ Closes bug #1661177. Thanks to Scott Smedley for
+ providing a test case (the fvwm man page) that exposed
+ the problem with the marker mechanism.
+
+ Also moved the mechanism for converting non-breaking
+ spaces back into the same area of the stylesheet code.
+
+ * Michael(tm) Smith: lists.xsl
+
+ Fixed problem with incorrect formatting of nested variablelist.
+ Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.
+
+ * Michael(tm) Smith: Makefile
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * Michael(tm) Smith: lists.xsl
+
+ Make sure that all listitems in itemizedlist and orderedlist are
+ preceded by a blank line. This fixes a regression that occurred
+ when instances of the TP macro that were use in a previous
+ versions of the list-handling code were switched to RS/RE (because
+ TP doesn't support nesting). TP automatically generates a blank
+ line, but RS doesn't. So I added a .sp before each .RS
+
+ * Michael(tm) Smith: endnotes.xsl; links.xsl; docbook.xsl
+
+ Renamed links.xsl to endnotes.xsl.
+
+ * Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;
+ links.xsl; param.ent
+
+ Made a number of changes related to elements with
+ out-of-line content:
+
+ - Added handling for mediaobject & inlinemedidaobject.
+ Each imagedata, audiodata, or videodata element
+ within a mediaobject or inline mediaobject is now
+ treated as a "notesource" and so handled in much the
+ same way as links and annotation/alt/footnotes.
+
+ That means a numbered marker is generated inline to
+ mark the place in the main flow where the imagedata,
+ audiodata, or videodata element occurs, and a
+ corresponding numbered endnote for it is generated in
+ the endnotes list at the end of the man page; the
+ endnote contains the URL from the fileref attribute
+ of the imagedata, audiodata, or videodata element.
+
+ For mediobject and inlinemediaobject instances that
+ have a textobject child, the textobject is displayed
+ within the main text flow.
+
+ - Renamed several man.link.* params to man.endnotes.*,
+ to reflect that fact that the endnotes list now
+ contains more than just links. Also did similar
+ renaming for a number of stylesheet-internal vars.
+
+ - Added support for xlink:href (along with existing
+ support for the legacy ulink element).
+
+ - Cleaned up and streamlined the endnotes-handling
+ code. It's still messy and klunky and the basic
+ mechanism it uses is very inefficent for documents
+ that contain a lot of notesources, but at least it's
+ a bit better than it was.
+
+ * Michael(tm) Smith: param.xweb
+
+ Updated copyright notices.
+
+HTMLHelp
+
+The following changes have been made to the htmlhelp code since the 1.72.0
+release.
+
+ * Mauritz Jeanson: htmlhelp-common.xsl
+
+ Moved the raw.help.title and help.title variables to the hhp-main template to make sure
+ a value is assigned after the namespace-stripping has been done. This prevents "Request
+ for title of element with no title" errors.
+
+ Added "//db:indexterm[1]|//ng:indexterm[1]" to the select expression of the global
+ htmlhelp.generate.index parameter, so that an index can be built for both DB 4 and
+ DB 5/NG documents (it's a little ugly, but a value needs to be assigned somehow).
+
+ * Michael(tm) Smith: htmlhelp-common.xsl
+
+ Added single-pass namespace-stripping support to the htmlhelp,
+ eclipse, and javahelp stylesheets.
+
+ * Michael(tm) Smith: Makefile
+
+ Tweaked some makefiles to bring them into consistency with other
+ makefiles in the build.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+Eclipse
+
+The following changes have been made to the eclipse code since the 1.72.0
+release.
+
+ * Mauritz Jeanson: eclipse.xsl
+
+ Added "db" and "ng" to exclude-result-prefixes.
+
+ * Michael(tm) Smith: eclipse.xsl
+
+ Added single-pass namespace-stripping support to the htmlhelp,
+ eclipse, and javahelp stylesheets.
+
+ * Michael(tm) Smith: eclipse.xsl
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: Makefile
+
+ Tweaked some makefiles to bring them into consistency with other
+ makefiles in the build.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore the eclipse generated profile stylesheet.
+
+ * Mauritz Jeanson: Makefile
+
+ Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.
+
+ * David Cramer: eclipse.xsl
+
+ Added normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. <title> Foo</title>) in the source
+
+JavaHelp
+
+The following changes have been made to the javahelp code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: javahelp.xsl
+
+ Added single-pass namespace-stripping support to the htmlhelp,
+ eclipse, and javahelp stylesheets.
+
+ * Mauritz Jeanson: javahelp.xsl
+
+ Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
+ regular "parameter machinery".
+
+ * Michael(tm) Smith: javahelp.xsl
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: Makefile
+
+ Tweaked some makefiles to bring them into consistency with other
+ makefiles in the build.
+
+ * Mauritz Jeanson: javahelp.xsl
+
+ Implemented FR #1230233 (sorted index in javahelp).
+
+ * Mauritz Jeanson: javahelp.xsl
+
+ Added normalize-space() around titles and index entries to work around whitespace problems.
+ Added support for glossary and bibliography in toc and map files.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+Roundtrip
+
+The following changes have been made to the roundtrip code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: blocks2dbk.xsl; wordml2normalise.xsl;
+ normalise2sections.xsl; sections2
+
+ Set keywords on a number of files.
+
+ * Michael(tm) Smith: pages2normalise.xsl
+
+ Removed executable property from roundtrip/pages2normalise.xsl
+ file. Thanks to Daniel Leidert for reporting.
+
+ * Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl
+
+ Modularised blocks2dbk to allow customisation,
+ Added support for tables to pages2normalise
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: param.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;
+ sections2blocks.
+
+ new stylesheets for better word processor support and easier maintenance
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore intermediate params file.
+
+ * Michael(tm) Smith: .cvsignore; Makefile
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: param.xweb; dbk2wordml.xsl; pages-normalise.xsl;
+ dbk2pages.xsl; docbook
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: param.xweb; wordml-blocks.xsl; wordml-sections.xsl
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
+
+ fixed bugs
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Michael(tm) Smith: Makefile
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * Michael(tm) Smith: param.xweb
+
+ Updated copyright notices.
+
+Slides
+
+The following changes have been made to the slides code since the 1.72.0
+release.
+
+ * Jirka Kosek: html/slides-common.xsl
+
+ Fixed wrong template name
+
+ * Michael(tm) Smith: fo/param.xweb; html/param.xweb
+
+ Made some changes to ID values in slides doc source, in order to
+ give us more rational filenames in HTML output of the docs.
+
+ * Michael(tm) Smith: fo; html; fo/.cvsignore; html/.cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: fo/param.xweb; html/param.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Michael(tm) Smith: fo/Makefile
+
+ Make sure that *template.xml files under version control don't get
+ removed when we clean.
+
+ * Michael(tm) Smith: fo; html; fo/.cvsignore; html/.cvsignore
+
+ Ignore intermediate params file.
+
+ * Michael(tm) Smith: fo; html; fo/.cvsignore; fo/Makefile; html/.cvsignore;
+ html/Makefile
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: fo/param.xweb; html/param.xweb
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: html/param.xweb; fo/param.xweb
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Michael(tm) Smith: fo/plain.xsl; Makefile; html/slides-common.xsl
+
+ Made some further adjustments to cause slides/fo and
+ slides/html param builds to work correctly.
+
+ * Michael(tm) Smith: fo; html; Makefile; fo/.cvsignore; fo/Makefile;
+ html/.cvsignore; html/M
+
+ Made changes to cause build of separate
+ slides/fo/param.xsl and slides/html/param.xsl files,
+ and updated doc build to handle that split. Also
+ updated build of ChangeLog.xml, NEWS file and
+ RELEASE-NOTES.{html,txt,pdf} builds to include slides
+ and website changes.
+ Closes bug #1671745. Thanks to Justus Piater.
+
+ * Michael(tm) Smith: Makefile; doc/Makefile; Makefile; fo/Makefile;
+ demo/frames2/Makefile; d
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Michael(tm) Smith: param.xweb; Makefile; param.ent; fo/Makefile;
+ .cvsignore; fo/plain.xsl
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * Michael(tm) Smith: graphics; browser; xsl; graphics; browser
+
+ Moved slides and website stylesheets into xsl tree. They have
+ shipped as part of xsl for the last three releases now, just been
+ getting pulled in as part of the build. Now that we're using svn,
+ it's trivial to actually move them in (and to move them back out
+ if we need to).
+
+Website
+
+The following changes have been made to the website code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: param.xweb
+
+ Put website docs into categories.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: param.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore intermediate params file.
+
+ * Michael(tm) Smith: Makefile; .cvsignore
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: xbel.xsl; website.xsl; website-common.xsl
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: param.xweb
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Michael(tm) Smith: Makefile; schema/dtd/Makefile; schema/relaxng/Makefile;
+ Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Michael(tm) Smith: Makefile; .cvsignore; param.xweb; param.ent
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * Michael(tm) Smith: xsl
+
+ Moved slides and website stylesheets into xsl tree. They have
+ shipped as part of xsl for the last three releases now, just been
+ getting pulled in as part of the build. Now that we're using svn,
+ it's trivial to actually move them in (and to move them back out
+ if we need to).
+
+Params
+
+The following changes have been made to the params code since the 1.72.0
+release.
+
+ * Mauritz Jeanson: callout.unicode.number.limit.xml;
+ compact.list.item.spacing.xml; ulink.sh
+
+ A few small parameter fixes.
+
+ * Mauritz Jeanson: saxon.character.representation.xml
+
+ Emphasized that the parameter only works with Saxon 6.
+ Fixed reference to chunker.output.encoding.
+
+ * Mauritz Jeanson: highlight.source.xml
+
+ Changed uri to link.
+
+ * Mauritz Jeanson: htmlhelp.show.advanced.search.xml
+
+ Reworded refpurpose.
+
+ * Mauritz Jeanson: tex.math.delims.xml
+
+ Reworded refpurpose.
+
+ * Mauritz Jeanson: img.src.path.xml
+
+ Fixed typos.
+
+ * Mauritz Jeanson: autotoc.label.in.hyperlink.xml;
+ annotation.graphic.open.xml; highlight.so
+
+ Some small fixes.
+
+ * Mauritz Jeanson: passivetex.extensions.xml
+
+ Updated URL, added note.
+
+ * Mauritz Jeanson: make.year.ranges.xml
+
+ Added inline markup.
+
+ * Mauritz Jeanson: highlight.source.xml
+
+ Some recasting of the documentation.
+
+ * Mauritz Jeanson: funcsynopsis.decoration.xml; funcsynopsis.style.xml
+
+ Changed element names to lowercase.
+
+ * Mauritz Jeanson: index.prefer.titleabbrev.xml
+
+ Added a description.
+
+ * Mauritz Jeanson: function.parens.xml
+
+ Fixed typos.
+
+ * Robert Stayton: procedure.properties.xml
+
+ procedure was inheriting keep-together from formal.object.properties, but
+ a procedure does not need to be kept together by default.
+
+ * Mauritz Jeanson: htmlhelp.show.favorities.xml
+
+ Corrected refpurpose and description.
+ (The name of this parameter is misspelt, but I'm ignoring that for now.
+ The HTML Help section in TCG has the correct spelling, btw.)
+
+ * Mauritz Jeanson: htmlhelp.use.hhk.xml
+
+ Updated refpurpose and description; added TCG link.
+
+ * Mauritz Jeanson: htmlhelp.enumerate.images.xml; htmlhelp.hhc.width.xml;
+ htmlhelp.hhc.show.
+
+ More clarifications and wording tweaks.
+
+ * Mauritz Jeanson: htmlhelp.show.menu.xml
+
+ Tweaked wording (note that the parameter controls the display of a menu bar, not a menu).
+
+ * Dave Pawson: javahelp.encoding.xml
+
+ Tidy up of javahelp.encoding.xml
+
+ * Michael(tm) Smith: reference.autolabel.xml
+
+ Fixed wording in embedded doc for reference.autolabel param.
+
+ * Michael(tm) Smith: olink.fragid.xml
+
+ Restored equal sign in default value of olink.fragid param.
+
+ * Michael(tm) Smith: html.longdesc.xml
+
+ Restored tag markup around textobject in html.longdesc param doc.
+
+ * Michael(tm) Smith: default.table.width.xml
+
+ Removed some invalid markup in the default.table.width param doc.
+
+ * Michael(tm) Smith: olink.resolver.xml
+
+ Restored leading "/" in default value of the olink.resolver param.
+
+ * Michael(tm) Smith: textinsert.extension.xml
+
+ The textinsert.extension parameter really does just enable the
+ textinsert extension (that is, it's not the parameter that inserts
+ the contents of external files - textinsert extension element does).
+
+ * Michael(tm) Smith: htmlhelp.force.map.and.alias.xml
+
+ Fixed typo (contex.h -> context.h) in htmlhelp.force.map.and.alias
+ param docs.
+
+ * Michael(tm) Smith: emphasis.propagates.style.xml
+
+ Restored tag markup on emphasis element in the
+ emphasis.propagates.style doc.
+
+ * Michael(tm) Smith: nominal.image.width.xml
+
+ Reverted the r7131 change to the value of the
+ nominal.image.width param (the value is an literal expression
+ that's meant to be evaluated, not a string expression.
+
+ * Michael(tm) Smith: htmlhelp.button.jump1.xml
+
+ Fixed "Jump2" typo (should be "Jump1")
+
+ * Michael(tm) Smith: htmlhelp.map.file.xml
+
+ Default value appears to actually be context.h
+
+ * Michael(tm) Smith: id.warnings.xml
+
+ Default for id.warnings is not actually for them not to be
+ emitted.
+
+ * Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
+ chunker.output.standalone.xm
+
+ Restored necessary ".frag" in IDs of src:fragment instances in
+ chunker.output.* param files.
+
+ * Michael(tm) Smith: dry-run.xml
+
+ Restored necessary ".frag" part to ID on scr:fragment
+
+ * Dave Pawson: title.font.family.xml;
+ component.label.includes.part.label.xml; table.frame.b
+
+ Regular formatting re-org.
+
+ * Michael(tm) Smith: abstract.notitle.enabled.xml
+
+ Minor clean-up of abstract.notitle.enabled.xml to make it follow
+ proper convention for default values for booleans. Also, added
+ abstract.notitle.enabled=1 to stylesheet we use for building the
+ reference docs for the distro (I though it was there and in fact
+ claimed that it was there, but, well, I guess I was
+ wrong/drunk/lying...)
+
+ * Mauritz Jeanson: htmlhelp.only.xml
+
+ Fixed refpurpose wording.
+
+ * Michael(tm) Smith: man.authors.section.enabled.xml;
+ man.copyright.section.enabled.xml
+
+ Added the man.authors.section.enabled and
+ man.copyright.section.enabled parameters. Set those to zero when
+ you want to suppress display of the auto-generated AUTHORS and
+ COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
+ Leidert.
+
+ * Michael(tm) Smith: tex.math.file.xml
+
+ Fixed typo.
+
+ * Michael(tm) Smith: variablelist.as.table.xml; variablelist.as.blocks.xml;
+ glossary.as.bloc
+
+ Mark up PIs with tag@class=xmlpi so that they can get picked up an
+ formatted correctly by the doc build.
+
+ * Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;
+ htmlhelp.button.zo
+
+ Modified refpurpose text.
+
+ * Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;
+ htmlhelp.alias.f
+
+ Fixed typos, made some small changes.
+
+ * Mauritz Jeanson: javahelp.encoding.xml
+
+ Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
+ regular "parameter machinery".
+
+ * Mauritz Jeanson: generate.id.attributes.xml
+
+ Added refpurpose text.
+
+ * Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;
+ annotation.graphic.close.
+
+ Added better refpurpose texts.
+
+ * Mauritz Jeanson: index.on.type.xml
+
+ Added two more class="attribute".
+
+ * Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
+ chunker.output.doctype-syste
+
+ Corrected duplicate ID problem introduced in previous commit.
+
+ * Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
+ chunker.output.standalone.xm
+
+ Fixed some broken formatting in source files for chunker.* params,
+ as pointed out by Dave Pawson.
+
+ * Michael(tm) Smith: use.embed.for.svg.xml; generate.meta.abstract.xml
+
+ Reverted addition of tag@role=html markup. It's no longer
+ necessary, because the doc build now has a smarter way of
+ distinguishing between DocBook elements marked up with the tag
+ element, and non-DocBook elements marked up with such.
+
+ * Michael(tm) Smith: label.from.part.xml
+
+ Changed handling of reference auto-labeling such that reference
+ (when it appears at the component level) is now affected by the
+ label.from.part param, just as preface, chapter, and appendix.
+
+ * Mauritz Jeanson: callout.graphics.extension.xml
+
+ Clarified that 'extension' refers to file names.
+
+ * Mauritz Jeanson: section.title.level2.properties.xml;
+ section.title.level3.properties.xml;
+
+ Fixed level number in refpurpose.
+
+ * Mauritz Jeanson: index.on.role.xml
+
+ Added class="attribute" markup.
+
+ * Mauritz Jeanson: show.comments.xml
+
+ The comment element was renamed to remark in DB 4.0.
+
+ * Mauritz Jeanson: keep.relative.image.uris.xml
+
+ Fixed typo.
+
+ * Mauritz Jeanson: use.embed.for.svg.xml; generate.meta.abstract.xml;
+ index.on.type.xml
+
+ Added role/class attributes on some <tag>s to prevent generation of TDG links for DocBook
+ attributes and HTML elements.
+
+ * Michael(tm) Smith: tex.math.file.xml; tex.math.in.alt.xml;
+ tex.math.delims.xml
+
+ Added embedded documentation on the following PIs:
+
+ - dbhtml_start
+ - dbfo_start
+ - dbtex_delims
+ - dbtimestamp
+
+ * Michael(tm) Smith: textinsert.extension.xml
+
+ Completing adding all doc for HTML PIs. Added "see also" sections
+ with links to related global params, plus links to DocBook XSL: TCG
+ Also tried out adding some additional doc to param doc for the
+ textinsert.extension param that back-references the PI
+ documentation, plus added some TCG links there too.
+
+ * Michael(tm) Smith: abstract.notitle.enabled.xml
+
+ Added new param abstract.notitle.enabled.
+ If non-zero, in output of the abstract element on titlepages,
+ display of the abstract title is suppressed.
+ Because sometimes you really don't want or need that title
+ there...
+
+ * Michael(tm) Smith: man.string.subst.map.xml
+
+ Output copyright and legalnotice in man-page output in whatever
+ place they are in in document order. Closes #1690539. Thanks to
+ Daniel Leidert for reporting.
+
+ * Michael(tm) Smith: man.string.subst.map.xml
+
+ Updated manpages string-substitute map to reflect fact that
+ because of another recent change to suppress bold markup in .SH
+ output, we no longer need to add a workaround for the accidental
+ uppercasing of roff escapes that occurred previously.
+
+ * Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;
+ table.frame.border.color.x
+
+ Improved parameter metadata
+
+ * Robert Stayton: index.div.title.properties.xml
+
+ Fixed repeated space-before.optimum
+
+ * Robert Stayton: profile.wordsize.xml; profile.audience.xml
+
+ Add support for profiling on new attributes audience and wordsize.
+
+ * Robert Stayton: callout.graphics.number.limit.xml;
+ callout.graphics.extension.xml
+
+ Added SVG graphics for fo output.
+
+ * Robert Stayton: callout.icon.size.xml
+
+ Set size of callout graphics.
+
+ * Robert Stayton: callout.bug.size.xml
+
+ Replaced with new name.
+
+ * Robert Stayton: callout.bug.size.xml
+
+ Control size of graphical callout bugs in FO output.
+
+ * Jirka Kosek: default.units.xml; chunker.output.method.xml;
+ toc.list.type.xml; output.inden
+
+ Updated parameter metadata to the new format.
+
+ * Jirka Kosek: man.output.quietly.xml; title.font.family.xml;
+ footnote.sep.leader.properties
+
+ Added type annotations into parameter definition files.
+
+ * Robert Stayton: section.container.element.xml
+
+ Support spans in sections for certain processors.
+
+ * Robert Stayton: component.titlepage.properties.xml
+
+ Empty attribute set for top level component titlepage block.
+ Allows setting a span on title info.
+
+ * Jirka Kosek: bibliography.style.xml
+
+ Added link to WiKi page with description of special markup needed for ISO690 biblioentries
+
+ * Michael(tm) Smith: man.string.subst.map.xml
+
+ Made some minor updates to param docs and comments in
+ manpages stylesheet. Also, removed some params for
+ manpages doc that are already doc'ed as HTML params.
+
+ * Robert Stayton: make.year.ranges.xml
+
+ Clarify that multiple year elements are required.
+
+ * Michael(tm) Smith: man.string.subst.map.xml
+
+ Reverted necessary escaping of backslash, dot, and dash
+ out of the well-intentioned (but it now appears,
+ misguided) "marker" mechanism (introduced in the 1.72.0
+ release) -- which made use of alternative "marker"
+ characters as internal representations of those
+ characters, and then replaced them just prior to
+ serialization -- and back into what's basically the
+ system that was used prior to the 1.69.0 release; that
+ is, into a part of stylesheet code that gets executed
+ at the beginning of processing -- before any other roff
+ markup up is. This change obviates the need for the
+ marker system. It also requires a lot less RAM during
+ processing (for large files, the marker mechanism
+ ending up requiring gigabytes of memory).
+
+ Closes bug #1661177. Thanks to Scott Smedley for
+ providing a test case (the fvwm man page) that exposed
+ the problem with the marker mechanism.
+
+ Also moved the mechanism for converting non-breaking
+ spaces back into the same area of the stylesheet code.
+
+ * Robert Stayton: id.warnings.xml
+
+ Turn off id.warnings by default.
+
+ * Michael(tm) Smith: title.font.family.xml; toc.line.properties.xml;
+ component.label.include
+
+ Port from docs-in-db5 branch of all DocBook5-formatted
+ params and all associated build changes needed for
+ building the param.xsl files and docs from them.
+
+ * Michael(tm) Smith: man.string.subst.map.xml
+
+ Fixed typo in param file.
+
+ * Jirka Kosek: bibliography.style.xml
+
+ Added support for formatting biblioentries according to ISO690 citation style.
+ New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
+ The code was provided by Jana Dvorakova
+
+ * Robert Stayton: header.table.properties.xml; footer.table.properties.xml
+
+ Support adding table properties to header and footer tables.
+
+ * Michael(tm) Smith: man.string.subst.map.xml
+
+ Put custom "substitution" element in params/man.string.subst.map.xml into a namespace.
+
+ * Michael(tm) Smith: editedby.enabled.xml
+
+ Removed stray text that was causing WF error.
+
+ * Michael(tm) Smith: man.links.are.underlined.xml;
+ man.endnotes.list.enabled.xml; man.links.
+
+ Made a number of changes related to elements with
+ out-of-line content:
+
+ - Added handling for mediaobject & inlinemedidaobject.
+ Each imagedata, audiodata, or videodata element
+ within a mediaobject or inline mediaobject is now
+ treated as a "notesource" and so handled in much the
+ same way as links and annotation/alt/footnotes.
+
+ That means a numbered marker is generated inline to
+ mark the place in the main flow where the imagedata,
+ audiodata, or videodata element occurs, and a
+ corresponding numbered endnote for it is generated in
+ the endnotes list at the end of the man page; the
+ endnote contains the URL from the fileref attribute
+ of the imagedata, audiodata, or videodata element.
+
+ For mediobject and inlinemediaobject instances that
+ have a textobject child, the textobject is displayed
+ within the main text flow.
+
+ - Renamed several man.link.* params to man.endnotes.*,
+ to reflect that fact that the endnotes list now
+ contains more than just links. Also did similar
+ renaming for a number of stylesheet-internal vars.
+
+ - Added support for xlink:href (along with existing
+ support for the legacy ulink element).
+
+ - Cleaned up and streamlined the endnotes-handling
+ code. It's still messy and klunky and the basic
+ mechanism it uses is very inefficent for documents
+ that contain a lot of notesources, but at least it's
+ a bit better than it was.
+
+ * Robert Stayton: toc.line.properties.xml
+
+ Moved the end-indent properties from toc.line to the
+ toc.line.properties attribute-set.
+
+ * Robert Stayton: xep.index.item.properties.xml
+
+ Fixed case of class attribute in sgmltag element.
+
+Highlighting
+
+The following changes have been made to the highlighting code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: common.xsl
+
+ Set keywords on a number of files.
+
+ * Michael(tm) Smith: common.xsl
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Jirka Kosek: c-hl.xml; xslthl-config.xml
+
+ Added support for C language. Provided by Bruno Guegan.
+
+Profiling
+
+The following changes have been made to the profiling code since the 1.72.0
+release.
+
+ * Mauritz Jeanson: xsl2profile.xsl
+
+ Fixed bug that affected Eclipse profiling. "etoc" was added as a named template to be processed
+ in "correct" mode.
+
+ * Michael(tm) Smith: xsl2profile.xsl
+
+ Updated stylesheets to use common logging template to log messages
+ emitted during namespace-stripping.
+ Also, moved pad-string template from lib to common because
+ it's needed in order to use logging template in the profiling
+ stylesheets, and the lib build relies on the profiling apparatus
+ (so the profiling apparatus can't rely on lib being built first...)
+
+ * Michael(tm) Smith: xsl2profile.xsl
+
+ Removed all "Do not edit this file" admonitions that get output in
+ generated stylesheets; such admonitions have in the past been
+ judged by the free-software police to be at-risk of
+ interpretation as license restrictions.
+ Also, made various updates to work around some funkiness is
+ xsltproc output.
+
+ * Robert Stayton: profile-mode.xsl
+
+ Add support for new profiling attributes audience and wordsize.
+
+ * Robert Stayton: profile.xsl
+
+ Add new profiling attributes audience and wordsize.
+
+Lib
+
+The following changes have been made to the lib code since the 1.72.0 release.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Moved charmap templates out of lib.xweb and into
+ common/charmap.xsl, and added charmap doc to doc build.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Make structure of lib.xweb embedded doc consistent with structure
+ of similar embedded doc in other source files.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Make lib.xweb valid against our litprog grammar.
+
+ * Michael(tm) Smith: .cvsignore
+
+ Ignore another build-generated kludge. Yeah, I know it's
+ ridiculous. If you can come up with a prettier way of doing it,
+ all of my riches will be yours.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Make *.xweb instances valid against the
+ https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
+ grammar.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Updated embedded doc in XSL source files:
+
+ - added dbhtml@dir PIs to control where output goes when
+ generation HTML version of docs
+
+ - put xml:id instances on root elements of embedded doc
+
+ - changed all *info instances to just info (DocBook 5) and some
+ @id instance to @xml-id
+
+ * Michael(tm) Smith: .cvsignore
+
+ Updated ignore properties on lib dir
+
+ * Michael(tm) Smith: .cvsignore
+
+ Set updated ignore properties and adjusted for fact that shared
+ makefile now expects a "PARAMBASE" value to be specified (to
+ indicate base filename for the type of content being built: either
+ PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce
+ redundancy in the lib build, and just have it use the same
+ makefile "infrastructure" as the param builds for all the
+ param.xsl files. The reason for that is, lib use the same *.xweb
+ system for embedding documentation that the builds for the various
+ output formats use (as opposed to the jrefentry-based system that
+ used for building the template and PI docs in common etc.
+
+ * Michael(tm) Smith: Makefile
+
+ Made the lib build make reuse of the same makefile infrastructure
+ now used for param builds.
+
+ * Michael(tm) Smith: Makefile
+
+ Added a mechanism for "building" copies of the w2docbook.xsl,
+ ldocbook.xsl, cldocbook.xsl, xtangle.xsl files. All that this
+ "build" really does is to to first make the litprog module, then
+ copy over those files to the releasetools directory, prepending to
+ the copies a warning that they might not be up-to-date.
+ And so am no also checking in those copies to source control,
+ and updating the docbook-xsl build to use those instead of the
+ source versions in the litprog module.
+ This removes litprog as a build target/dependency for docbook-xsl.
+ The sole purpose of this change is just to make it easier for
+ other developers to do docbook-xsl release builds.
+ The litprog sources change very rarely, so it won't be a big
+ maintenance problem to keep these static copies in releasetools up
+ to date, and it'll certainly make it easier for developers to do
+ builds...
+
+ * Michael(tm) Smith: lib.xweb
+
+ In files that still referred to nwalsh.com URL in the copyright
+ header, changed to docbook.sf.net URL.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Moved logging template and related templates to separate
+ utility.xsl file so that can be imported without importing the
+ whole common.xsl file (which is necessary for the build and for
+ using the logging template in standalone namespace-stripping
+ because the common.xsl file assumes it will be imported along with
+ all the params, which it can't be when building lib.xsl).
+
+ * Michael(tm) Smith: lib.xweb
+
+ Updated stylesheets to use common logging template to log messages
+ emitted during namespace-stripping.
+ Also, moved pad-string template from lib to common because
+ it's needed in order to use logging template in the profiling
+ stylesheets, and the lib build relies on the profiling apparatus
+ (so the profiling apparatus can't rely on lib being built first...)
+
+ * Michael(tm) Smith: lib.xweb
+
+ Fixed typo/oversight in trim-left lib template.
+
+ * Michael(tm) Smith: lib.xweb
+
+ Changed name of prepend-pad template to pad-string and twheeked so
+ it can do both right/left padding.
+
+ * Michael(tm) Smith: Makefile
+
+ Renamed cvstools dir to buildtools, and replaced all
+ references to "cvstools" in makefiles and elsewhere
+ with "buildtools".
+
+ * Michael(tm) Smith: lib.xweb
+
+ Updated copyright notices.
+
+Tools
+
+The following changes have been made to the tools code since the 1.72.0
+release.
+
+ * Michael(tm) Smith: xsl/build/doc-link-docbook.xsl
+
+ Moved release-notes boilerplate into abstract and added links to
+ online change history to release-notes and to README. Also made a
+ minor correction to the README.BUILD file.
+
+ * Michael(tm) Smith: xsl/build/make-xsl-pi.xsl
+
+ Set keywords on a number of files.
+
+ * Michael(tm) Smith: xsl/build/html2roff.xsl
+
+ Updated html2roff.xsl to revert to output of real dot characters
+ instead of U+2302 markers.
+
+ * Mauritz Jeanson: xsl/build/reference-fo.xsl
+
+ Added template for handling links with role='tcg' (patterned after HTML version).
+
+ * Mauritz Jeanson: xsl/build/reference.xsl
+
+ Use admon.textlabel instead of admon.graphics (to avoid problems with paths to the admonition graphics).
+
+ * Mauritz Jeanson: xsl/build/reference.xsl
+
+ Set admon.graphics to 1 to make it easier to distinguish between types of admonitions.
+
+ * Michael(tm) Smith: xsl/build/reference.xsl
+
+ Minor clean-up of abstract.notitle.enabled.xml to make it follow
+ proper convention for default values for booleans. Also, added
+ abstract.notitle.enabled=1 to stylesheet we use for building the
+ reference docs for the distro (I though it was there and in fact
+ claimed that it was there, but, well, I guess I was
+ wrong/drunk/lying...)
+
+ * Michael(tm) Smith: xsl/build/reference.xsl; xsl/build/make-xsl-pi.xsl;
+ xsl/build/xsl-pi-li
+
+ Added support for auto-generating doc hyperlinks for names of
+ docbook-xsl PIs referenced in the docs.
+
+ * Michael(tm) Smith: xsl/build/jref2refsect1.xsl
+
+ Added handling for refsee@role=tcg sections.
+
+ * Michael(tm) Smith: xsl/build/make-xsl-params.xsl;
+ xsl/build/make-elements.xsl
+
+ Minor change to add more prominent "warning" in output of the
+ stylesheets that generate the elements and params list used in the
+ doc build.
+
+ * Michael(tm) Smith: xsl/build/fix-params-ns.xsl
+
+ Revert change made to fix-params-ns.xsl to cause namespaces to be
+ copied over.
+
+ * Michael(tm) Smith: xsl/build/reference.xsl
+
+ In reference doc for docbook-xsl, auto-label all part output, and
+ also include part labels in component labels.
+
+ * Michael(tm) Smith: xsl/build/reference.xsl
+
+ Don't include list of figures in book TOC for reference docs.
+
+ * Michael(tm) Smith: xsl/build/clrefentry.xsl; xsl/build/lrefentry.xsl;
+ xsl/build/jrefhtml.x
+
+ Removed obsoleted lrefentry, clrefentry, and jrefhtml stylesheets.
+ All HTML output is now generated using the reference.xsl
+ stylesheet (and the build now converts jref content to standard
+ DocBook content before generating HTML).
+
+ * Michael(tm) Smith: xsl/build/reference.xsl
+
+ Make the reference.xsl stylesheet (which is used for building the
+ HTML output of the docs) import the DocBook-element and
+ docbook-xsl-param auto-hyperlinking stylesheets (which are already
+ used for adding hyperlinks in the release notes). This makes the
+ auto-hyperlinking consistent between the systems used for the
+ release-notes build and for the reference docs.
+
+ * Michael(tm) Smith: xsl/build/xsl2jref.xsl
+
+ Don't output prolog in xsl2jref output (no doctype, not public ID,
+ no system ID). Because otherwise we end up with the output tree
+ getting populated with implied attributes some of which are no
+ longer valid in DocBook 5.
+
+ * Michael(tm) Smith: xsl/build/tdg-link.xsl
+
+ Cleaned up template that handles adding markup for sgmltag|tag
+ instances that are DocBook element names.
+
+ * Michael(tm) Smith: xsl/build/jref2refsect1.xsl
+
+ Made jref2refsect1 stylesheet convert all @id instances to @xml:id
+
+ * Michael(tm) Smith: xsl/build/id-to-xmlid.xsl
+
+ Adding yet another hack to workaround the fact that the DocBook 5
+ grammar requires @xml:id instead of @id, and xsltproc actually
+ takes xml:id seriously and checks that it's really a NCName.
+
+ * Michael(tm) Smith: xsl/build/xsl-param-link.xsl
+
+ Added the doc-baseuri param to the stylesheet used for
+ automatically adding hyperlinks in generated doc for stylesheet
+ params and in release-notes output.
+ For output of the param doc, doc-baseuri is set to "../" (relative
+ path so links point to local files).
+ For release-note output, doc-baseuri is set to the http: url for
+ the current version of the docbook-xsl docs (instead of to local
+ files); reason being that when installed from a downstream
+ package, the release notes can't point to local files because the
+ release notes are often installed in a separate place for the docs.
+
+ * Michael(tm) Smith: xsl/build/xsl2jref.xsl
+
+ Don't prepend "template." to IDs for embedded doc for PIs. (cause
+ of this was a copy/paste error -- the template for processing
+ embedded PI documentation began life as a copy of the template for
+ processing embeded doc for templates)
+
+ * Michael(tm) Smith: xsl/build/fix-params-ns.xsl
+
+ Don't strip namespace nodes from xsl:stylesheet instances when
+ generating doc files.
+
+ * Michael(tm) Smith: xsl/build/xsl2jref.xsl
+
+ Adjusted xsl2jref to copy over any attributes on source
+ doc:reference instances (primarily embedded doc for params) and to
+ also copy any PIs that are children of doc:reference.
+ That ensures that any id/xml:id attributes get copied over -- so
+ that they can be used when use.id.as.filename is on -- and that
+ any dbhtml@dir and dbhtml@filename PIs can be used for moving
+ files into the correct subdirs and are output with right names.
+
+ * Michael(tm) Smith: xsl/build/reference.xsl; xsl/build/reference-fo.xsl;
+ xsl/build/referenc
+
+ Updated stylesheet customization layers used for doc build,
+ including disabling extensions during doc build to prevent "Failed
+ to load image page.png" error messages.
+
+ * Michael(tm) Smith: xsl/build/xmlid-to-id.xsl
+
+ Kludge to replace xml:id with id so that we can build the docs
+ without xsltproc squawking about duplicate IDs.
+
+ * Michael(tm) Smith: xsl/build/reference-fo.xsl
+
+ Had wrong name for hyphenate param; fixed.
+
+ * Michael(tm) Smith: xsl/build/xsl2jref.xsl; xsl/build/jref2refsect1.xsl
+
+ Added some handling in the doc build for generating docs for PIs.
+
+ * Michael(tm) Smith: xsl/build/clrefentry.xsl; xsl/build/lrefentry.xsl
+
+ Added a mechanism for "building" copies of the w2docbook.xsl,
+ ldocbook.xsl, cldocbook.xsl, xtangle.xsl files. All that this
+ "build" really does is to to first make the litprog module, then
+ copy over those&nbs
projects / scilab.git / commitdiff
