summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRemko Tronçon <git@el-tramo.be>2010-03-28 19:43:32 (GMT)
committerRemko Tronçon <git@el-tramo.be>2010-03-28 19:44:49 (GMT)
commit3afa4f741c26360245dc313bc368f508b26a6b96 (patch)
tree4fc9fedac990a099010fed8a4ee09ddc51c21cc5 /3rdParty/DocBook/XSL/RELEASE-NOTES.xml
parent7548dabae7d10e48816142e508be651ada9f7bc3 (diff)
downloadswift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.zip
swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.tar.bz2
Added DocBook infrastructure.
Imported most of "DocBook kit". Added placeholder for Swiften developers guide.
Diffstat (limited to '3rdParty/DocBook/XSL/RELEASE-NOTES.xml')
-rw-r--r--3rdParty/DocBook/XSL/RELEASE-NOTES.xml9240
1 files changed, 9240 insertions, 0 deletions
diff --git a/3rdParty/DocBook/XSL/RELEASE-NOTES.xml b/3rdParty/DocBook/XSL/RELEASE-NOTES.xml
new file mode 100644
index 0000000..0984742
--- /dev/null
+++ b/3rdParty/DocBook/XSL/RELEASE-NOTES.xml
@@ -0,0 +1,9240 @@
+<article xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xml:lang="en" xml:id="releasenotes"
+ version="5.0">
+
+<info>
+ <title>Release Notes for the DocBook XSL Stylesheets</title>
+ <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
+ <releaseinfo role="cvs">$Revision: 8446 $ $Date: 2009-05-27 17:31:50 -0700 (Wed, 27 May 2009) $</releaseinfo>
+ <!-- * <author><orgname>DocBook Project Development Team</orgname></author> -->
+<abstract>
+<para condition="dot-zero;dot-one-plus">This release-notes
+ document is available in the following formats:
+ <link
+ xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html"
+ >HTML</link>,
+ <link
+ xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.pdf"
+ >PDF</link>,
+ <link
+ xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.txt"
+ >plain text</link>; it provides a per-release list
+of enhancements and changes to the stylesheets’ public APIs
+(user-configurable parameters) and excludes descriptions of most
+bug fixes. For a complete list of all changes (including all bug
+fixes) that have been made since the previous release, see the
+separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link
+ xlink:href="NEWS.html">NEWS.html</link> files. Also available:
+An online <link
+ xlink:href="http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log"
+ >hyperlinked change history</link> (warning: big file) of all
+changes made over the entire history of the codebase.</para>
+<para condition="dot-zero">As with all DocBook Project <link
+ linkend="dot0">dot-zero</link> releases, this is an
+ experimental release. It will be followed shortly by a stable
+ release.</para>
+<para condition="dot-one-plus">As with all DocBook Project “dot
+ one plus” releases, this release aspires to be stable (in
+ contrast to <link linkend="dot0">dot-zero</link> releases, which
+ are experimental).</para>
+<para condition="snapshot">This is a pre-release “snapshot” of the
+DocBook XSL Stylesheets. The change information in the first
+section of this file
+(for “<xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/title/text())"/>”) is
+auto-generated from change descriptions stored in the project
+source-code repository.</para>
+<para condition="snapshot">That means the first section contains
+descriptions both of bug fixes and of feature changes. The
+remaining sections are manually edited changelog subsets that
+exclude bug-fix descriptions – that is, trimmed down to just those
+those descriptions that document enhancements and changes to the
+public APIs (user-configurable parameters).</para>
+</abstract>
+</info>
+
+<sect1 condition="snapshot" xml:id="current">
+ <xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/*)"/>
+</sect1>
+
+<sect1 xml:id="rn_V1.75.1">
+<title>Release Notes: 1.75.1</title>
+<para>This release includes bug fixes.</para>
+
+<para>The following is a list of changes that have been made since the 1.75.0 release.</para>
+
+
+<sect2 xml:id="rn_V1.75.1_FO">
+<title>FO</title>
+<para>The following changes have been made to the <filename>fo</filename> code since the 1.75.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Keith Fahlgren: block.xsl</literal></para><screen><phrase role="commit-message">Switching to em dash for character before <tag>attribution</tag> in <tag>epigraph</tag>; resolves Bug #2793878</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789947, id attribute missing on <tag>simplelist</tag> fo output.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.75.1-->
+
+<sect2 xml:id="rn_V1.75.1_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.75.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Keith Fahlgren: block.xsl</literal></para><screen><phrase role="commit-message">Switching to em dash for character before <tag>attribution</tag> in <tag>epigraph</tag>; resolves Bug #2793878</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789678: apply-templates line accidentally deleted.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.75.1-->
+
+<sect2 xml:id="rn_V1.75.1_Epub">
+<title>Epub</title>
+<para>The following changes have been made to the
+ <filename>epub</filename> code
+ since the 1.75.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/onegraphic.xinclude.xml;⋯</literal></para><screen><phrase role="commit-message">Another attempt at flexible named entity and XInclude processing</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/lib/docbook.rb</literal></para><screen><phrase role="commit-message">Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Epub changes for 1.75.1-->
+
+<sect2 xml:id="rn_V1.75.1_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.75.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated documentation to reflect changes made in r8419.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.75.1-->
+
+</sect1>
+
+
+<sect1 xml:id="V1.75.0">
+<title>Release Notes: 1.75.0</title>
+<para>This release includes important bug fixes and adds the following
+significant feature changes:
+<variablelist>
+<varlistentry>
+<term>Gentext</term>
+<listitem><para>Modifications to translations have been made. </para></listitem>
+
+</varlistentry>
+<varlistentry>
+<term>Common</term>
+<listitem>
+<para>Added support for some format properties on tables using
+HTML <tag>table</tag> markup. </para>
+<para>Added two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
+and numbered questions can be distinguished. Satisfies
+Feature Request #1539045.</para>
+<para>Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
+similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
+any dedications.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>FO</term>
+<listitem>
+<para>The inclusion of highlighting code has been simplified.</para>
+<para>Add support for pgwide on informal objects.</para>
+<para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. Closes FR #1792326.</para>
+<para>Add support for more dbfo processing instructions.</para>
+<para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
+<para>Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</para>
+<para>Add support for writing-mode="rl-tb" (right-to-left) in FO outputs. </para>
+<para>Add <parameter>writing.mode</parameter> param for FO output.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>HTML</term>
+<listitem>
+<para>Convert all calls to class.attribute to calls to common.html.attributes to support dir, lang, and <tag>title</tag> attributes in html output for all elements. Fulfills feature request #1993833.</para>
+<para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
+<para>Add new param <parameter>index.links.to.section</parameter>.</para>
+<para>Add support for the new <parameter>index.links.to.section</parameter> param which permits precise links to indexterms in HTML output rather than to the <tag>section</tag> <tag>title</tag>.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>ePub</term>
+<listitem>
+<para>Slightly more nuanced handling of <tag>imageobject</tag> alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.</para>
+<para>Added a colon after an <tag>abstract</tag>/<tag>title</tag> when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)</para>
+<para>Added DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</para>
+<para>Added DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</para>
+<para>Added DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</para>
+<para>Added --output option to dbtoepub based on user request</para>
+</listitem>
+
+</varlistentry>
+<varlistentry>
+<term>HTMLHelp</term>
+<listitem>
+<para>Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</para></listitem>
+
+</varlistentry>
+
+<varlistentry>
+<term>Params</term>
+<listitem>
+<para>Add default setting for @rules attribute on HTML markup tables.</para>
+<para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X. Closes FR #1792326.</para>
+<para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
+<para>Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.</para>
+<para>Add param to control whether an <tag>index</tag> <tag>entry</tag> links to a <tag>section</tag> <tag>title</tag> or to the precise location of the <tag>indexterm</tag>.</para>
+<para>New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</para>
+<para>New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</para>
+<para>Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Highlighting</term>
+<listitem>
+<para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
+</listitem>
+
+</varlistentry>
+</variablelist>
+
+
+</para>
+<para>The following is a list of changes that have been made
+ since the 1.74.3 release.</para>
+
+<sect2 xml:id="rn_V1.75.0_Gentext">
+<title>Gentext</title>
+<para>The following changes have been made to the
+ <filename>gentext</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml</literal></para><screen><phrase role="commit-message">Check in translations of <tag>Legalnotice</tag> submitted on mailing list.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Fix spelling errors in <tag>Acknowledgements</tag> entries.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Check in translations for 4 elements submitted through docbook-apps
+message of 14 April 2009.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml; locale/gl.xml; l⋯</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: Makefile</literal></para><screen><phrase role="commit-message">Check in fixes for DSSSL gentext targets from submitted patch #1689633.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/uk.xml</literal></para><screen><phrase role="commit-message">Check in major update submitted with bug report #2008524.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/zh_tw.xml</literal></para><screen><phrase role="commit-message">Check in fix to Note string submitted in bug #2441051.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/ru.xml</literal></para><screen><phrase role="commit-message">Checkin typo fix submitted in bug #2453406.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Gentext changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+ <filename>common</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Fix extra generated space when xrefstyle includes 'nopage'.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
+HTML <tag>table</tag> markup. These include:
+ - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
+ - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
+ - align attribute on <tag>td</tag> and <tag>th</tag>
+ - valign attribute on <tag>td</tag> and <tag>th</tag>
+ - colspan on <tag>td</tag> and <tag>th</tag>
+ - rowspan on <tag>td</tag> and <tag>th</tag>
+ - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Add placeholder template to massage <tag>olink</tag> hot text to make
+customization easier, per Feature Request 1828608.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: targets.xsl</literal></para><screen><phrase role="commit-message">Add support for collecting <tag>olink</tag> targets from a <tag>glossary</tag>
+generated from a <parameter>glossary.collection</parameter>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="title.markup".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add match on <tag>info</tag>/<tag>title</tag> in title.markup templates where missing.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Changed "ancestor::<tag>title</tag>" to "(ancestor::<tag>title</tag> and (@id or @xml:id))".
+This enables proper formatting of inline elements in titles in TOCs,
+as long as these inlines don't have id or xml:id attributes.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
+and numbered questions can be distinguished. Satisfies
+Feature Request #1539045.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: stripns.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Convert function-available(exsl:node-set) to use the new param
+so Xalan bug is isolated.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added fixes for bugs #2112656 and #1759205:
+1. Reverted mistaken commits r7485 and r7523.
+2. Updated the template with match="<tag>link</tag>" and mode="no.anchor.mode" so that
+@endterm is used if it exists and if the <tag>link</tag> has no content.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
+similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
+any dedications.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #2018717 <parameter>use.local.olink.style</parameter> uses wrong gentext context.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1669654 Broken output if <tag>copyright</tag> &lt;<tag>year</tag>&gt; contains a range.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Fix bug in labelling <tag>figure</tag> inside <tag>appendix</tag> inside <tag>article</tag> inside <tag>book</tag>.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: fop1.xsl</literal></para><screen><phrase role="commit-message">Add the new fop extensions namespace declaration, in case FOP
+extension functions are used.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Add support for pgwide on informal objects.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixed spurious closing <tag>quote</tag> on line 134.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">Convert function-available for node-set() to use
+new $exsl.node.set.available param in test.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: xref.xsl</literal></para><screen><phrase role="commit-message">Suppress extra space after <tag>xref</tag> when xrefstyle='select: <tag>label</tag> nopage' (#2740472)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
+HTML <tag>table</tag> markup. These include:
+ - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
+ - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
+ - align attribute on <tag>td</tag> and <tag>th</tag>
+ - valign attribute on <tag>td</tag> and <tag>th</tag>
+ - colspan on <tag>td</tag> and <tag>th</tag>
+ - rowspan on <tag>td</tag> and <tag>th</tag>
+ - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support bgcolor in <tag>td</tag> and <tag>th</tag>
+elements in HTML <tag>table</tag> markup.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Add support for colspan and rowspan and bgcolor in <tag>td</tag> and <tag>th</tag>
+elements in HTML <tag>table</tag> markup.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Fix working of page-master left and right margins.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: param.xweb; param.ent; fop1.xsl</literal></para><screen><phrase role="commit-message">Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: table.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo row-height processing instruction, like that in dbhtml.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo keep-together processing instruction for
+entire list instances.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Add support fo dbfo keep-together processing instruction to
+more blocks like list items and paras.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="xref-to".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Implement simple.xlink for <tag>glosssee</tag> and <tag>glossseealso</tag> so they can use
+other types of linking besides otherterm.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: titlepage.xsl</literal></para><screen><phrase role="commit-message">For the <tag>book</tag> <tag>title</tag> templates, I changed <tag>info</tag>/<tag>title</tag> to <tag>book</tag>/<tag>info</tag>/<tag>title</tag>
+so other element's titles will not be affected.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl; verbatim.xsl</literal></para><screen><phrase role="commit-message">Use param <parameter>exsl.node.set.available</parameter> to test for <tag>function</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent; footnote.xsl</literal></para><screen><phrase role="commit-message">Start using new param <parameter>exsl.node.set.available</parameter> to work around Xalan bug.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add comment on use of t:predicate for <tag>editor</tag> to prevent
+extra processing of multiple editors. Fixes bug 2687842.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">An <tag>indexterm</tag> <tag>primary</tag>, <tag>secondary</tag>, or <tag>tertiary</tag> element with an id or xml:id
+now outputs that ID, so that <tag>index</tag> entries can be cross referenced to.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
+Closes bug #1623468.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add template with match on <tag>indexterm</tag> in mode="xref-to" to fix bug 2102592.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Now <tag>xref</tag> to <tag>qandaentry</tag> will use the <tag>label</tag> element in a <tag>question</tag> for
+the <tag>link</tag> text if it has one.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add id if specified from @id to output for <tag>quote</tag> and <tag>phrase</tag> so
+they can be <tag>xref</tag>'ed to.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>xref</tag> to <tag>phrase</tag>, <tag>simpara</tag>, <tag>anchor</tag>, and <tag>quote</tag>.
+This assumes the <tag>author</tag> specifies something using xrefstyle since
+the elements don't have ordinary <tag>link</tag> text.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Fix bug in new <tag>toc</tag> templates.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl; titlepage.templates⋯</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
+similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
+any dedications.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Rewrite <tag>toc</tag> templates to support an empty <tag>toc</tag> or populated <tag>toc</tag>
+in all permitted contexts. Same for lot elements.
+This fixes bug #1595969 for FO outputs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fix indents for <tag>seealsoie</tag> so they are consistent.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Removed duplicate (<parameter>monospace.font.family</parameter>).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>glossentry.list.item.properties</parameter>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>monospace.verbatim.font.width</parameter> param to support @width on <tag>programlisting</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Put <tag>programlisting</tag> in fo:block-container with writing-mode="lr-tb"
+when text direction is right to left because all program languages
+are left-to-right.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1973585 <tag>xref</tag> to <tag>para</tag> with xrefstyle not handled correctly.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
+Support in <tag>book</tag>/part remains to be added.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: fo.xsl</literal></para><screen><phrase role="commit-message">Add writing-mode="tb-rl" as well since some XSL-FO processors support it.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
+Changed instances of margin-left to margin-{$direction.align.start}
+and margin-right to margin-{$direction.align.end}. Those direction.align
+params are computed from the writing mode value in each locale's
+gentext key named 'writing-mode', introduced in 1.74.3 to add
+right-to-left support to HTML outputs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>writing.mode</parameter> param for FO output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix bug 1546008: in <tag>qandaentry</tag> in a <tag>TOC</tag>, use its blockinfo/<tag>titleabbrev</tag> or blockinfo/<tag>title</tag>
+instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">More tweaking the way that XSLTHL does or does not get called</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Removed redundant lang and <tag>title</tag> attributes on list element inside
+div element for lists.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl; sections.xsl; table.xsl;⋯</literal></para><screen><phrase role="commit-message">Convert all calls to class.attribute to calls to common.html.attributes
+to support dir, lang, and <tag>title</tag> attributes in html output for all elements.
+Fulfills feature request #1993833.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #2750253 wrong links in list of figures in chunk.html
+when target html is in a subdirectory and dbhtml <tag>filename</tag> used.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl; chunk-changebars.xsl; autoidx⋯</literal></para><screen><phrase role="commit-message">Convert function-available for node-set() to use
+new $exsl.node.set.available param in test.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">More elements get common.html.attributes.
+Added locale.html.attributes template which does the lang,
+dir, and <tag>title</tag> attributes, but not the class attribute
+(used on <tag>para</tag>, for example).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Replace more <tag>literal</tag> class atts with mode="class.attribute" to support
+easier customization.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">Support olinking in <tag>glosssee</tag> and <tag>glossseealso</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="xref-to".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Added template named common.html.attributes to output
+class, <tag>title</tag>, lang, and dir for most elements.
+Started adding it to some list and block elements.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
+and numbered questions can be distinguished. Satisfies
+Feature Request #1539045.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl; chunkfast.xsl; verbatim.x⋯</literal></para><screen><phrase role="commit-message">Use new param <parameter>exsl.node.set.available</parameter> to test, handles Xalan bug.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Use named anchors for <tag>primary</tag>, <tag>secondary</tag>, and <tag>tertiary</tag> ids so
+duplicate entries with different ids can still have an id output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new param <parameter>index.links.to.section</parameter>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">Pass through an id on <tag>primary</tag>, <tag>secondary</tag>, or <tag>tertiary</tag> to
+the <tag>index</tag> <tag>entry</tag>, so that one could <tag>link</tag> to an <tag>index</tag> <tag>entry</tag>.
+You can't <tag>link</tag> to the id on an <tag>indexterm</tag> because that is
+used to place the main <tag>anchor</tag> in the text flow.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Add support for the new <parameter>index.links.to.section</parameter> param which permits
+precise links to indexterms in HTML output rather than to
+the <tag>section</tag> <tag>title</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
+Closes bug #1623468.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Make sure a <tag>qandaset</tag> has an <tag>anchor</tag>, even when it has no <tag>title</tag>,
+because it may be referenced in a <tag>TOC</tag> or <tag>xref</tag>.
+Before, the <tag>anchor</tag> was output by the <tag>title</tag>, but there was no
+<tag>anchor</tag> if there was no <tag>title</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add a template for <tag>indexterm</tag> with mode="xref-to" to fix bug 2102592.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Now <tag>xref</tag> to <tag>qandaentry</tag> will use the <tag>label</tag> element in a <tag>question</tag> for
+the <tag>link</tag> text if it has one.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: qandaset.xsl; html.xsl</literal></para><screen><phrase role="commit-message">Create separate templates for computing <tag>label</tag> of <tag>question</tag> and <tag>answer</tag>
+in a <tag>qandaentry</tag>, so such can be used for the <tag>alt</tag> text of an <tag>xref</tag>
+to a <tag>qandaentry</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Now support <tag>xref</tag> to <tag>phrase</tag>, <tag>simpara</tag>, <tag>anchor</tag>, and <tag>quote</tag>,
+most useful when an xrefstyle is used.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Rewrite <tag>toc</tag> templates to support an empty <tag>toc</tag> or populated <tag>toc</tag>
+in all permitted contexts. Same for lot elements.
+This fixes bug #1595969 for HTML outputs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl; titlepage.templates⋯</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
+similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
+any dedications.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Rewrote <tag>primaryie</tag>, <tag>secondaryie</tag> and <tag>tertiaryie</tag> templates to handle
+nesting of elements and <tag>seeie</tag> and <tag>seealsoie</tag>, as reported in
+bug # 1168912.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix <tag>simplesect</tag> in <tag>toc</tag> problem.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width per bug report #2012736.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787140 HTML tables not handling attributes correctly.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Move writing-mode param.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: refentry.xsl</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1945872 to allow passthrough of colwidth values to
+HTML <tag>table</tag> when no <parameter>tablecolumns.extension</parameter> is available and
+when no instance of * appears in the <tag>table</tag>'s colspecs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
+Support in <tag>book</tag>/part remains to be added.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Fix bug 1546008: in <tag>qandaentry</tag> in a <tag>TOC</tag>, use its blockinfo/<tag>titleabbrev</tag> or blockinfo/<tag>title</tag>
+instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: chunktoc.xsl</literal></para><screen><phrase role="commit-message">Add support for generating <tag>olink</tag> <tag>database</tag> when using chunktoc.xsl.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">More tweaking the way that XSLTHL does or does not get called</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Convert function-available test for node-set() <tag>function</tag> to
+test of $exsl.node.set.available param.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: lists.xsl</literal></para><screen><phrase role="commit-message">Added a template for <tag>bibliolist</tag>. Closes bug #1815916.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_Epub">
+<title>ePub</title>
+<para>The following changes have been made to the
+ <filename>epub</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/onegraphic.xinclude.xml;⋯</literal></para><screen><phrase role="commit-message">Slightly more nuanced handling of <tag>imageobject</tag> alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Add a colon after an <tag>abstract</tag>/<tag>title</tag> when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/de.xml</literal></para><screen><phrase role="commit-message">Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Corrected namespace declarations for <tag>literal</tag> XHTML elements to make them serialize "normally"</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Be a little bit more nuanced about dates</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Check in patch submitted by user to add opf:file-as attribute
+to dc:creator element.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/dbtoepub</literal></para><screen><phrase role="commit-message">Adding --output option to dbtoepub based on user request</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb</literal></para><screen><phrase role="commit-message">Cleaning and regularizing the generation of namespaced nodes for OPF, NCX, XHTML and other outputted filetypes (hat <tag>tip</tag> to bobstayton for pointing out the silly, incorrect code)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/refclass.xml</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/blockquotepre.xml</literal></para><screen><phrase role="commit-message">Added regression test and fix for XHTML validation problem with &lt;a&gt;s added inside &lt;<tag>blockquote</tag>&gt;; This potentially causes another problem (where something is referenced by has no <tag>anchor</tag>, but someone reporting that should cause the whole &lt;a id='thing'/&gt; thing to be reconsidered with modern browsers in mind.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Epub changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_HTMLHelp">
+<title>HTMLHelp</title>
+<para>The following changes have been made to the
+ <filename>htmlhelp</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTMLHelp changes for 1.75.0-->
+
+
+<sect2 xml:id="rn_V1.75.0_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: default.table.rules.xml</literal></para><screen><phrase role="commit-message">Add default setting for @rules attribute on HTML markup tables.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: bookmarks.collapse.xml</literal></para><screen><phrase role="commit-message">Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag>
+of the bookmark tree. When the parameter has a non-zero value (the default),
+only the top-level bookmarks are displayed initially. Otherwise, the whole
+tree of bookmarks is displayed.
+
+This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: variablelist.term.properties.xml</literal></para><screen><phrase role="commit-message">Add new <parameter>variablelist.term.properties</parameter> to format terms, per
+request # 1968513.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: qanda.defaultlabel.xml</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
+and numbered questions can be distinguished. Satisfies
+Feature Request #1539045.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: index.links.to.section.xml</literal></para><screen><phrase role="commit-message">Change default to 1 to match past behavior.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: exsl.node.set.available.xml</literal></para><screen><phrase role="commit-message">Isolate this text for Xalan bug regarding exsl:node-set available.
+If it is ever fixed in Xalan, just fix it here.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: index.links.to.section.xml</literal></para><screen><phrase role="commit-message">Add param to control whether an <tag>index</tag> <tag>entry</tag> links to
+a <tag>section</tag> <tag>title</tag> or to the precise location of the
+<tag>indexterm</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: glossentry.list.item.properties.xml</literal></para><screen><phrase role="commit-message">New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: monospace.verbatim.font.width.xml</literal></para><screen><phrase role="commit-message">New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated and reorganized the description.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: page.margin.outer.xml; page.margin.inner.xml</literal></para><screen><phrase role="commit-message">Add caveat about XEP bug when writing-mode is right-to-left.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml; body.start.indent⋯</literal></para><screen><phrase role="commit-message">Change 'left' to 'start' and 'right' to 'end' to support right-to-left
+writing mode.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: glossdef.block.properties.xml; glossdef.list.properties.xml; glossterm.blo⋯</literal></para><screen><phrase role="commit-message">Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: glossterm.separation.xml</literal></para><screen><phrase role="commit-message">Clarify the description.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: make.year.ranges.xml</literal></para><screen><phrase role="commit-message">Now handles <tag>year</tag> element containing a comma or dash without error.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_Highlighting">
+<title>Highlighting</title>
+<para>The following changes have been made to the
+ <filename>highlighting</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Jirka Kosek: README</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: README</literal></para><screen><phrase role="commit-message">Adding XSLTHL readme</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: common.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Highlighting changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_XSL-Saxon">
+<title>XSL-Saxon</title>
+<para>The following changes have been made to the
+ <filename>xsl-saxon</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/Text.java</literal></para><screen><phrase role="commit-message">Added a fix that prevents output of extra blank line.
+Hopefully this closes bug #894805.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-Saxon changes for 1.75.0-->
+
+<sect2 xml:id="rn_V1.75.0_XSL-Xalan">
+<title>XSL-Xalan</title>
+<para>The following changes have been made to the
+ <filename>xsl-xalan</filename> code
+ since the 1.74.3 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: src/com/nwalsh/xalan/Text.java</literal></para><screen><phrase role="commit-message">Added a fix that prevents output of extra blank line.
+Hopefully this closes bug #894805.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-Xalan changes for 1.75.0-->
+
+
+</sect1>
+
+<sect1 xml:id="V1.74.3">
+<title>Release Notes: 1.74.3</title>
+<para>This release fixes some bugs in the 1.74.2 release.</para>
+<para>See <filename>highlighting/README</filename> for XSLTHL usage instructions.</para>
+</sect1>
+<sect1 xml:id="V1.74.2">
+<title>Release Notes: 1.74.2</title>
+<para>This release fixes some bugs in the 1.74.1 release.</para>
+</sect1>
+
+<sect1 xml:id="V1.74.1">
+<title>Release Notes: 1.74.1</title>
+<para>This release includes important bug fixes and adds the following
+significant feature changes:
+<variablelist>
+<varlistentry>
+<term>Gentext</term>
+<listitem><para>Kirghiz locale added and Chinese translations have been simplified.</para></listitem>
+<listitem><para>Somme support for gentext and right-to-left languages has been added.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>FO</term>
+<listitem><para>Various bugs have been resolved. </para> </listitem>
+<listitem><para>Support for a new processing instruction: <markup>dbfo funcsynopsis-style</markup> has been added. </para> </listitem>
+<listitem><para>Added new param <parameter>email.mailto.enabled</parameter> for FO output. Patch from Paolo Borelli. </para>
+</listitem>
+<listitem><para>Support for documented metadata in fop1 mode has been added. </para>
+</listitem>
+
+</varlistentry>
+<varlistentry>
+<term>Highlighting</term>
+<listitem><para>Support for the latest version of XSLTHL 2.0 and some new language syntaxes have been added to a variety of outputs.</para></listitem>
+
+</varlistentry>
+
+<varlistentry>
+<term>Manpages</term>
+<listitem><para>Added man.output.better.ps.enabled param (zero default). It non-zero, no such
+markup is embedded in generated man pages, and no enhancements are
+included in the PostScript output generated from those man pages
+by the man -Tps <tag>command</tag>.</para></listitem>
+
+</varlistentry>
+
+
+<varlistentry>
+<term>HTML</term>
+<listitem><para>Support for <parameter>writing.mode</parameter> to set text direction and <parameter>alignment</parameter> based on document locale has been added.</para></listitem>
+<listitem>
+<para>Added a new top-level stylesheet module, chunk-changebars.xsl, to be
+used for generating chunked output with highlighting based on change
+(@revisionflag) markup. The module imports/includes the standard chunking
+and changebars templates and contains additional logic for chunked output.
+See FRs #1015180 and #1819915.</para>
+</listitem>
+
+</varlistentry>
+<varlistentry>
+<term>ePub</term>
+<listitem>
+<para>Covers now look better in Adobe Digital Editions thanks to a patch from Paul Norton of Adobe</para>
+</listitem>
+<listitem><para>Cover handling now more generic (including limited DocBook 5.0 <markup>cover</markup> support thanks to patch contributed by Liza Daly.</para> </listitem>
+<listitem><para>Cover markup now carries more reliably into files destined for .mobi and the Kindle.</para> </listitem>
+<listitem><para><markup>dc:identifiers</markup> are now generated from more types of numbering schemes. </para></listitem>
+<listitem><para>Both SEO and semantic structure of chunked ePub output by ensuring that we always send out one and only one h1 in each XHTML chunk.</para></listitem>
+<listitem>
+<para>Primitive support for embedding a single font added.</para>
+</listitem>
+<listitem>
+<para>Support for embedding a CSS customizations added.</para>
+</listitem>
+
+</varlistentry>
+
+<varlistentry>
+<term>Roundtrip</term>
+
+<listitem>
+<para>Support for imagedata-metadata and <tag>table</tag> as images added.</para>
+</listitem>
+<listitem>
+<para>Support for imagedata-metadata and <tag>legalnotice</tag> as images added.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Params</term>
+<listitem><para><parameter>man.output.better.ps.enabled</parameter> added for Manpages output </para></listitem>
+<listitem>
+<para><parameter>writing.mode.xml</parameter> added to set text direction.</para>
+</listitem>
+<listitem>
+<para>Added new param <parameter>email.mailto.enabled</parameter> for FO output.
+Patch from Paolo Borelli. Closes #2086321.</para>
+</listitem>
+<listitem>
+<para><parameter>highlight.source</parameter> upgraded to support the latest version of XSLTHL 2.0.</para>
+</listitem>
+
+</varlistentry>
+
+
+
+</variablelist>
+</para>
+<para>The following is a list of changes that have been made since the 1.74.0 release.</para>
+
+
+<sect2 xml:id="summary_V1.74.1_Gentext">
+<title>Gentext</title>
+<para>The following changes have been made to the <filename>gentext</filename> code since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/ky.xml; Makefile</literal></para><screen><phrase role="commit-message">new Kirghiz locale from Ilyas Bakirov</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: locale/en.xml</literal></para><screen><phrase role="commit-message">Added "<tag>Acknowledgements</tag>".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Simplified Chinese translation.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml; locale/af.xml;⋯</literal></para><screen><phrase role="commit-message">Add writing-mode gentext string to support right-to-left languages.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Gentext changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_FO">
+<title>FO</title>
+<para>The following changes have been made to the <filename>fo</filename> code since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>David Cramer: footnote.xsl</literal></para><screen><phrase role="commit-message">Added a check to confirm that a <tag>footnoteref</tag>'s linkend points to a <tag>footnote</tag>. Stylesheets stop processing if not and provide a useful error message.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: spaces.xsl</literal></para><screen><phrase role="commit-message">Convert spaces to fo:leader also in elements in the DB 5 namespace.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Added support for a new processing instruction: dbfo funcsynopsis-style.
+Closes bug #1838213.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param <parameter>email.mailto.enabled</parameter> for FO output.
+Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added support for document metadata for fop1 (patch #2067318).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: param.ent; param.xweb; highlight.xsl</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
+ -- nested markup in highlited code is now processed
+ -- it is no longer needed to specify path XSLTHL configuration file using Java property
+ -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the <filename>html</filename> code since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>writing.mode</parameter> to set text direction and <parameter>alignment</parameter> based on document locale.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: chunk-changebars.xsl</literal></para><screen><phrase role="commit-message">Added a new top-level stylesheet module, chunk-changebars.xsl, to be
+used for generating chunked output with highlighting based on change
+(@revisionflag) markup. The module imports/includes the standard chunking
+and changebars templates and contains additional logic for chunked output.
+See FRs #1015180 and #1819915.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the <filename>manpages</filename> code since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Put the following at the top of generated roff for each page:
+ \" t
+purpose is to explicitly tell AT&amp;T troff that the page needs to be
+pre-processed through tbl(1); groff can <tag>figure</tag> it out
+automatically, but apparently AT&amp;T troff needs to be explicitly told</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_Epub">
+<title>ePub</title>
+<para>The following changes have been made to the <filename>epub</filename> code since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/v5cover.xml; bin/spec/sp⋯</literal></para><screen><phrase role="commit-message">Patch contributed by Liza Daly to make ePub <tag>cover</tag> handling more generic. Additionally
+DocBook 5.0's &lt;<tag>cover</tag>&gt; now has some limited support:
+
+- should <tag>reference</tag> a <tag>cover</tag> in the OPF guide for a DocBook 5.0 test document</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/files/biblioid.⋯</literal></para><screen><phrase role="commit-message">Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
+
+Added new tests:
+- should include at least one dc:identifier
+- should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
+- should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
+- should include an <tag>biblioid</tag> as a dc:identifier if an <tag>biblioid</tag> was in the metadata
+- should include a URN for a <tag>biblioid</tag> with @class attribute as a dc:identifier if an <tag>biblioid</tag> was in the metadata</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb</literal></para><screen><phrase role="commit-message">Improve both SEO and semantic structure of chunked ePub output by ensuring that
+we always send out one and only one h1 in each XHTML chunk.
+
+DocBook::Epub
+- should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
+for &lt;<tag>book</tag>&gt;s
+- should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
+for &lt;<tag>book</tag>&gt;s even if they do not have <tag>section</tag> markup</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Adding better support for covers in epub files destined for .mobi and the Kindle</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/DejaVuSerif.otf; docbook.⋯</literal></para><screen><phrase role="commit-message">Adding primitive support for embedding a single font</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/test_cust.xsl; bin/spec/e⋯</literal></para><screen><phrase role="commit-message">Adding support for user-specified customization layers in dbtoepub</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯</literal></para><screen><phrase role="commit-message">Adding CSS support to .epub target &amp; dbtoepub:
+ -c, --css [FILE] Use FILE for CSS on generated XHTML.
+
+
+DocBook::Epub
+...
+- should include a CSS <tag>link</tag> in HTML files when a CSS file has been provided
+- should include CSS file in .epub when a CSS file has been provided
+- should include a CSS <tag>link</tag> in OPF file when a CSS file has been provided</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Epub changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_Roundtrip">
+<title>Roundtrip</title>
+<para>The following changes have been made to the
+ <filename>roundtrip</filename> code
+ since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; template.xml; template.dot</literal></para><screen><phrase role="commit-message">added support for imagedata-metadata
+added support for <tag>table</tag> as images</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl</literal></para><screen><phrase role="commit-message">Improved support for <tag>personname</tag> inlines.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</literal></para><screen><phrase role="commit-message">Added support for <tag>legalnotice</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for <tag>orgname</tag> in <tag>author</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl; wordml2normalise.xsl; dbk2w⋯</literal></para><screen><phrase role="commit-message">Updated specification.
+to-DocBook: add cols attribute to <tag>tgroup</tag>
+from-DocBook: fix for <tag>blockquote</tag> <tag>title</tag></phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Roundtrip changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_Params">
+<title>Params</title>
+<para>The following changes have been made to the <filename>params</filename> since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para>The change was to add man.output.better.ps.enabled parameter, with
+its default value set to zero.
+
+If the value of the man.output.better.ps.enabled parameter is
+non-zero, certain markup is embedded in each generated man page
+such that PostScript output from the man -Tps <tag>command</tag> for that
+page will include a number of enhancements designed to improve the
+quality of that output.
+
+If man.output.better.ps.enabled is zero (the default), no such
+markup is embedded in generated man pages, and no enhancements are
+included in the PostScript output generated from those man pages
+by the man -Tps <tag>command</tag>.
+
+WARNING: The enhancements provided by this parameter rely on
+features that are specific to groff (GNU troff) and that are not
+part of "classic" AT&amp;T troff or any of its derivatives. Therefore,
+any man pages you generate with this parameter enabled will be
+readable only on systems on which the groff (GNU troff) program is
+installed, such as GNU/Linux systems. The pages will not not be
+readable on systems on with the classic troff (AT&amp;T troff) <tag>command</tag>
+is installed.
+
+NOTE: The value of this parameter only affects PostScript output
+generated from the man <tag>command</tag>. It has no effect on output
+generated using the FO backend.
+
+<tag>TIP</tag>: You can generate PostScript output for any man page by
+running the following <tag>command</tag>:
+
+man FOO -Tps &gt; FOO.ps
+
+You can then generate PDF output by running the following <tag>command</tag>:
+
+ps2pdf FOO.ps</para>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: writing.mode.xml</literal></para><screen><phrase role="commit-message">writing mode param used to set text direction.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: email.mailto.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>email.mailto.enabled</parameter> for FO output.
+Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
+ -- nested markup in highlited code is now processed
+ -- it is no longer needed to specify path XSLTHL configuration file using Java property
+ -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.74.1-->
+
+<sect2 xml:id="summary_V1.74.1_Highlighting">
+<title>Highlighting</title>
+<para>The following changes have been made to the
+ <filename>highlighting</filename> code
+ since the 1.74.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl; perl-hl.xml; delphi⋯</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
+ -- nested markup in highlited code is now processed
+ -- it is no longer needed to specify path XSLTHL configuration file using Java property
+ -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Highlighting changes for 1.74.1-->
+
+</sect1>
+
+
+<sect1 xml:id="V1.74.0">
+<title>Release Notes: 1.74.0</title>
+<para>This release includes important bug fixes and adds the following
+significant feature changes:
+<variablelist>
+<varlistentry>
+<term>.epub target</term>
+<listitem><para>Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code that generates <filename>.epub</filename> documents from
+DocBook input. An alpha-reference implementation in Ruby has also been provided.</para>
+<para>.epub is an open standard of the The International Digital Publishing Forum (IDPF),
+a the trade and standards association for the digital publishing industry. </para>
+<para>Read more about this target in <filename>epub/README</filename>
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>XHTML 1.1 target</term>
+<listitem><para>To support .epub output, a strict XHTML 1.1 target has been added. The stylesheets for this output are
+generated and are quite similar to the XHTML target.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>Gentext updates</term>
+<listitem><para>A number of locales have been updated.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>Roundtrip improvements</term>
+<listitem><para>Table, figure, template syncronization, and character style improvements have been made for WordML &amp; Pages. Support added for OpenOffice.org.</para></listitem>
+
+</varlistentry>
+
+<varlistentry>
+ <term>First implementation of a libxslt extension</term>
+ <listitem>
+ <para>A stylesheet extension for libxslt, written in Python, has been added.
+ The extension is a function for adjusting column widths in CALS tables. See
+ <filename>extensions/README.LIBXSLT</filename> for more information.</para>
+ </listitem>
+ </varlistentry>
+
+</variablelist>
+</para>
+<para>The following is a list of changes that have been made
+ since the 1.73.2 release.</para>
+
+<sect2 xml:id="V1.74.0_Gentext">
+<title>Gentext</title>
+<para>The following changes have been made to the
+ <filename>gentext</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/id.xml</literal></para><screen><phrase role="commit-message">Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/lt.xml</literal></para><screen><phrase role="commit-message">Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/hu.xml</literal></para><screen><phrase role="commit-message">fixed error in lowercase.alpha definition in Hungarian locale</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/nb.xml</literal></para><screen><phrase role="commit-message">Corrected language code for nb locale, and restored missing "startquote" key.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
+before.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/nb.xml</literal></para><screen><phrase role="commit-message">Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/no.xml; locale/nb.xml</literal></para><screen><phrase role="commit-message">per message from Hans F. Nordhaug, correct identifier for
+Norwegian Bokmål is "nb" (not "no") and has been for quite some
+time now...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Converted ja.xml source file to use real unicode characters so
+that the actual glyphs so up when you edit it in a text editor
+(instead of the character references).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/it.xml</literal></para><screen><phrase role="commit-message">Changes from Federico Zenith</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Added missing translations.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Gentext changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+ <filename>common</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: l10n.xsl</literal></para><screen><phrase role="commit-message">Added new template "l10.language.name" for retrieving the
+English-language name of the lang setting of the current document.
+Closes #1916837. Thanks to Simon Kennedy.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed syntax error</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed a couple of typos</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined handling of cases where refentry "source" or "manual"
+metadata is missing or when we use fallback content instead. We
+now report a Warning if we use fallback content.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">don't use refmiscinfo@class=date value as fallback for refentry
+"source" or "manual" metadata fields</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Made reporting of missing refentry metadata more quiet:
+
+ - we no longer report anything if usable-but-not-preferred
+ metadata is found; we just quietly use whatever we manage to
+ find
+
+ - we now only report missing "source" metadata if the refentry
+ is missing BOTH "source name" and "version" metadata; if it
+ has one but not the other, we use whichever one it has and
+ don't report anything as missing
+
+The above changes were made because testing with some "real world"
+source reveals that some authors are intentionally choosing to use
+"non preferred" markup for some metadata, and also choosing to
+omit "source name" or "version" metadata in there DocBook XML. So
+it does no good to give them pedantic reminders about what they
+already know...
+
+Also, changed code to cause "fixme" text to be inserted in output
+in particular cases:
+
+ - if we can't manage to find any "source" metadata at all, we
+ now put fixme text into the output
+
+ - if we can't manage to find any "manual" metadata a all, we
+ now put fixme text into the output
+
+The "source" and "manual" metadata is necessary information, so
+buy putting the fixme stuff in the output, we alert users to the
+need problem of it being missing.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">When generating manpages output, we no longer report anything if
+the refentry source is missing date or pubdate content. In
+practice, many users intentionally omit the date from the source
+because they explicitly want it to be generated.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: l10n.xml</literal></para><screen><phrase role="commit-message">further change needed for switch from no locale to nb.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support for orgname in authorgroup. Thanks to Camille
+Bégnis.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: stripns.xsl</literal></para><screen><phrase role="commit-message">Removed the template matching "ng:link|db:link" (in order to make @xlink:show
+work with &lt;link&gt; elements). As far as I can tell, this template is no longer needed.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: entities.ent</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
+Having xref in title is not a problem as long as the target is not an ancestor element.
+Closes bug #1838136.
+
+Note that an xref that is in a title and whose target is an ancestor element is still not
+rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
+see the point in having such an xref in a document.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added a "not(ancestor::title)" test to work around "too many nested
+apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
+Hopefully, this closes bug #1811721.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Removed old template matching "link" in no.anchor.mode mode.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Process &lt;link&gt; in no.anchor.mode mode with the same template as &lt;xref&gt;.
+Closes bug #1759205 (Empty link in no.anchor.mode mode).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">In no.anchor.mode mode, do not output anchors for elements that are descendants
+of &lt;title&gt;. Previously, having inline elements with @id/@xml:id in &lt;title&gt;s
+resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem> <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for keep-together.</phrase></screen> </listitem>
+<listitem> <para><literal>Mauritz Jeanson: task.xsl</literal></para><screen><phrase role="commit-message">Enabled use of the keep-together PI on <tag>task</tag> elements.</phrase></screen> </listitem>
+<listitem>
+<para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">FOP1 requires fo:wrapper for inline index entries, not fo:inline.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fixed non-working inline.or.block template for indexterm wrappers.
+Add fop1 to list of processors using inline.or.block.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1891965 (colsep in entytbl not working).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support for title in revhistory. Closes bug #1842847.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Small doc cleanup (dbfo float-type).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Insert commas between multiple copyright holders.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: autotoc.xsl; division.xsl</literal></para><screen><phrase role="commit-message">Added modifications to support nested set elements. See bug #1853172.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
+and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Updated message about unmatched element.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed typo (refsynopsysdiv -&gt; refsynopsisdiv).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl</literal></para><screen><phrase role="commit-message">Added test to check generate.index param when generating pdf bookmarks</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for MathML in imagedata.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Removed unnecessary extra test condition in test express that
+checks for passivetex.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Don't use fo:instream-foreign-object if we are processing with
+passivetex. Closes #1806899. Thanks to Justus Piater.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: component.xsl</literal></para><screen><phrase role="commit-message">Added code to output a TOC for an appendix in an article when
+generate.toc='article/appendix toc'. Closes bug #1669658.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for dbfo_label-width.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for the dbfo_label-width PI in calloutlists.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Support finding glossary database entries inside bibliodivs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Complete support for &lt;?dbfo pgwide="1"?&gt; for informal
+elements too.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">In the table.block template, added a check for the dbfo_keep-together PI, so that
+a table may break (depending on the PI value) at a page break. This was needed
+since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
+by default, which prevents the table from breaking. Closes bug #1740964 (Titled
+table does not respect dbfo PI).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added a few missing @role="tcg".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Use normalize-space() in glossterm comparisons (as in html/inline.xsl).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
+This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
+with index.on.type=1. Closes bug #1680836.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Added capability in FO output for displaying URLs for all
+hyperlinks (elements marked up with xlink:href attributes) in the
+same way as URLs for ulinks are already handled (which is to say,
+either inline or as numbered footnotes).
+
+Background on this change:
+DocBook 5 allows "ubiquitous" linking, which means you can make
+any element a hyperlink just by adding an xlink:href attribute to
+it, with the value set to an external URL. That's in contrast to
+DocBook 4, which only allows you to use specific elements (e.g.,
+the link and ulink elements) to mark up hyperlinks.
+
+The existing FO stylesheets have a mechanism for handling display
+of URLs for hyperlinks that are marked up with ulink, but they did
+not handle display of URLs for elements that were marked up with
+xlink:href attributes. This change adds handling for those other
+elements, enabling the URLs they link to be displayed either
+inline or as numbered footnotes (depending on what values the user
+has the ulink.show and ulink.footnotes params set to).
+
+Note that this change only adds URL display support for elements
+that call the simple.xlink template -- which currently is most
+(but not all) inline elements.
+
+This change also moves the URL display handling out of the ulink
+template and into a new "hyperlink.url.display" named template;
+the ulink template and the simple.xlink named template now both
+call the hyperlink.url.display template.
+
+Warning: In the stylesheet code that determines what footnote
+number to assign to each footnote or external hyperlink, there is
+an XPath expression for determining whether a particular
+xlink:href instance is an external hyperlink; that expression is
+necessarily a bit complicated and further testing may reveal that
+it doesn't handle all cases as expected -- so some refinements to
+it may need to be done later.
+
+Closes #1785519. Thanks to Ken Morse for reporting and
+troubleshooting the problem.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem> <para><literal>Keith Fahlgren: inline.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Work to make HTML and XHTML targets more valid</phrase></screen> </listitem>
+<listitem> <para><literal>Keith Fahlgren: table.xsl</literal></para><screen><phrase role="commit-message">Add better handling for tables that have footnotes in the titles</phrase></screen> </listitem>
+<listitem> <para><literal>Keith Fahlgren: biblio.xsl</literal></para><screen><phrase role="commit-message">Add anchors to bibliodivs</phrase></screen> </listitem>
+<listitem>
+<para><literal>Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
+and Keith Fahlgren of O'Reilly.</phrase></screen>
+<para>This change includes new code for generating the XHTML 1.1 target sanely.</para>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: biblio.xsl</literal></para><screen><phrase role="commit-message">Added code for creating URLs from biblioids with @class="doi" (representing Digital
+Object Identifiers). See FR #1934434 and http://doi.org.
+
+To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
+for bibliorelation, bibliosource and citebiblioid.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Norman Walsh: formal.xsl</literal></para><screen><phrase role="commit-message">Don't use xsl:copy because it forces the resulting element to be in the same namespace as the source element; in the XHTML stylesheets, that's wrong. But the HTML-to-XHTML converter does the right thing with literal result elements, so use one of them.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
+under Cygwin. This stuff is ugly and maybe not worth the mess and
+trouble, but does seem to work as expected and not break anything
+else.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added "exslt" namespace binding to html/docbook.xsl file (in
+addition to existing "exsl" binding. reason is because lack of it
+seems to cause processing problems when using the profiled
+version of the stylsheet</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Norman Walsh: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Rename link</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Added a fix to make rowsep apply to the last row of thead in entrytbl.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Simplified and streamlined handling of output for ANSI-style
+funcprototype output, to correct a problem that was causing type
+data to be lost in the output parameter definitions. For example,
+for an instance like this:
+ &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
+... the brackets (indicating an array type) were being dropped.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Changed HTML handling of K&amp;R-style paramdef output. The parameter
+definitions are no longer output in a table (though the prototype
+still is). The reason for the change is that the
+kr-tabular-funcsynopsis-mode template was causing type data to be
+lost in the output parameter definitions. For example, for an
+instance like this:
+ &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
+... the brackets (indicating an array type) were being dropped.
+The easiest way to deal with the problem is to not try to chop up
+the parameter definitions and display them in table format, but to
+instead just output them as-is. May not look quite as pretty, but
+at least we can be sure no information is being lost...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">updated wording of doc for funcsynopsis-style PI</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: param.xweb; param.ent; synop.xsl</literal></para><screen><phrase role="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
+being used in the code and hasn't been since mid 2006.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Added missing space.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Norman Walsh: component.xsl</literal></para><screen><phrase role="commit-message">Fix bug where component titles inside info elements were not handled properly</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">Moved dbhtml_stop-chunking embedded doc into alphabetical order,
+fixed text of TCG section it see-also'ed.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: chunk-common.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
+and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @xlink:show in the simple.xlink template. The "new" and "replace"
+values are supported (corresponding to values of "_blank" and "_top" for the
+ulink.target parameter). I have assumed that @xlink:show should override ulink.target
+for external URI links. This closes bugs #1762023 and #1727498.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Add support in biblio collection to entries in bibliodivs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added missing @role="tcg".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</literal></para><screen><phrase role="commit-message">Refactored legalnotice/revhistory chunking, so that the use.id.as.filename
+parameter as well as the dbhtml_filename PI are taken into account. A new named
+template in titlepage.xsl is used to compute the filename.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</literal></para><screen><phrase role="commit-message">An update to the fix for bug #1790495 (r7433):
+The "ln-" prefix is output only when the legalnotice doesn't have an
+@id/@xml:id, in which case the stylesheets generate an ID value,
+resulting in a filename like "ln-7e0fwgj.html". This is useful because
+without the prefix, you wouldn't know that the file contained a legalnotice.
+The same logic is also applied to revhistory, using an "rh-" prefix.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
+This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
+with index.on.type=1. Closes bug #1680836.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the
+&lt;link href"..."&gt; that is output by make.legalnotice.head.links (chunk-common.xsl).
+Modified the href attribute on the legalnotice link.
+Closes bug #1790495.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">slightly adjusted spacing around admonition markers</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">make sure refsect3 titles are preceded by a line of space, and
+make the indenting of their child content less severe</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">only indent verbatim environments in TTY output, not in non-TTY/PS</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">made another adjustment to correct vertical alignment of admonition marker</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">Adjusted/corrected alignment of adominition marker in PS/non-TTY output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">For PS/non-TTY output, display footnote/endnote numbers in
+superscript.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
+and synopfragment such that they now look correct in non-TTY/PS
+output. We now use the groff \w escape to hang by the actual width
+-- in the current font -- of the command, funcdef, or
+synopfragment references number (as opposed to hanging by the
+number of characters). This rendering in TTY output remains the
+same, since the width in monospaced TTY output is the same as the
+number of characters.
+
+Also, created new synopsis-block-start and synopsis-block-end
+templates to use for cmdsynopsis and funcsynopsis instead of the
+corresponding verbatim-* templates.
+
+Along with those changes, also corrected a problem that caused the
+content of synopfragment to be dropped, and made a
+vertical-spacing change to adjust spacing around table titles and
+among sibling synopfragment instances.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">use common l10.language.name template to retrieve English-language name</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl; inline.xsl</literal></para><screen><phrase role="commit-message">added comment in code explaining why we don't put filename output
+in italic (despite the fact that man guidelines say we should)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">put filename output in monospace instead of italic</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">put cmdsynopsis in monospace</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">removed template match for literal. template matches for monospace
+inlines are all imported from the HTML stylesheet</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">don't indent verbatim environments that are descendants of
+refsynopsisdiv, not put backgrounds behind them</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">set output of the literal element in monospace. this causes all
+inline monospace instances in the git man pages to be set in
+monospace (since DocBook XML source for git docs is generated with
+asciidoc and asciidoc consistently outputs only &lt;literal&gt; for
+inline monospace (not &lt;command&gt; or &lt;code&gt; or anything else).
+Of course this only affects non-TTY output...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added inline.monoseq named template.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">don't bother using a custom register to store the previous
+font-family value when setting blocks of text in code font; just
+use \F[] .fam with no arg to switch back</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">put links in blue in PS output (note that this matches how groff
+renders content marked up with the .URL macro)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">removed man.links.are.underlined and added man.font.links. Also,
+changed the default font formatting for links to bold.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param man.base.url.for.relative.links .. specifies a
+base URL for relative links (for ulink, @xlink:href, imagedata,
+audiodata, videodata) shown in the generated NOTES section of
+man-page output. The value of man.base.url.for.relative.links is
+prepended to any relative URI that is a value of ulink url,
+xlink:href, or fileref attribute.
+
+If you use relative URIs in link sources in your DocBook refentry
+source, and you leave man.base.url.for.relative.links unset, the
+relative links will appear "as is" in the NOTES section of any
+man-page output generated from your source. That's probably not
+what you want, because such relative links are only usable in the
+context of HTML output. So, to make the links meaningful and
+usable in the context of man-page output, set a value for
+man.base.url.for.relative.links that points
+to the online version of HTML output generated from your DocBook
+refentry source. For example:
+
+ &lt;xsl:param name="man.base.url.for.relative.links"
+ &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If a source refentry contains a Documentation or DOCUMENTATION
+section, don't report it as having missing AUTHOR information.
+Also, if missing a contrib/personblurb for a person or org, report
+pointers to http://docbook.sf.net/el/personblurb and to
+http://docbook.sf.net/el/contrib</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If we encounter an author|editor|othercredit instance that lacks a
+personblurb or contrib, report it to the user (because that means
+we have no information about that author|editor|othercredit to
+display in the generated AUTHOR|AUTHORS section...)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl</literal></para><screen><phrase role="commit-message">if we can't find any usable author data, emit a warning and insert
+a fixme in the output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">fixed bug in indenting of output for contrib instances in AUTHORS
+section. Thanks to Daniel Leidert and the fglrx docs for exposing
+the bug.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">for a para or simpara that is the first child of a callout,
+suppress the .sp or .PP that would normally be output (because in
+those cases, the output goes into a table cell, and the .sp or .PP
+markup causes a spurious linebreak before it when displayed</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for rendering co callouts and calloutlist instances.
+So you can now use simple callouts -- marking up programlisting
+and such with co instances -- and have the callouts displayed in
+man-page output. ("simple callouts" means using co@id and
+callout@arearefs pointing to co@id instances; in man/roff output,
+we can't/don't support markup that uses areaset and area)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">only put a line of space after a verbatim if it's followed by a
+text node or a paragraph</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">put verbatim environments in slightly smaller font in non-TTY
+output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">minor whitespace-only reformatting of lists.xsl source</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Made refinements/fixes to output of orderedlist and itemizedlist
+-- in part, to get mysql man pages to display correctly. This
+change causes a "\c" continuation marker to be added between
+listitem markers and contents (to ensure that the content remains
+on the same line as the marker when displayed)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put a line of vertical space after all verbatim output that has
+sibling content following it (not just if that sibling content is
+a text node)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">refined spacing around titles for admonitions</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">Deal with case of verbatim environments that have a linebreak
+after the opening tag. Assumption is that users generally don't
+want that linebreak to appear in output, so we do some groff
+hackery to mess with vertical spacing and close the space.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">indexterm instances now produce groff comments like this:
+
+ .\" primary: secondary: tertiary
+
+remark instances, if non-empty, now produce groff comments</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: charmap.groff.xsl; other.xsl</literal></para><screen><phrase role="commit-message">convert no-break space character to groff "\ \&amp;" (instead of just
+"\ "). the reason is that if a space occurs at the end of a line,
+our processing causes it to be eaten. a real-world case of this is
+the mysql(1) man page. appending the "\&amp;" prevents that</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">output "sp" before simpara output, not after it (outputting it
+after results in undesirable whitespace in particular cases; for
+example, in the hg/mercurial docs</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">renamed from title-preamble to pinch.together and replaced "sp -1"
+between synopsis fragments with call to pinch.together instead</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: table.xsl</literal></para><screen><phrase role="commit-message">use title-preamble template for table titles (instead of "sp -1"
+hack), and "sp 1" after all tables (instead of just "sp"</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created title-preamble template for suppressing line spacing after
+headings</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">further refinement of indenting in AUTHORS section</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">refined handling of admonitions</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Use RS/RE in another place where we had IP ""</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
+instead.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: table.xsl; synop.xsl; info.xsl</literal></para><screen><phrase role="commit-message">changed all instances of ".sp -1n" to ".sp -1"</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">add extra line before SH heads only in non-TTY output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Reworked output for admonitions (caution, important, note, tip,
+warning). In TTY output, admonitions now get indented. In non-TTY
+output, a colored marker (yellow) is displayed next to them.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Added BM/EM macros for putting a colored marker in margin next to
+a block of text.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created make.bold.title template by moving title-bolding part out
+from nested-section-title template. This allows the bolding to
+also be used by the template for formatting admonitions</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">put .br before copyright contents to prevent them from getting run in</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">made point size of output for Refsect2 and Refsect3 heads bigger</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">put slightly more space between SH head and underline in non-TTY
+output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: param.xweb; param.ent; other.xsl</literal></para><screen><phrase role="commit-message">Added the man.charmap.subset.profile.english parameter and refined
+the handling of charmap subsets to differentiate between English
+and non-English source.
+
+This way charmap subsets are now handled is this:
+
+If the value of the man.charmap.use.subset parameter is non-zero,
+and your DocBook source is not written in English (that is, if its
+lang or xml:lang attribute has a value other than en), then the
+character-map subset specified by the man.charmap.subset.profile
+parameter is used instead of the full roff character map.
+
+Otherwise, if the lang or xml:lang attribute on the root element
+in your DocBook source or on the first refentry element in your
+source has the value en or if it has no lang or xml:lang
+attribute, then the character-map subset specified by the
+man.charmap.subset.profile.english parameter is used instead of
+man.charmap.subset.profile.
+
+The difference between the two subsets is that
+man.charmap.subset.profile provides mappings for characters in
+Western European languages that are not part of the Roman
+(English) alphabet (ASCII character set).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Various updates, mainly related to uppercasing SH titles:
+
+ - added a "Language: " metadata line to the top comment area of
+ output man pages, to indicate the language the page is in
+
+ - added a "toupper" macro of doing locale-aware uppercasing of
+ SH titles and cross-references to SH titles; the mechanism
+ relies on the uppercase.alpha and lowercase.alpha DocBook
+ gentext keys to do locale-aware uppercasing based on the
+ language the page is written in
+
+ - added a "string.shuffle" template, which provides a library
+ function for "shuffling" two strings together into a single
+ string; it takes the first character for the first string, the
+ first character from second string, etc. The only current use
+ for it is to generate the argument for the groff tr request
+ that does string uppercasing.
+
+ - added make.tr.uppercase.arg and make.tr.normalcase.arg named
+ templates for use in generating groff code for uppercasing and
+ "normal"-casing SH titles
+
+ - made the BB/BE "background drawing" macros have effect only in
+ non-TTY output
+
+ - output a few comments in the top part of source</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">removed some leftover kruft</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">To create the name(s) for each man page, we now replace any spaces
+in the refname(s) with underscores. This ensures that tools like
+lexgrog(1) will be able to parse the name (lexgrog won't parse
+names that contain spaces).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Put a comment into source of man page to indicate where the main
+content starts. (We now have a few of macro definitions at the
+start of the source, so putting this comment in helps those that
+might be viewing the source.)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined mechanism for generating SH titles</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: charmap.groff.xsl</literal></para><screen><phrase role="commit-message">Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
+This means that generated Finnish man pages will no longer contain
+any raw accented characters -- they'll instead by marked up with
+groff escapes.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">corrected a regression I introduced about a year ago that caused
+dots to be output just as "\." -- instead needs to be "\&amp;." (which
+is what it will be now, after this change)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Changed backend handling for generating titles for SH sections and
+for cross-references to those sections. This should have no effect
+on TTY output (behavior should remain the same hopefully) but
+results in titles in normal case (instead of uppercase) in PS
+output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">use make.subheading template to make subheadings for AUTHORS and
+COPYRIGHT sections (instead of harcoding roff markup)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put code font around programlisting etc.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl; docbook.xsl</literal></para><screen><phrase role="commit-message">embed custom macro definitions in man pages, plus wrap synopsis in
+code font</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">use the make.subheading template to generated SH subheading for
+endnotes section.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added some templates for generating if-then-else conditional
+markup in groff, so let's use those instead of hard-coding it in
+multiple places...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">Initial checkin of some changes related to making PS/PDF output
+from "man -l -Tps" look better. The current changes:
+
+ - render synopsis and verbatim sections in a monospace/code font
+
+ - put a light-grey background behind all programlisting, screen,
+ and literallayout instances
+
+ - prevent SH heads in PS output from being rendered in uppercase
+ (as they are in console output)
+
+ - also display xrefs to SH heads in PS output in normal case
+ (instead of uppercase)
+
+ - draw a line under SH heads in PS output
+
+The changes made to the code to support the above features were:
+
+ - added some embedded/custom macros: one for conditionally
+ upper-casing SH x-refs, one for redefining the SH macro
+ itself, with some conditional handling for PS output, and
+ finally a macro for putting a background/screen (filled box)
+ around a block of text (e.g., a program listing) in PS output
+
+ - added utility templates for wrapping blocks of text in code
+ font; also templates for inline code font</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">refpurpose nodes now get apply-templates instead of just normalize-space().</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed alignment of first lined of text for each listitem in
+orderedlist output for TTY. Existing code seemed to have been
+causing an extra undesirable space to appear.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Wrapped some roff conditionals around roff markup for orderedlist
+and itemizedlist output, so that the lists look acceptable in PS
+output as well as TTY.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added the man.funcsynopsis.style parameter. Has the same effect in
+manpages output as the funcsynopsis.style parameter has in HTML
+output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
+on the HTML kr-tabular templates, but instead just does direct
+transformation to roff. For K&amp;R output, it displays the paramdef
+output in an indented list following the prototype.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Properly integrated handling for K&amp;R output into manpages
+stylesheet. The choice between K&amp;R output and ANSI output is
+currently controlled through use of the (HTML) funcsynopsis.style
+parameter. Note that because the mechanism does currently rely on
+funcsynopsis.style, the default in manpages output is now K&amp;R
+(because that's the default of that param). But I suppose I ought
+to create a man.funcsynopsis.style and make the default for that
+ANSI (to preserve the existing default behavior).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added manpages/pi.xsl file</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: .cvsignore; pi.xsl</literal></para><screen><phrase role="commit-message">Added "dbman funcsynopsis-style" PI and incorporated it into the
+doc build.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed regression that caused an unescaped dash to be output
+between refname and refpurpose content. Closes bug #1894244.
+Thanks to Daniel Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with dots being escaped in filenames of generated
+man files. Closes #1827195. Thanks to Daniel Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for processing structfield (was appearing in roff
+output surrounded by HTML &lt;em&gt; tags; fixed so that it gets roff
+ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Epub">
+<title>Epub</title>
+<para>The following changes have been made to the
+ <filename>epub</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem> <para><literal>Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb</literal></para><screen><phrase role="commit-message">'Realbook' spec now passes</phrase></screen> </listitem>
+<listitem> <para><literal>Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb; bin/spec/epub_r⋯</literal></para><screen><phrase role="commit-message">Very primitive Windows support for dbtoepub <tag>reference</tag> implementation; README for running tests and for the .epub target in general; shorter realbook test document (still fails for now)</phrase></screen> </listitem>
+<listitem> <para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯</literal></para><screen><phrase role="commit-message">Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same</phrase></screen> </listitem>
+<listitem> <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixing linking to <tag>cover</tag> @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)</phrase></screen> </listitem>
+<listitem> <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Updating the <tag>title</tag> of the <tag>toc</tag> element in the guide to be more explicit (thanks to Martin Goerner)</phrase></screen> </listitem>
+<listitem>
+<para><literal>Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/examples/amasque_⋯</literal></para><screen><phrase role="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
+and Keith Fahlgren of O'Reilly.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">== General epub test support
+
+$ spec -O ~/.spec.opts spec/epub_spec.rb
+
+DocBook::Epub
+- should be able to be created
+- should fail on a nonexistent file
+- should be able to render to a file
+- should create a file after rendering
+- should have the correct mimetype after rendering
+- should be valid .epub after rendering an article
+- should be valid .epub after rendering an article without sections
+- should be valid .epub after rendering a book
+- should be valid .epub after rendering a book even if it has one graphic
+- should be valid .epub after rendering a book even if it has many graphics
+- should be valid .epub after rendering a book even if it has many duplicated graphics
+- should report an empty file as invalid
+- should confirm that a valid .epub file is valid
+- should not include PDFs in rendered epub files as valid image inclusions
+- should include a TOC link in rendered epub files for &lt;book&gt;s
+
+Finished in 20.608395 seconds
+
+15 examples, 0 failures
+
+
+== Verbose epub test coverage against _all_ of the testdocs
+
+Fails on only (errors truncated):
+1)
+'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/calloutlist.003.xml [30]' FAILED
+'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/cmdsynopsis.001.xml [35]' FAILED
+....
+
+Finished in 629.89194 seconds
+
+224 examples, 15 failures
+
+224 examples, 15 failures yields 6% failure rate</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Epub changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_HTMLHelp">
+<title>HTMLHelp</title>
+<para>The following changes have been made to the
+ <filename>htmlhelp</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
+the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
+This makes chunk.quietly=1 suppress chunk filename messages also for help
+support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTMLHelp changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Eclipse">
+<title>Eclipse</title>
+<para>The following changes have been made to the
+ <filename>eclipse</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Use sortas attributes (if they exist) when sorting indexterms</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added support for indexterm/see in eclipse index.xml</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt;
+to helpidx template.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
+the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
+This makes chunk.quietly=1 suppress chunk filename messages also for help
+support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Eclipse changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_JavaHelp">
+<title>JavaHelp</title>
+<para>The following changes have been made to the
+ <filename>javahelp</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
+the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
+This makes chunk.quietly=1 suppress chunk filename messages also for help
+support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of JavaHelp changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Roundtrip">
+<title>Roundtrip</title>
+<para>The following changes have been made to the
+ <filename>roundtrip</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">fix table/cell borders for wordml, fix formal figure, add emphasis-strong</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: supported.xml</literal></para><screen><phrase role="commit-message">Changed @cols to 5.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</literal></para><screen><phrase role="commit-message">added pubdate, fixed metadata handling in biblioentry</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: supported.xml</literal></para><screen><phrase role="commit-message">Added support for edition.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl; pages-normalise⋯</literal></para><screen><phrase role="commit-message">Removed stylesheets for old, deprecated conversion method.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl; blocks2dbk.dtd⋯</literal></para><screen><phrase role="commit-message">Added support for Open Office, added edition element, improved list and table support in Word and Pages</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl; template-pages.xml; templ⋯</literal></para><screen><phrase role="commit-message">Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">fix caption, attributes</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl; blocks2dbk.dtd; temp⋯</literal></para><screen><phrase role="commit-message">Fixes to table and list handling</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">added support for explicit emphasis character styles</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for customisation in image handling</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">Added inlinemediaobject support for metadata.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml; dbk2wordml.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">Added support file. Added style locking. Conversion bug fixes.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Roundtrip changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Slides">
+<title>Slides</title>
+<para>The following changes have been made to the
+ <filename>slides</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: fo/Makefile; html/Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
+under Cygwin. This stuff is ugly and maybe not worth the mess and
+trouble, but does seem to work as expected and not break anything
+else.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: html/plain.xsl</literal></para><screen><phrase role="commit-message">Added support for showing foil number</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Slides changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Website">
+<title>Website</title>
+<para>The following changes have been made to the
+ <filename>website</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/xalan2/.classes/com/⋯</literal></para><screen><phrase role="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Website changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem> <para><literal>Keith Fahlgren: epub.autolabel.xml</literal></para><screen><phrase role="commit-message">New parameter for epub, epub.autolabel</phrase></screen> </listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml; table.cell.border.t⋯</literal></para><screen><phrase role="commit-message">Added missing refpurposes and descriptions.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Keith Fahlgren: ade.extensions.xml</literal></para><screen><phrase role="commit-message">Extensions to support Adobe Digital Editions extensions in .epub output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml</literal></para><screen><phrase role="commit-message">Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.links.are.underlined.xml; man.endnotes.list.enabled.xml; man.font.l⋯</literal></para><screen><phrase role="commit-message">removed man.links.are.underlined and added man.font.links. Also,
+changed the default font formatting for links to bold.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.base.url.for.relative.links.xml</literal></para><screen><phrase role="commit-message">Added new param man.base.url.for.relative.links .. specifies a
+base URL for relative links (for ulink, @xlink:href, imagedata,
+audiodata, videodata) shown in the generated NOTES section of
+man-page output. The value of man.base.url.for.relative.links is
+prepended to any relative URI that is a value of ulink url,
+xlink:href, or fileref attribute.
+
+If you use relative URIs in link sources in your DocBook refentry
+source, and you leave man.base.url.for.relative.links unset, the
+relative links will appear "as is" in the NOTES section of any
+man-page output generated from your source. That's probably not
+what you want, because such relative links are only usable in the
+context of HTML output. So, to make the links meaningful and
+usable in the context of man-page output, set a value for
+man.base.url.for.relative.links that points
+to the online version of HTML output generated from your DocBook
+refentry source. For example:
+
+ &lt;xsl:param name="man.base.url.for.relative.links"
+ &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.string.subst.map.xml</literal></para><screen><phrase role="commit-message">squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
+line of whitespace from being inserted after programlisting etc.
+in certain cases)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.manual.fallback.profile.xml; refentry.source.fallback.profile.⋯</literal></para><screen><phrase role="commit-message">don't use refmiscinfo@class=date value as fallback for refentry
+"source" or "manual" metadata fields</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su⋯</literal></para><screen><phrase role="commit-message">made some further doc tweaks related to the
+man.charmap.subset.profile.english param</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su⋯</literal></para><screen><phrase role="commit-message">Added the man.charmap.subset.profile.english parameter and refined
+the handling of charmap subsets to differentiate between English
+and non-English source.
+
+This way charmap subsets are now handled is this:
+
+If the value of the man.charmap.use.subset parameter is non-zero,
+and your DocBook source is not written in English (that is, if its
+lang or xml:lang attribute has a value other than en), then the
+character-map subset specified by the man.charmap.subset.profile
+parameter is used instead of the full roff character map.
+
+Otherwise, if the lang or xml:lang attribute on the root element
+in your DocBook source or on the first refentry element in your
+source has the value en or if it has no lang or xml:lang
+attribute, then the character-map subset specified by the
+man.charmap.subset.profile.english parameter is used instead of
+man.charmap.subset.profile.
+
+The difference between the two subsets is that
+man.charmap.subset.profile provides mappings for characters in
+Western European languages that are not part of the Roman
+(English) alphabet (ASCII character set).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml</literal></para><screen><phrase role="commit-message">Added to default charmap used by manpages:
+
+ - the "letters" part of the 'C1 Controls And Latin-1 Supplement
+ (Latin-1 Supplement)' Unicode block
+ - Latin Extended-A block (but not all of the characters from
+ that block have mappings in groff, so some of them are still
+ passed through as-is)
+
+The effects of this change are that in man pages generated for
+most Western European languages and for Finnish, all characters
+not part of the Roman alphabet are (e.g., "accented" characters)
+are converted to groff escapes.
+
+Previously, by default we passed through those characters as is
+(and users needed to use the full charmap if they wanted to have
+those characters converted).
+
+As a result of this change, man pages generated for Western
+European languages will be viewable in some environments in which
+they are not viewable if the "raw" non-Roman characters are in them.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: generate.legalnotice.link.xml; generate.revhistory.link.xml</literal></para><screen><phrase role="commit-message">Added information on how the filename is computed.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: default.table.width.xml</literal></para><screen><phrase role="commit-message">Clarified PI usage.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.funcsynopsis.style.xml</literal></para><screen><phrase role="commit-message">Added the man.funcsynopsis.style parameter. Has the same effect in
+manpages output as the funcsynopsis.style parameter has in HTML
+output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: funcsynopsis.tabular.threshold.xml</literal></para><screen><phrase role="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
+being used in the code and hasn't been since mid 2006.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: table.properties.xml</literal></para><screen><phrase role="commit-message">Set keep-together.within-column to "auto". This seems to be the most sensible
+default value for tables.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: informal.object.properties.xml; admon.graphics.extension.xml; informalequ⋯</literal></para><screen><phrase role="commit-message">Several small documentation fixes.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: manifest.in.base.dir.xml</literal></para><screen><phrase role="commit-message">Wording fixes.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: header.content.properties.xml; footer.content.properties.xml</literal></para><screen><phrase role="commit-message">Added refpurpose.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml</literal></para><screen><phrase role="commit-message">Updated for DocBook 5.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml</literal></para><screen><phrase role="commit-message">Spelling and wording fixes.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarifed available graphics formats and extensions.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: footnote.sep.leader.properties.xml</literal></para><screen><phrase role="commit-message">Corrected refpurpose.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: footnote.properties.xml</literal></para><screen><phrase role="commit-message">Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">img.src.path works with inlinegraphic too.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: saxon.character.representation.xml</literal></para><screen><phrase role="commit-message">Added TCG link.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">Updated description of img.src.path. Bug #1785224 revealed that
+there was a risk of misunderstanding how it works.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Profiling">
+<title>Profiling</title>
+<para>The following changes have been made to the
+ <filename>profiling</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Jirka Kosek: xsl2profile.xsl</literal></para><screen><phrase role="commit-message">Added new rules to profile all content generated by HTML Help (including alias files)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: profile-mode.xsl</literal></para><screen><phrase role="commit-message">use mode="profile" instead of xsl:copy-of for attributes so
+they can be more easily customized.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Profiling changes for 1.74.0-->
+
+
+<sect2 xml:id="V1.74.0_Tools">
+<title>Tools</title>
+<para>The following changes have been made to the
+ <filename>tools</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: make/Makefile.DocBook</literal></para><screen><phrase role="commit-message">various changes and additions to support making with asciidoc as
+an input format</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: make/Makefile.DocBook</literal></para><screen><phrase role="commit-message">make dblatex the default PDF maker for the example makefile</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
+on the HTML kr-tabular templates, but instead just does direct
+transformation to roff. For K&amp;R output, it displays the paramdef
+output in an indented list following the prototype.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: xsl/build/make-xsl-params.xsl</literal></para><screen><phrase role="commit-message">Made attribute-sets members of the param list. This enables links to attribute-sets in the
+reference documentation.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">use .BI handling in K&amp;R funsynopsis output for manpages, just as
+we do already of ANSI output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Implemented initial support for handling tabular K&amp;R output of
+funcprototype in manpages output. Accomplished by adding more
+templates to the intermediate HTML-to-roff stylesheet that the
+build uses to create the manpages/html-synop.xsl stylesheet.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: xsl/build/doc-link-docbook.xsl</literal></para><screen><phrase role="commit-message">Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
+import profile-docbook.xsl, so that we can do profiling of release
+notes. Corrected some problems in the target for the release-notes
+HTML build.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Tools changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_Extensions">
+<title>Extensions</title>
+<para>The following changes have been made to the
+ <filename>extensions</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem> <para><literal>Keith Fahlgren: Makefile</literal></para><screen><phrase role="commit-message">Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER</phrase></screen> </listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">moved extensions build targets from master xsl/Makefile to
+xsl/extensions/Makefile</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: .cvsignore</literal></para><screen><phrase role="commit-message">re-adding empty extensions subdir</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Extensions changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_XSL-Saxon">
+<title>XSL-Saxon</title>
+<para>The following changes have been made to the
+ <filename>xsl-saxon</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: VERSION</literal></para><screen><phrase role="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
+recent change to snapshot build infrastructure</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties</literal></para><screen><phrase role="commit-message">Changed hard-coded file references in "clean" target to variable
+references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: VERSION; Makefile</literal></para><screen><phrase role="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test</literal></para><screen><phrase role="commit-message">More tweaks to get release-ready</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-Saxon changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_XSL-Xalan">
+<title>XSL-Xalan</title>
+<para>The following changes have been made to the
+ <filename>xsl-xalan</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: VERSION</literal></para><screen><phrase role="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
+recent change to snapshot build infrastructure</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: nbproject/build-impl.xml</literal></para><screen><phrase role="commit-message">Changed hard-coded file references in "clean" target to variable
+references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile; VERSION</literal></para><screen><phrase role="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION</literal></para><screen><phrase role="commit-message">More tweaks to get release-ready</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-Xalan changes for 1.74.0-->
+
+<sect2 xml:id="V1.74.0_XSL-libxslt">
+<title>XSL-libxslt</title>
+<para>The following changes have been made to the
+ <filename>xsl-libxslt</filename> code
+ since the 1.73.2 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: python/xslt.py</literal></para><screen><phrase role="commit-message">Print the result to stdout if no outfile has been given.
+Some unnecessary semicolons removed.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: python/xslt.py</literal></para><screen><phrase role="commit-message">Added a function that quotes parameter values (to ensure that they are interpreted as strings).
+Replaced deprecated functions from the string module with string methods.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: python/README; python/README.LIBXSLT</literal></para><screen><phrase role="commit-message">renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: python/README</literal></para><screen><phrase role="commit-message">Tweaked the text a little.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-libxslt changes for 1.74.0-->
+
+</sect1>
+
+<sect1 xml:id="V1.73.2">
+<title>Release Notes: 1.73.2</title>
+<para>This is solely a minor bug-fix update to the 1.73.1 release.
+ It fixes a packaging error in the 1.73.1 package, as well as a
+ bug in footnote handling in FO output.</para>
+</sect1>
+
+<sect1 xml:id="V1.73.1">
+<title>Release: 1.73.1</title>
+<para>This is mostly a bug-fix update to the 1.73.0 release.</para>
+
+<sect2 xml:id="V1.73.1_Gentext">
+<title>Gentext</title>
+<para>The following changes have been made to the
+ <filename>gentext</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: locale/de.xml</literal></para><screen><phrase role="commit-message">Applied patch #1766009.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/lv.xml</literal></para><screen><phrase role="commit-message">Added localization for <tag>ProductionSet</tag>.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Gentext changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Modified the <tag>tgroup</tag> 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.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Replaced useless &lt;a&gt; elements with warning messages (textinsert extension).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: admon.xsl</literal></para><screen><phrase role="commit-message">Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
+references in the <tag>index</tag> can be created. Closes bug #1775086.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:call-template name="process.footnotes"/&gt; to <tag>abstract</tag> template
+so that footnotes in <tag>info</tag>/<tag>abstract</tag> are processed. Closes bug #1760907.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Changed handling of HTML output for the <tag>cmdsynopsis</tag> and
+<tag>funcsynopsis</tag> 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 <tag>reference</tag> docs for the
+dbcmdlist and dbfunclist PIs to make it clear that they can be
+used within any element for which <tag>cmdsynopsis</tag> or <tag>funcsynopsis</tag> are
+valid children.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: formal.xsl</literal></para><screen><phrase role="commit-message">Reverted the part of <tag>revision</tag> 6952 that caused a@id anchors to be
+generated for output of informal objects. Thanks to Sam Steingold
+for reporting.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">Account for a <tag>glossary</tag> with no <tag>glossdiv</tag> or <tag>glossentry</tag> children.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Modified <tag>legalnotice</tag> template so that the base.name parameter is calculated
+in the same way as for <tag>revhistory</tag> chunks. Using &lt;xsl:apply-templates
+mode="chunk-filename" select="."/&gt; did not work for single-page output since
+the template with that mode is in chunk-code.xsl.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Updated support for SVG (must be a child of <tag>imagedata</tag> in DB 5).
+Added support for MathML in <tag>imagedata</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added documentation for the dbhh PI (used for context-sensitive HTML Help).
+(The two templates matching 'dbhh' are still in htmlhelp-common.xsl).</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, generate warnings about notesources with
+non-para children only if the notesource is a <tag>footnote</tag> or
+<tag>annotation</tag>. Thanks to Sam Steingold for reporting problems with
+the existing handling.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_HTMLHelp">
+<title>HTMLHelp</title>
+<para>The following changes have been made to the
+ <filename>htmlhelp</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
+eclipse, and javahelp stylesheets.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTMLHelp changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_Eclipse">
+<title>Eclipse</title>
+<para>The following changes have been made to the
+ <filename>eclipse</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
+eclipse, and javahelp stylesheets.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Eclipse changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_JavaHelp">
+<title>JavaHelp</title>
+<para>The following changes have been made to the
+ <filename>javahelp</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
+eclipse, and javahelp stylesheets.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of JavaHelp changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_Roundtrip">
+<title>Roundtrip</title>
+<para>The following changes have been made to the
+ <filename>roundtrip</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl</literal></para><screen><phrase role="commit-message">Modularised blocks2dbk to allow customisation,
+Added support for tables to pages2normalise</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Roundtrip changes for 1.73.1-->
+
+<sect2 xml:id="V1.73.1_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.73.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: procedure.properties.xml</literal></para><screen><phrase role="commit-message"><tag>procedure</tag> was inheriting keep-together from formal.object.properties, but
+a <tag>procedure</tag> does not need to be kept together by default.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Dave Pawson: title.font.family.xml; component.label.includes.part.label.xml; table.frame.b⋯</literal></para><screen><phrase role="commit-message">Regular formatting re-org.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.73.1-->
+</sect1>
+
+<sect1 xml:id="V1.73.0">
+<title>Release: 1.73.0</title>
+<para>This release includes important bug fixes and adds the following
+significant feature changes:
+<variablelist>
+ <varlistentry>
+ <term>New localizations and localization updates</term>
+ <listitem>
+ <para>We added two new localizations: Latvian and
+ Esperanto, and made updates to the Czech, Chinese
+ Simplified, Mongolian, Serbian, Italian, and Ukrainian
+ localizations.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ISO690 citation style for bibliography output.</term>
+ <listitem>
+ <para>Set the
+ <parameter>bibliography.style</parameter> parameter to
+ <literal>iso690</literal> to use ISO690 style.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>New documentation for processing instructions (PI)</term>
+ <listitem>
+ <para>The reference documentation that ships with the
+ release now includes <link
+ xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/pi/"
+ >documentation on all PIs</link> that you can use to
+ control output from the stylesheets.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>New profiling parameters for <literal>audience</literal> and <literal>wordsize</literal></term>
+ <listitem>
+ <para>You can now do profiling based on the values of the
+ <literal>audience</literal> and
+ <literal>wordsize</literal> attributes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Changes to man-page output</term>
+ <listitem>
+ <para>The manpages stylesheet now supports single-pass
+ profiling and single-pass DocBook 5 namespace stripping
+ (just as the HTML and FO stylesheets also do). Also, added
+ handling for <tag>mediaobject</tag> &amp;
+ <tag>inlinemediaobject</tag>. (Each <tag>imagedata</tag>,
+ <tag>audiodata</tag>, or <tag>videodata</tag> element
+ within a <tag>mediaobject</tag> or inline
+ <tag>mediaobject</tag> is now treated as a "notesource"
+ and so handled in much the same way as links and
+ <tag>annotation</tag>/<tag>alt</tag>/<tag>footnote</tag>
+ are in manpages output.) And added the
+ <parameter>man.authors.section.enabled</parameter> and
+ <parameter>man.copyright.section.enabled</parameter>
+ parameters to enable control over whether output includes
+ auto-generated <literal>AUTHORS</literal> and
+ <literal>COPYRIGHT</literal> sections.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Highlighting support for C</term>
+ <listitem>
+ <para>The highlighting mechanism for generating
+ syntax-highlighted code snippets in output now supports C
+ code listings (along with Java, PHP, XSLT, and others).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Experimental <literal>docbook-xsl-update script</literal></term>
+ <listitem>
+ <para>We added an experimental <literal>docbook-xsl-update
+ script</literal>, the purpose of which is to facilitate
+ easy sync-up to the latest docbook-xsl snapshot (by means
+ of rsync).</para>
+ </listitem>
+ </varlistentry>
+</variablelist>
+</para>
+
+<sect2 xml:id="V1.73.0_Gentext">
+<title>Gentext</title>
+<para>The following changes have been made to the
+<filename>gentext</filename> code
+since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/lv.xml; Makefile</literal></para><screen><phrase role="commit-message">Added Latvian localization file, from Girts Ziemelis.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Brought up to <tag>date</tag> with en.xml in terms of items. A few strings marked for translation.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Added missing translations</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/eo.xml</literal></para><screen><phrase role="commit-message">New locale for Esperanto.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/mn.xml</literal></para><screen><phrase role="commit-message">Update from Ganbold Tsagaankhuu.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: locale/en.xml; locale/cs.xml</literal></para><screen><phrase role="commit-message">Rules for normalizing <tag>glossary</tag> entries before they are sorted can be now different for each language.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml</literal></para><screen><phrase role="commit-message">Committed changes from Miloš Komarčević to Serbian files.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/ja.xml</literal></para><screen><phrase role="commit-message">Fix <tag>chapter</tag> in context xref-number-and-title</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: locale/it.xml</literal></para><screen><phrase role="commit-message">Improved version from contributor.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: locale/uk.xml</literal></para><screen><phrase role="commit-message">Applied patch 1592083.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Gentext changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+<filename>common</filename> code
+since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: labels.xsl</literal></para><screen><phrase role="commit-message">Changed handling of <tag>reference</tag> auto-labeling such that <tag>reference</tag>
+(when it appears at the component level) is now affected by the
+<parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
+<tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Refined logging output of <tag>refentry</tag> metadata-gathering template;
+for some cases of "missing" elements (<tag>refmiscinfo</tag> stuff, etc.),
+the log messages now include URL to corresponding page in the
+Definitive Guide (TDG).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add <tag>refsection</tag>/<tag>info</tag>/<tag>title</tag> support.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: titles.xsl</literal></para><screen><phrase role="commit-message">Added support for correct handling of <tag>xref</tag> to elements that
+contain <tag>info</tag>/<tag>title</tag> descendants but no <tag>title</tag> children.
+
+This should be further refined so that it handles any *<tag>info</tag>
+elements. And there are probably some other places where similar
+handling for *<tag>info</tag>/<tag>title</tag> should be added.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Modified &lt;xsl:when&gt; in datetime.format template to work
+around Xalan bug.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+<filename>fo</filename> code
+since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add parameters to the page.sequence utility template.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: xref.xsl</literal></para><screen><phrase role="commit-message">Added template for <tag>xref</tag> to <tag>area</tag>/<tag>areaset</tag>.
+Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added template match for <tag>person</tag> element to fo stylesheet.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for spacing="compact" in <tag>variablelist</tag>, per bug report #1722540.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message"><tag>table</tag> pgwide="1" should also use pgwide.properties attribute-set.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new profiling parameters for audience and wordsize.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added <parameter>callout.icon.size</parameter> parameter.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink as <tag>olink</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: autotoc.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add support for <parameter>qanda.in.toc</parameter> to fo <tag>TOC</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Improved the page.sequence utility template for use with <tag>book</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Refactored the big <tag>book</tag> template into smaller pieces.
+Used the "page.sequence" utility template in
+component.xsl to shorten the <tag>toc</tag> piece.
+Added placeholder templates for front.cover and back.cover.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent; sections.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>section.container.element</parameter> parameter to enable
+pgwide spans inside sections.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent; component.xsl</literal></para><screen><phrase role="commit-message">Add component.titlepage.properties attribute-set to
+support span="all" and other properties.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: htmltbl.xsl; table.xsl</literal></para><screen><phrase role="commit-message">Apply table.row.properties template to html <tag>tr</tag> rows too.
+Add keep-with-next to table.row.properties when <tag>row</tag> is in <tag>thead</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>default.table.frame</parameter> parameter.
+Fix bug 1575446 rowsep last check for @morerows.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>info</tag>/<tag>title</tag> in refsections.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Make fo questions and answers behave the same way as html</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: lists.xsl</literal></para><screen><phrase role="commit-message">Added missing attribute set for <tag>procedure</tag></phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
+New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
+The code was provided by Jana Dvorakova</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add header.table.properties and footer.table.properties attribute-sets.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>fop1.extensions</parameter> for <tag>menuchoice</tag> arrow handling exception.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Moved declaration and documentation of <parameter>javahelp.encoding</parameter> from javahelp.xsl to the
+regular "parameter machinery".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: admon.xsl</literal></para><screen><phrase role="commit-message">Changed handling of titles for note, warning, <tag>caution</tag>, <tag>important</tag>,
+<tag>tip</tag> admonitions: We now output and HTML h3 head only if
+<parameter>admon.textlabel</parameter> is non-zero or if the admonition actually contains
+a <tag>title</tag>; otherwise, we don't output an h3 head at all.
+(Previously, we were outputting an empty h3 if the <parameter>admon.textlabel</parameter>
+was zero and if the admonition had no title.)</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: xref.xsl</literal></para><screen><phrase role="commit-message">Added template for <tag>xref</tag> to <tag>area</tag>/<tag>areaset</tag>.
+Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl</literal></para><screen><phrase role="commit-message">Added fixes to avoid duplicate ids when <parameter>generate.id.attributes</parameter> = 1.
+This (hopefully) closes bug #1671052.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: formal.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Made the dbfunclist PI work as intended. Also added doc for
+dbfunclist and dbcmdlist PIs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Made the dbcmdlist work the way it appears to have been intended
+to work. Restored dbhtml-dir template back to pi.xsl.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
+If non-zero, in output of the <tag>abstract</tag> element on titlepages,
+display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
+Because sometimes you really don't want or need that <tag>title</tag>
+there...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: chunk-code.xsl; graphics.xsl</literal></para><screen><phrase role="commit-message">When we are chunking long descriptions for <tag>mediaobject</tag> instances
+into separate HTML output files, and <parameter>use.id.as.filename</parameter> is
+non-zero, if a <tag>mediaobject</tag> 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 <tag>legalnotice</tag>
+instances to be used as basenames for <tag>legalnotice</tag> chunks.
+Also, made some minor refinements to the recent changes for
+<tag>legalnotice</tag> chunk handling.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
+<tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: chunk-code.xsl</literal></para><screen><phrase role="commit-message">When $generate.legalnotice.link is non-zero and
+$use.id.as.filename is also non-zero, if a <tag>legalnotice</tag> has an ID,
+then instead of assigning the "ln-&lt;generatedID&gt;" basename to the
+output file for that <tag>legalnotice</tag>, just use its real ID as the
+basename for the file -- as we do when chunking other elements
+that have IDs.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>alt</tag> text on xrefs to steps when the step doesn't have a <tag>title</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>term</tag> in <tag>variablelist</tag> when formatted as <tag>table</tag> to avoid misalignment of <tag>term</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>question</tag> and <tag>answer</tag> labels to avoid misalignment of <tag>label</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around callouts to avoid misalignment of <tag>callout</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add support for new profiling attributes audience and wordsize.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink olinks.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: glossary.xsl</literal></para><screen><phrase role="commit-message">Rules for normalizing <tag>glossary</tag> entries before they are sorted can be now different for each language.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl</literal></para><screen><phrase role="commit-message">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.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add <tag>anchor</tag> for xml:id for <tag>listitem</tag> in <tag>varlistentry</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>info</tag>/<tag>title</tag> in refsections for db5.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
+New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
+The code was provided by Jana Dvorakova</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add call to class.attribute to &lt;a&gt; output elements so they can
+have a class value too.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: glossary.xsl</literal></para><screen><phrase role="commit-message">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.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: param.xweb; docbook.xsl; param.ent</literal></para><screen><phrase role="commit-message">Added the <parameter>man.authors.section.enabled</parameter> and
+<parameter>man.copyright.section.enabled</parameter> parameters. Set those to zero when
+you want to suppress display of the auto-generated AUTHORS and
+<tag>COPYRIGHT</tag> sections. Closes request #1467806. Thanks to Daniel
+Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Took the test that the manpages stylesheet does to see if there
+are any <tag>Refentry</tag> 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.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added a manpages/profile-docbook.xsl file to enable single-pass
+profiling for manpages output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">Output <tag>copyright</tag> and <tag>legalnotice</tag> in man-page output in whatever
+place they are in in document order. Closes #1690539. Thanks to
+Daniel Leidert for reporting.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Restored support for single-pass namespace stripping to manpages
+stylesheet.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl; endnotes.xsl; ut⋯</literal></para><screen><phrase role="commit-message">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 <tag>info</tag> 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.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Fixed handling of example instances by adding the example element
+to the same template we use for processing <tag>figure</tag>. Closes
+#1674538. Thanks to Daniel Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Don't include lang in manpages <tag>filename</tag>/pathname if lang=en (that
+is, only generate lang-qualified file-/pathnames for non-English).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, emit warnings for notesources (<tag>footnote</tag>, etc.)
+that have something other than <tag>para</tag> as a child.
+
+The numbered-with-hanging-indent formatting that's used for
+rendering endnotes in the NOTES <tag>section</tag> of man pages places some
+limits/assumptions on how the DocBook source is marked up; namely,
+for notesources (<tag>footnote</tag>, <tag>annotation</tag>, etc.) that can contain
+block-level children, if the they have a block-level child such as
+a <tag>table</tag> or <tag>itemizedlist</tag> or <tag>orderedlist</tag> that is the first child of
+a <tag>footnote</tag>, 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 <tag>table</tag> or
+<tag>itemizedlist</tag> or whatever in a <tag>para</tag> that has some preferatory text.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added support to mixed-block template for handling tables in
+mixed-blocks (e.g., as child of <tag>para</tag>) correctly.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl; refentry.xsl; end⋯</literal></para><screen><phrase role="commit-message">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 <tag>area</tag> of the stylesheet code.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with incorrect formatting of nested <tag>variablelist</tag>.
+Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Make sure that all listitems in <tag>itemizedlist</tag> and <tag>orderedlist</tag> 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</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl; links.xsl; param.ent</literal></para><screen><phrase role="commit-message">Made a number of changes related to elements with
+out-of-line content:
+
+- Added handling for <tag>mediaobject</tag> &amp; <tag>inlinemediaobject</tag>.
+ Each <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element
+ within a <tag>mediaobject</tag> or inline <tag>mediaobject</tag> is now
+ treated as a "notesource" and so handled in much the
+ same way as links and <tag>annotation</tag>/<tag>alt</tag>/footnotes.
+
+ That means a numbered marker is generated inline to
+ mark the place in the main flow where the <tag>imagedata</tag>,
+ <tag>audiodata</tag>, or <tag>videodata</tag> 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 <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element.
+
+ For mediobject and <tag>inlinemediaobject</tag> instances that
+ have a <tag>textobject</tag> child, the <tag>textobject</tag> 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.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Eclipse">
+<title>Eclipse</title>
+<para>The following changes have been made to the
+ <filename>eclipse</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: Makefile</literal></para><screen><phrase role="commit-message">Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. &lt;<tag>title</tag>&gt; Foo&lt;/<tag>title</tag>&gt;) in the source</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Eclipse changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_JavaHelp">
+<title>JavaHelp</title>
+<para>The following changes have been made to the
+ <filename>javahelp</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Implemented FR #1230233 (sorted <tag>index</tag> in javahelp).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() around titles and <tag>index</tag> entries to work around whitespace problems.
+Added support for <tag>glossary</tag> and <tag>bibliography</tag> in <tag>toc</tag> and map files.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of JavaHelp changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Roundtrip">
+<title>Roundtrip</title>
+<para>The following changes have been made to the
+ <filename>roundtrip</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl; sections2blocks.⋯</literal></para><screen><phrase role="commit-message">new stylesheets for better word processor support and easier maintenance</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml</literal></para><screen><phrase role="commit-message">fixed bugs</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Roundtrip changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml; htmlhelp.button.zo⋯</literal></para><screen><phrase role="commit-message">Modified <tag>refpurpose</tag> text.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml; htmlhelp.alias.f⋯</literal></para><screen><phrase role="commit-message">Fixed typos, made some small changes.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: javahelp.encoding.xml</literal></para><screen><phrase role="commit-message">Moved declaration and documentation of <parameter>javahelp.encoding</parameter> from javahelp.xsl to the
+regular "parameter machinery".</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: generate.id.attributes.xml</literal></para><screen><phrase role="commit-message">Added <tag>refpurpose</tag> text.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml; annotation.graphic.close.⋯</literal></para><screen><phrase role="commit-message">Added better <tag>refpurpose</tag> texts.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.standalone.xm⋯</literal></para><screen><phrase role="commit-message">Fixed some broken formatting in source files for chunker.* params,
+as pointed out by Dave Pawson.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: label.from.part.xml</literal></para><screen><phrase role="commit-message">Changed handling of <tag>reference</tag> auto-labeling such that <tag>reference</tag>
+(when it appears at the component level) is now affected by the
+<parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarified that 'extension' refers to file names.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: abstract.notitle.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
+If non-zero, in output of the <tag>abstract</tag> element on titlepages,
+display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
+Because sometimes you really don't want or need that <tag>title</tag>
+there...</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: man.string.subst.map.xml</literal></para><screen><phrase role="commit-message">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.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: margin.note.float.type.xml; title.font.family.xml; table.frame.border.color.x⋯</literal></para><screen><phrase role="commit-message">Improved parameter metadata</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: profile.wordsize.xml; profile.audience.xml</literal></para><screen><phrase role="commit-message">Add support for profiling on new attributes audience and wordsize.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: callout.graphics.number.limit.xml; callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Added SVG graphics for fo output.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: callout.icon.size.xml</literal></para><screen><phrase role="commit-message">Set size of <tag>callout</tag> graphics.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: default.units.xml; chunker.output.method.xml; toc.list.type.xml; output.inden⋯</literal></para><screen><phrase role="commit-message">Updated parameter metadata to the new format.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: man.output.quietly.xml; title.font.family.xml; footnote.sep.leader.properties⋯</literal></para><screen><phrase role="commit-message">Added type annotations into parameter definition files.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: section.container.element.xml</literal></para><screen><phrase role="commit-message">Support spans in sections for certain processors.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: component.titlepage.properties.xml</literal></para><screen><phrase role="commit-message">Empty attribute set for top level component titlepage block.
+Allows setting a span on <tag>title</tag> <tag>info</tag>.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: bibliography.style.xml</literal></para><screen><phrase role="commit-message">Added <tag>link</tag> to WiKi page with description of special markup needed for ISO690 biblioentries</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: make.year.ranges.xml</literal></para><screen><phrase role="commit-message">Clarify that multiple <tag>year</tag> elements are required.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: id.warnings.xml</literal></para><screen><phrase role="commit-message">Turn off <parameter>id.warnings</parameter> by default.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Jirka Kosek: bibliography.style.xml</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
+New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
+The code was provided by Jana Dvorakova</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Robert Stayton: header.table.properties.xml; footer.table.properties.xml</literal></para><screen><phrase role="commit-message">Support adding <tag>table</tag> properties to header and footer tables.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Highlighting">
+<title>Highlighting</title>
+<para>The following changes have been made to the
+ <filename>highlighting</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Jirka Kosek: c-hl.xml; xslthl-config.xml</literal></para><screen><phrase role="commit-message">Added support for C language. Provided by Bruno Guegan.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Highlighting changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Profiling">
+<title>Profiling</title>
+<para>The following changes have been made to the
+ <filename>profiling</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Robert Stayton: profile-mode.xsl</literal></para><screen><phrase role="commit-message">Add support for new profiling attributes audience and wordsize.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Profiling changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Lib">
+<title>Lib</title>
+<para>The following changes have been made to the
+ <filename>lib</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: lib.xweb</literal></para><screen><phrase role="commit-message">Changed name of prepend-pad template to pad-string and twheeked so
+it can do both right/left padding.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Lib changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_Tools">
+<title>Tools</title>
+<para>The following changes have been made to the
+ <filename>tools</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: bin; bin/docbook-xsl-update</literal></para><screen><phrase role="commit-message">Did some cleanup to the install.sh source and added a
+docbook-xsl-update script to the docbook-xsl distro, the purpose
+of which is to facilitate easy sync-up to the latest docbook-xsl
+snapshot (by means of rsync).</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Tools changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_XSL-Saxon">
+<title>XSL-Saxon</title>
+<para>The following changes have been made to the
+ <filename>xsl-saxon</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/⋯</literal></para><screen><phrase role="commit-message">Added modifications so that the new <parameter>callout.icon.size</parameter> parameter is taken into account. This
+parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x⋯</literal></para><screen><phrase role="commit-message">Added code for generating id attributes on callouts in HTML and FO output.
+These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
+It works for graphic, unicode and text callouts.
+Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan⋯</literal></para><screen><phrase role="commit-message">Copied over Website XSL Java extensions.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-Saxon changes for 1.73.0-->
+<sect2 xml:id="V1.73.0_XSL-Xalan">
+<title>XSL-Xalan</title>
+<para>The following changes have been made to the
+ <filename>xsl-xalan</filename> code
+ since the 1.72.0 release.</para>
+<itemizedlist>
+<listitem>
+<para><literal>Michael(tm) Smith: Makefile; xalan2</literal></para><screen><phrase role="commit-message">Turned off xalan2.jar build. This removes DocBook XSL
+Java extensions support for versions of Xalan prior to
+Xalan 2.7. If you are currently using the extensions
+with an earlier version of Xalan, you need to upgrade
+to Xalan 2.7.</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/⋯</literal></para><screen><phrase role="commit-message">Added modifications so that the new <parameter>callout.icon.size</parameter> parameter is taken into account. This
+parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x⋯</literal></para><screen><phrase role="commit-message">Added code for generating id attributes on callouts in HTML and FO output.
+These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
+It works for graphic, unicode and text callouts.
+Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
+</listitem>
+<listitem>
+<para><literal>Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan⋯</literal></para><screen><phrase role="commit-message">Copied over Website XSL Java extensions.</phrase></screen>
+</listitem>
+</itemizedlist>
+</sect2><!--end of XSL-Saxon changes for 1.73.0-->
+</sect1><!--end of changes for the 1.73.0 release-->
+
+<sect1 xml:id="V1.72.0">
+<title>Release: 1.72.0</title>
+<para>This release includes important bug fixes and adds the following
+significant feature changes:
+<variablelist>
+ <varlistentry>
+ <term>Automatic sorting of glossary entries</term>
+ <listitem>
+ <para>The HTML and FO stylesheets now support automatic sorting
+ of <tag>glossary</tag> entries. To enable glossary sorting, set
+ the value of the <parameter>glossary.sort </parameter> parameter
+ to <code>1</code> (by default, it’s value is
+ <code>0</code>). When you enable glossary sorting,
+ <tag>glossentry</tag> elements within a <tag> glossary</tag>,
+ <tag>glossdiv</tag>, or <tag>glosslist</tag> are sorted on the
+ <tag>glossterm</tag>, using the current language setting. If you
+ don’t enable glossary sorting, then the order of
+ <tag>glossentry</tag> elements is left “as is” — that is, they
+ are not sorted but are instead just displayed in document
+ order.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>WordML renamed to Roundtrip, OpenOffice support added</term>
+ <listitem>
+ <para>Stylesheets for “roundtrip” conversion between documents in
+ OpenOffice format (ODF) and DocBook XML have been added to the set
+ of stylesheets that formerly had the collective title
+ <wordasword>WordML</wordasword>, and that set of stylesheets has
+ been renamed to <wordasword>Roundtrip</wordasword> to better
+ reflect the actual scope and purpose of its contents.</para>
+ <para>So the DocBook XSL Stylesheets now support roundtrip
+ conversion (with certain limitations) of WordML, OpenOffice, and
+ Apple Pages documents to and from DocBook XML.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Including QandASet questions in TOCs</term>
+ <listitem>
+ <para>The HTML stylesheet now provides support for including
+ <tag>QandASet</tag> <tag>question</tag>s in the document TOC. To
+ enable display of <tag>question</tag>s in the document TOC, set
+ the value of the <parameter>qanda.in.toc</parameter> to
+ <code>1</code> (by default, it’s <code>0</code>). When you
+ enable <parameter>qanda.in.toc</parameter>, then the generated
+ table of contents for a document will include
+ <tag>qandaset</tag> titles, <tag>qandadiv</tag> titles, and
+ <tag>question</tag> elements. The default value of zero
+ excludes them from the TOC.
+ <note>
+ <para>The <parameter>qanda.in.toc</parameter> parameter does
+ not affect any tables of contents that may be generated
+ <emphasis>within</emphasis> a <tag>qandaset</tag> or
+ <tag>qandadiv</tag> (only in the document TOC).</para>
+ </note>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Language identifier in man-page filenames and pathnames</term>
+ <listitem>
+ <para>Added new parameter <parameter
+ >man.output.lang.in.name.enabled</parameter>, which controls whether
+ a language identifier is included in man-page filenames and
+ pathnames. It works like this:</para>
+
+ <para>If the value of <parameter
+ >man.output.lang.in.name.enabled</parameter> is non-zero,
+ man-page files are output with a language identifier included in
+ their filenames or pathnames as follows:</para>
+
+ <itemizedlist>
+ <listitem><para>if
+ <parameter>man.output.subdirs.enabled</parameter> is non-zero,
+ each file is output to, e.g., a
+ <filename>/$lang/man8/foo.8</filename> pathname</para></listitem>
+
+ <listitem><para>if
+ <parameter>man.output.subdirs.enabled</parameter> is zero,
+ each file is output with a <tag>foo.$lang.8</tag>
+ filename</para></listitem>
+ </itemizedlist>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>index.page.number.properties</parameter> property set</term>
+ <listitem>
+ <para>For FO output, use the
+ <parameter>index.page.number.properties</parameter> to control
+ formatting of page numbers in <tag>index</tag> output — to (for
+ example) to display page numbers in <tag>index</tag> output in a
+ different color (to indicate that they are links).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Crop marks in output from Antenna House XSL Formatter</term>
+ <listitem>
+ <para>Support has been added for generating crop marks in
+ print/PDF output generated using Antenna House XSL Formatter</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>More string-substitution hooks in manpages output</term>
+ <listitem>
+ <para>The <parameter>man.string.subst.map.local.pre</parameter>
+ and <parameter>man.string.subst.map.local.post</parameter>
+ parameters have been added to enable easier control over
+ custom string substitutions.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Moved verbatim properties to attribute-set</term>
+ <listitem>
+ <para>The hardcoded properties used in verbatim elements (literallayout,
+ programlisting, screen) were moved to the verbatim.properties
+ attribute-set so they can be more easily customized.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>enhanced simple.xlink template</term>
+ <listitem>
+ <para>Now the simple.xlink template in inline.xsl works with
+ cross reference elements xref and link as well. Also, more elements
+ call simple.xlink, which enables DB5 xlink functionality.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>DocBook 5 compatibility</term>
+ <listitem>
+ <para>Stylesheets now consistently support DocBook 5 attributes
+ (such as xml:id). Also, DocBook 5 info elements are now checked
+ along with other *info elements, and the use of name() function
+ was replaced by local-name() so it also matches on DocBook 5 elements.
+ These changes enable reusing the stylesheets with DocBook 5
+ documents with minimal fixup.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>HTML class attributes now handled in class.attribute mode </term>
+ <listitem>
+ <para>The HTML class attributes were formerly hardcoded to the
+ element name. Now the class attribute is generated by applying
+ templates in class.attribute mode so class attribute names
+ can be customized. The default is still the element name.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>arabic-indic numbering enabled in autolabels</term>
+ <listitem>
+ <para>Numbering of chapter, sections, and pages can now use
+ arabic-indic numbering when number format is set to 'arabicindic' or
+ to &#x661;.</para>
+ </listitem>
+ </varlistentry>
+</variablelist>
+The following is a detailed list of changes (not
+including bug fixes) that have been made since the 1.71.1
+release.</para>
+
+<sect2 xml:id="V1.72.0_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+ <filename>common</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for arabicindic numbering to autolabel.format template.<alt>M: /trunk/xsl/common/labels.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Finish support for @xml:id everywhere @id is used.<alt>M: /trunk/xsl/common/gentext.xsl; M: /trunk/xsl/common/titles.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">replace name() with local-name() in most cases.<alt>M: /trunk/xsl/common/l10n.xsl; M: /trunk/xsl/common/olink.xsl; M: /trunk/xsl/common/subtitles.xsl; M: /trunk/xsl/common/labels.xsl; M: /trunk/xsl/common/titles.xsl; M: /trunk/xsl/common/common.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for <tag>info</tag>.<alt>M: /trunk/xsl/common/subtitles.xsl; M: /trunk/xsl/common/labels.xsl; M: /trunk/xsl/common/titles.xsl; M: /trunk/xsl/common/common.xsl; M: /trunk/xsl/common/targets.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add utility template tabstyle to return the tabstyle from
+any <tag>table</tag> element.<alt>M: /trunk/xsl/common/table.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for 1.72.0-->
+
+<sect2 xml:id="V1.72.0_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent; M: /trunk/xsl/fo/glossary.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add table.row.properties template to customize <tag>table</tag> rows.<alt>M: /trunk/xsl/fo/table.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Moved all properties to attribute-sets so can be customized more easily.<alt>M: /trunk/xsl/fo/verbatim.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add index.page.number.properties attribute-set to format page numbers.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message"><tag>xref</tag> now supports xlink:href, using simple.xlink template.<alt>M: /trunk/xsl/fo/xref.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Rewrote simple.xlink, and call it with all charseq templates.<alt>M: /trunk/xsl/fo/inline.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add simple.xlink processing to <tag>term</tag> and <tag>member</tag> elements.<alt>M: /trunk/xsl/fo/lists.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for crop marks in Antenna House.<alt>M: /trunk/xsl/fo/axf.xsl; M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.72.0-->
+
+<sect2 xml:id="V1.72.0_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>M: /trunk/xsl/html/glossary.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for <parameter>qanda.in.toc</parameter> to add <tag>qandaentry</tag> questions to document <tag>TOC</tag>.<alt>M: /trunk/xsl/html/autotoc.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">add simple.xlink support to <tag>variablelist</tag> <tag>term</tag> and <tag>simplelist</tag> <tag>member</tag>.<alt>M: /trunk/xsl/html/lists.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">*.propagates.style now handled in class.attribute mode.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/block.xsl; M: /trunk/xsl/html/footnote.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">add class parameter to class.attribute mode to set default class.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Convert all class attributes to use the class.attribute mode
+so class names can be customized more easily.<alt>M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/chunk-code.xsl; M: /trunk/xsl/html/division.xsl; M: /trunk/xsl/html/sections.xsl; M: /trunk/xsl/html/math.xsl; M: /trunk/xsl/html/block.xsl; M: /trunk/xsl/html/info.xsl; M: /trunk/xsl/html/footnote.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/admon.xsl; M: /trunk/xsl/html/refentry.xsl; M: /trunk/xsl/html/qandaset.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/biblio.xsl; M: /trunk/xsl/html/task.xsl; M: /trunk/xsl/html/component.xsl; M: /trunk/xsl/html/glossary.xsl; M: /trunk/xsl/html/callout.xsl; M: /trunk/xsl/html/index.xsl; M: /trunk/xsl/html/synop.xsl; M: /trunk/xsl/html/verbatim.xsl; M: /trunk/xsl/html/ebnf.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add class.attribute mode to generate class attributes.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added simple.xlink to most remaining inlines.
+Changed class attributes to applying class.attributes mode.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Changed <tag>xref</tag> template to use simple.xlink tempalte.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Improve generate.html.title to work with <tag>link</tag> targets too.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Improved simple.xlink to support <tag>link</tag> and <tag>xref</tag>.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Use new link.title.attribute now.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Rewrote simple.xlink to handle linkend also.
+Better computation of <tag>title</tag> attribute on <tag>link</tag> too.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Handle Xalan quirk as special case.<alt>M: /trunk/xsl/html/db5strip.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for <tag>info</tag>.<alt>M: /trunk/xsl/html/admon.xsl; M: /trunk/xsl/html/autotoc.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/refentry.xsl; M: /trunk/xsl/html/biblio.xsl; M: /trunk/xsl/html/qandaset.xsl; M: /trunk/xsl/html/component.xsl; M: /trunk/xsl/html/glossary.xsl; M: /trunk/xsl/html/division.xsl; M: /trunk/xsl/html/index.xsl; M: /trunk/xsl/html/sections.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/block.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Fixed imagemaps so they work properly going from calspair coords
+to HTML <tag>area</tag> coords.<alt>M: /trunk/xsl/html/graphics.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.72.0-->
+
+<sect2 xml:id="V1.72.0_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
+checkin completes support for writing file/pathnames for man-pages
+with $lang include in the names. Closes #1585967. knightly
+accolades to Daniel Leidert for providing the feature request.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
+controls whether $LANG value is included in manpages
+filenames and pathnames. It works like this:
+
+If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
+man-page files are output with the $lang value included in
+their filenames or pathnames as follows;
+
+- if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
+ output to, e.g., a /$lang/man8/foo.8 pathname
+
+- if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
+ with a foo.$lang.8 <tag>filename</tag><alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Use "\e" instead of "\\" for backslash output, because the
+groff docs say that's the correct thing to do; also because
+testing (thanks, Paul Dubois) shows that "\\" doesn't always
+work as expected; for example, "\\" within a <tag>table</tag> seems to
+mess things up.<alt>M: /trunk/xsl/manpages/charmap.groff.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
+<parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
+enable local additions and changes to string-substitution mappings
+without the need to change the value of <parameter>man.string.subst.map</parameter>
+parameter (which is for standard system mappings). Closes
+#1456738. Thanks to Sam Steingold for constructing a true
+stylesheet torture test (the clisp docs) that exposed the need for
+these params.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent; M: /trunk/xsl/manpages/other.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added the Markup element to the list of elements that get output
+in bold. Thanks to Eric S. Raymond.<alt>M: /trunk/xsl/manpages/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Replaced all dots in roff requests with U+2302 ("house"
+character), and added escaping in output for all instances of dot
+that are not in roff requests. This fixes the problem case where a
+string beginning with a dot (for example, the string ".bashrc")
+might occur at the beginning of a line in output, in which case
+would mistakenly get interpreted as a roff request. Thanks to Eric
+S. Raymond for pushing to fix this.<alt>M: /trunk/xsl/manpages/table.xsl; M: /trunk/xsl/manpages/synop.xsl; M: /trunk/xsl/manpages/block.xsl; M: /trunk/xsl/manpages/info.xsl; M: /trunk/xsl/manpages/lists.xsl; M: /trunk/xsl/manpages/refentry.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Made change to ensure that list content nested in
+<tag>itemizedlist</tag> and <tag>orderedlist</tag> instances is properly indented. This
+is a switch from using .TP to format those lists to using .RS/.RE
+to format them instead (because .TP does not allow nesting). Closes bug #1602616.
+Thanks to Daniel Leidert.<alt>M: /trunk/xsl/manpages/lists.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.72.0-->
+
+<sect2 xml:id="V1.72.0_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
+checkin completes support for writing file/pathnames for man-pages
+with $lang include in the names. Closes #1585967. knightly
+accolades to Daniel Leidert for providing the feature request.<alt>A: /trunk/xsl/params/man.output.lang.in.name.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
+controls whether $LANG value is included in manpages
+filenames and pathnames. It works like this:
+
+If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
+man-page files are output with the $lang value included in
+their filenames or pathnames as follows;
+
+- if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
+ output to, e.g., a /$lang/man8/foo.8 pathname
+
+- if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
+ with a foo.$lang.8 <tag>filename</tag><alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
+<parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
+enable local additions and changes to string-substitution mappings
+without the need to change the value of <parameter>man.string.subst.map</parameter>
+parameter (which is for standard system mappings). Closes
+#1456738. Thanks to Sam Steingold for constructing a true
+stylesheet torture test (the clisp docs) that exposed the need for
+these params.<alt>A: /trunk/xsl/params/man.string.subst.map.local.post.xml; A: /trunk/xsl/params/man.string.subst.map.local.pre.xml; M: /trunk/xsl/params/man.string.subst.map.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add index.page.number.properties by default.<alt>M: /trunk/xsl/params/xep.index.item.properties.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added <parameter>index.page.number.properties</parameter> to allow customizations of page numbers in indexes.<alt>A: /trunk/xsl/params/index.page.number.properties.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Move show-destination="replace" property from template to attribute-set
+so it can be customized.<alt>M: /trunk/xsl/params/olink.properties.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>A: /trunk/xsl/params/glossary.sort.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add option to include qanda in tables of contents.<alt>A: /trunk/xsl/params/qanda.in.toc.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Moved all properties to attribute-sets so can be customized more easily.<alt>M: /trunk/xsl/params/verbatim.properties.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.72.0-->
+
+<sect2 xml:id="V1.72.0_Template">
+<title>Template</title>
+<para>The following changes have been made to the
+ <filename>template</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added workaround for Xalan bug: use for-each and copy instead of copy-of (#1604770).<alt>M: /trunk/xsl/template/titlepage.xsl - Mauritz Jeanson</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Template changes for 1.72.0-->
+
+<sect2 xml:id="V1.72.0_Roundtrip">
+<title>Roundtrip</title>
+<para>The following changes have been made to the
+ <filename>roundtrip</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">rename to roundtrip, add OpenOffice support<alt>M: /trunk/xsl/roundtrip/docbook-pages.xsl; M: /trunk/xsl/roundtrip/specifications.xml; A: /trunk/xsl/roundtrip/dbk2ooo.xsl; M: /trunk/xsl/roundtrip/docbook.xsl; A: /trunk/xsl/roundtrip/dbk2pages.xsl; M: /trunk/xsl/roundtrip/template.xml; A: /trunk/xsl/roundtrip/dbk2wordml.xsl; A: /trunk/xsl/roundtrip/dbk2wp.xsl; M: /trunk/xsl/roundtrip/template.dot; M: /trunk/xsl/roundtrip/wordml-final.xsl - Steve Ball</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Roundtrip changes for 1.72.0-->
+</sect1><!--end of V1.72.0-->
+
+<sect1 xml:id="V1.71.1">
+<title>Release: 1.71.1</title>
+<para>This is a minor update to the 1.71.0 release. Along with a
+number of bug fixes, it includes two feature changes:
+
+<itemizedlist>
+ <listitem>
+ <para>Added support for profiling based on <tag
+ class="attribute">xml:lang</tag> and <tag
+ class="attribute">status</tag> attributes.</para>
+ </listitem>
+ <listitem>
+ <para>Added initial support in manpages output for
+ <tag>footnote</tag>, <tag>annotation</tag>, and <tag>alt</tag>
+ instances. Basically, they all now get handled the same way
+ <tag>ulink</tag> instances are. They are treated as a class as
+ "note sources": A numbered marker is generated at the place in the
+ main text flow where they occur, then their contents are displayed
+ in an endnotes section at the end of the man page.</para>
+ </listitem>
+</itemizedlist>
+</para>
+
+<sect2 xml:id="V1.71.1_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+ <filename>common</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>D: /trunk/xsl/common/autoidx-ng.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for Xalan generating a root xml:base like saxon.<alt>M: /trunk/xsl/common/stripns.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for 1.71.1-->
+
+<sect2 xml:id="V1.71.1_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>M: /trunk/xsl/fo/autoidx-ng.xsl; M: /trunk/xsl/fo/autoidx-kosek.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for Xalan to add root node xml:base for db5 docs.<alt>M: /trunk/xsl/fo/docbook.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.71.1-->
+
+<sect2 xml:id="V1.71.1_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>M: /trunk/xsl/html/autoidx-ng.xsl; M: /trunk/xsl/html/autoidx-kosek.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Add support for Xalan to add root node xml:base for db5 docs.<alt>M: /trunk/xsl/html/chunk-code.xsl; M: /trunk/xsl/html/docbook.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Made changes in namespace declarations to prevent xmllint's
+canonicalizer from treating them as relative namespace URIs.
+
+ - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
+ to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";
+ Saxon accepts either form
+ (see http://www.saxonica.com/documentation/extensibility/functions.html);
+ to Saxon, "the part of the URI before the final '/' is immaterial".
+
+ - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
+ xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
+ either form
+ (see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
+ just as Saxon does, it will "simply use the string to the
+ right of the rightmost forward slash as the Java class name".
+
+ - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
+ to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
+ adjusted associated code to make the current Xalan redirect spec.
+ (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/Redirect.html)<alt>M: /trunk/xsl/html/oldchunker.xsl; M: /trunk/xsl/html/chunker.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/callout.xsl; M: /trunk/xsl/html/autoidx-kimber.xsl; M: /trunk/xsl/html/autoidx-kosek.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/verbatim.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
+value of both is empty; but the internal DocBook XSL stylesheets
+build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
+to ensure that all files in the docbook-xsl-doc package end in a
+newline character. (Because diff and some other tools may emit
+error messages and/or not behave as expected when processing
+files that are not newline-terminated.)<alt>M: /trunk/xsl/html/chunk-common.xsl; M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/docbook.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.71.1-->
+
+<sect2 xml:id="V1.71.1_Highlighting">
+<title>Highlighting</title>
+<para>The following changes have been made to the
+ <filename>highlighting</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added license information<alt>M: /trunk/xsl/highlighting/delphi-hl.xml; M: /trunk/xsl/highlighting/myxml-hl.xml; M: /trunk/xsl/highlighting/php-hl.xml; M: /trunk/xsl/highlighting/m2-hl.xml; M: /trunk/xsl/highlighting/ini-hl.xml; M: /trunk/xsl/highlighting/xslthl-config.xml; M: /trunk/xsl/highlighting/java-hl.xml - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Highlighting changes for 1.71.1-->
+
+<sect2 xml:id="V1.71.1_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added initial support in manpages output for <tag>footnote</tag>, <tag>annotation</tag>,
+and <tag>alt</tag> instances. Basically, they all now get handled the same
+way ulink instances are. They are treated as a class as "note
+sources": A numbered marker is generated at the place in the main
+text flow where they occur, then their contents are displayed in
+an endnotes <tag>section</tag> at the end of the man page (currently titled
+REFERENCES, for English output, but will be changed to NOTES).
+
+This support is not yet complete. It works for most "normal"
+cases, but probably mishandles a good number of cases. More
+testing will be needed to expose the problems. It may well also
+introduce some bugs and regressions in other areas, including
+basic paragraph handling, handling of "mixed block" content,
+handling of other indented content, and handling of authorblurb
+and <tag>personblurb</tag> in the AUTHORS <tag>section</tag>.<alt>M: /trunk/xsl/manpages/table.xsl; M: /trunk/xsl/manpages/block.xsl; M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.71.1-->
+
+<sect2 xml:id="V1.71.1_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>A: /trunk/xsl/params/profile.status.xml - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
+value of both is empty; but the internal DocBook XSL stylesheets
+build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
+to ensure that all files in the docbook-xsl-doc <tag>package</tag> end in a
+newline character. (Because diff and some other tools may emit
+error messages and/or not behave as expected when processing
+files that are not newline-terminated.)<alt>A: /trunk/xsl/params/html.append.xml; A: /trunk/xsl/params/chunk.append.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.71.1-->
+
+<sect2 xml:id="V1.71.1_Profiling">
+<title>Profiling</title>
+<para>The following changes have been made to the
+ <filename>profiling</filename> code
+ since the 1.71.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/profiling/profile.xsl; M: /trunk/xsl/profiling/profile-mode.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Profiling changes for 1.71.1-->
+
+</sect1>
+
+<sect1 xml:id="V1.71.0">
+<title>Release: 1.71.0</title>
+<para>This is mainly a bug fix release, but it also includes two
+significant feature changes:
+<variablelist>
+ <varlistentry>
+ <term>Highlighting support added</term>
+ <listitem>
+ <para>The stylesheets now include support for source-code
+ highlighting in output of programlisting instances (controlled
+ through the <parameter>highlight.source</parameter>
+ parameter). The Java-based implementation requires Saxon and
+ makes use of <link
+ xlink:href="http://molhanec.net/"><person><personname
+ ><firstname>Michal</firstname><surname
+ >Molhanec</surname></personname></person></link>’s <link
+ xlink:href="http://sourceforge.net/projects/xslthl"
+ >XSLTHL</link>. More details are available at Jirka Kosek’s
+ website: <blockquote ><simpara ><link
+ xlink:href="http://xmlguru.cz/2006/07/docbook-syntax-highlighting"/></simpara
+ ></blockquote> The support is currently limited to highlighting
+ of XML, Java, PHP, Delphi, Modula-2 sources, and INI
+ files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Changes to autoindexing</term>
+ <listitem>
+ <para>The templates that handle alternative indexing methods
+ were reworked to avoid errors produced by certain processors not
+ being able to tolerate the presence of unused functions. With
+ this release, none of the code for the 'kimber' or 'kosek'
+ methods is included in the default stylesheets. In order to use
+ one of those methods, your customization layer must import one
+ of the optional stylesheet modules:</para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <simpara>html/autoidx-kosek.xsl</simpara>
+ </listitem>
+ <listitem>
+ <simpara>html/autoidx-kimber.xsl</simpara>
+ </listitem>
+ <listitem>
+ <simpara>fo/autoidx-kosek.xsl</simpara>
+ </listitem>
+ <listitem>
+ <simpara>fo/autoidx-kimber.xsl</simpara>
+ </listitem>
+ </itemizedlist>
+ See the <parameter>index.method</parameter> parameter
+ reference page for more information.
+ </para>
+ <para>Two other changes to note:
+ <itemizedlist>
+ <listitem>
+ <simpara>The default indexing method now can handle accented
+ characters in latin-based alphabets, not just English. This
+ means accented latin letters will group and sort with their
+ unaccented counterpart.</simpara>
+ </listitem>
+ <listitem>
+ <simpara>The default value for the
+ <parameter>index.method</parameter> parameter was changed
+ from 'english' to 'basic' because now the default method can
+ handle latin-based alphabets, not just English.</simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+</variablelist>
+The following is a list of changes that have
+been made since the 1.70.1 release.</para>
+
+<sect2 xml:id="V1.71.0_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+ <filename>common</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
+<tag>reference</tag> output.<alt>M: /trunk/xsl/common/labels.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/common/table.xsl - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/common/autoidx-kimber.xsl; A: /trunk/xsl/common/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support startinglinenumber on <tag>orderedlist</tag><alt>M: /trunk/xsl/common/common.xsl - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_Extensions">
+<title>Extensions</title>
+<para>The following changes have been made to the
+ <filename>extensions</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Completely reworked extensions build system; now uses NetBeans and ant<alt>D: /trunk/xsl/extensions/xalan27/.cvsignore; A: /trunk/xsl/extensions/saxon65/nbproject; A: /trunk/xsl/extensions/saxon65/nbproject/project.properties; D: /trunk/xsl/extensions/prj.el; A: /trunk/xsl/extensions/saxon65/src; A: /trunk/xsl/extensions/xalan2/src/com; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Text.java; A: /trunk/xsl/extensions/saxon65/nbproject/project.xml; D: /trunk/xsl/extensions/build.xml; A: /trunk/xsl/extensions/saxon65/build.xml; A: /trunk/xsl/extensions/xalan2/nbproject/genfiles.properties; A: /trunk/xsl/extensions/saxon65; D: /trunk/xsl/extensions/xalan2/com; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Func.java; A: /trunk/xsl/extensions/xalan2/test; A: /trunk/xsl/extensions/saxon65/src/com; A: /trunk/xsl/extensions/xalan2/nbproject/build-impl.xml; A: /trunk/xsl/extensions/xalan2/nbproject; A: /trunk/xsl/extensions/xalan2/src; A: /trunk/xsl/extensions/xalan2/nbproject/project.properties; D: /trunk/xsl/extensions/.cvsignore; M: /trunk/xsl/extensions/Makefile; D: /trunk/xsl/extensions/saxon8; A: /trunk/xsl/extensions/saxon65/nbproject/genfiles.properties; A: /trunk/xsl/extensions/xalan2/nbproject/project.xml; A: /trunk/xsl/extensions/saxon65/test; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Verbatim.java; A: /trunk/xsl/extensions/xalan2/build.xml; M: /trunk/xsl/extensions/xalan2; D: /trunk/xsl/extensions/saxon643; A: /trunk/xsl/extensions/saxon65/nbproject/build-impl.xml - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Extensions changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+
+<listitem>
+<literallayout><phrase role="commit-message">xsl:sort lang attribute now uses two-char substring of lang attribute.<alt>M: /trunk/xsl/fo/autoidx-kimber.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
+language attribute on <tag>classsynopsis</tag>, etc. (instead of just
+lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
+(instead of just "cpp").
+
+Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
+to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/fo/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
+output.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/fo/table.xsl - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
+and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/fo/autoidx-kimber.xsl; A: /trunk/xsl/fo/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Turn off blank-body for <parameter>fop1.extensions</parameter> too since fop 0.92
+does not support it either.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
+Xalan can use <tag>function</tag> named node-set(), but doesn't
+recognize it using function-available().<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
+where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
+moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
+FO and HTML stylesheets, added support for correctly processing
+<tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/fo/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
+<tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
+instances, and removed some debugging stuff that was generated in
+manpages output to mark the ends of sections.<alt>M: /trunk/xsl/fo/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
+default), delimiters are generated around e-mail addresses (output
+of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/fo/inline.xsl; M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>M: /trunk/xsl/fo/param.ent; M: /trunk/xsl/fo/param.xweb; A: /trunk/xsl/fo/highlight.xsl; M: /trunk/xsl/fo/verbatim.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message"><tag>Chapter</tag> after <tag>preface</tag> should restart numbering of pages.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+
+<listitem>
+<literallayout><phrase role="commit-message">xsl:sort lang attribute now uses two-char substring of lang attribute.<alt>M: /trunk/xsl/html/autoidx-kimber.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
+language attribute on <tag>classsynopsis</tag>, etc. (instead of just
+lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
+(instead of just "cpp").
+
+Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
+to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/html/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
+output.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/html/table.xsl - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
+and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/html/autoidx-kimber.xsl; A: /trunk/xsl/html/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
+content on HTML <tag>title</tag> pages:
+
+<parameter>contrib.inline.enabled</parameter>:
+ If non-zero (the default), output of the <tag>contrib</tag> element is
+ displayed as inline content rather than as block content.
+
+<parameter>othercredit.like.author.enabled</parameter>:
+ If non-zero, output of the <tag>othercredit</tag> element on titlepages is
+ displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
+ (the default), <tag>othercredit</tag> output is displayed using a style
+ different than that of <tag>author</tag> and <tag>editor</tag>.
+
+<parameter>blurb.on.titlepage.enabled</parameter>:
+ If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
+ displayed on <tag>title</tag> pages. If zero (the default), output from
+ those elements is suppressed on <tag>title</tag> pages (unless you are
+ using a titlepage customization that causes them to be included).
+
+<parameter>editedby.enabled</parameter>
+ If non-zero (the default), a localized Edited by heading is
+ displayed above <tag>editor</tag> names in output of the <tag>editor</tag> element.<alt>M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
+Xalan can use <tag>function</tag> named node-set(), but doesn't
+recognize it using function-available().<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
+where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
+moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
+FO and HTML stylesheets, added support for correctly processing
+<tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
+<tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
+instances, and removed some debugging stuff that was generated in
+manpages output to mark the ends of sections.<alt>M: /trunk/xsl/html/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
+default), delimiters are generated around e-mail addresses (output
+of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
+non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
+of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
+(from Daniel Leidert). Currently on affects HTML output (no patch
+for FO output provided).<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent; M: /trunk/xsl/html/qandaset.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+
+<listitem>
+<literallayout><phrase role="commit-message">Improved handling of relative locations generated files<alt>M: /trunk/xsl/html/html.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>M: /trunk/xsl/html/param.ent; M: /trunk/xsl/html/param.xweb; A: /trunk/xsl/html/highlight.xsl; M: /trunk/xsl/html/verbatim.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support <tag>org</tag><alt>M: /trunk/xsl/html/info.xsl - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support <tag>person</tag><alt>M: /trunk/xsl/html/inline.xsl - Norman Walsh</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Support $keep.relative.image.uris also when chunking<alt>M: /trunk/xsl/html/chunk-code.xsl - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_Highlighting">
+<title>Highlighting</title>
+<para>The following changes have been made to the
+ <filename>highlighting</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+
+<listitem>
+<literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>A: /trunk/xsl/highlighting/php-hl.xml; A: /trunk/xsl/highlighting/common.xsl; A: /trunk/xsl/highlighting/delphi-hl.xml; A: /trunk/xsl/highlighting/myxml-hl.xml; A: /trunk/xsl/highlighting/m2-hl.xml; A: /trunk/xsl/highlighting/ini-hl.xml; A: /trunk/xsl/highlighting/xslthl-config.xml; A: /trunk/xsl/highlighting/java-hl.xml - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Highlighting changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+
+<listitem>
+<literallayout><phrase role="commit-message">Suppress <tag>footnote</tag> markers and output warning that footnotes are
+not yet supported.<alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Handle instances of <tag>address</tag>/<tag>otheraddr</tag>/ulink in <tag>author</tag> et al in the
+same way as <tag>email</tag> instances; that is, display them on the same
+linke as the <tag>author</tag>, <tag>editor</tag>, etc., name.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Don't number or link-list any Ulink instance whose string value is
+identical to the value of its url attribute. Just display it inline.<alt>M: /trunk/xsl/manpages/links.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
+<tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
+instances, and removed some debugging stuff that was generated in
+manpages output to mark the ends of sections.<alt>M: /trunk/xsl/manpages/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
+default), delimiters are generated around e-mail addresses (output
+of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">In manpages output, if the last/nearest *<tag>info</tag> element for
+particular <tag>Refentry</tag> has multiple <tag>Copyright</tag> and/or <tag>Legalnotice</tag>
+children, process them all (not just the first ones). Closes bug
+1524576. Thanks to Sam Steingold for the report and to Daniel
+Leidert for providing a patch.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+</itemizedlist>
+</sect2><!--end of Manpages changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+<listitem>
+<literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
+<tag>reference</tag> output.<alt>A: /trunk/xsl/params/reference.autolabel.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added namespace declarations to document elements for all param files.<alt>M: /trunk/xsl/params/toc.line.properties.xml; M: /trunk/xsl/params/title.font.family.xml; M: /trunk/xsl/params/component.label.includes.part.label.xml; M: /trunk/xsl/params/refentry.manual.profile.xml; M: /trunk/xsl/params/orderedlist.properties.xml; M: /trunk/xsl/params/olink.pubid.xml; M: /trunk/xsl/params/informalexample.properties.xml; M: /trunk/xsl/params/appendix.autolabel.xml; M: /trunk/xsl/params/htmlhelp.show.toolbar.text.xml; M: /trunk/xsl/params/index.on.role.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.url.xml; M: /trunk/xsl/params/variablelist.term.separator.xml; M: /trunk/xsl/params/para.propagates.style.xml; M: /trunk/xsl/params/html.stylesheet.xml; M: /trunk/xsl/params/qanda.nested.in.toc.xml; M: /trunk/xsl/params/annotation.css.xml; M: /trunk/xsl/params/funcsynopsis.style.xml; M: /trunk/xsl/params/htmlhelp.encoding.xml; M: /trunk/xsl/params/footer.content.properties.xml; M: /trunk/xsl/params/verbatim.properties.xml; M: /trunk/xsl/params/autotoc.label.in.hyperlink.xml; M: /trunk/xsl/params/body.margin.top.xml; M: /trunk/xsl/params/bibliography.numbered.xml; M: /trunk/xsl/params/figure.properties.xml; M: /trunk/xsl/params/variablelist.max.termlength.xml; M: /trunk/xsl/params/table.cell.border.style.xml; M: /trunk/xsl/params/htmlhelp.button.options.xml; M: /trunk/xsl/params/preferred.mediaobject.role.xml; M: /trunk/xsl/params/htmlhelp.chm.xml; M: /trunk/xsl/params/man.charmap.subset.profile.xml; M: /trunk/xsl/params/qanda.title.level3.properties.xml; M: /trunk/xsl/params/page.width.xml; M: /trunk/xsl/params/firstterm.only.link.xml; M: /trunk/xsl/params/section.level6.properties.xml; M: /trunk/xsl/params/htmlhelp.button.locate.xml; M: /trunk/xsl/params/chunk.sections.xml; M: /trunk/xsl/params/use.local.olink.style.xml; M: /trunk/xsl/params/refentry.date.profile.enabled.xml; M: /trunk/xsl/params/refentry.version.suppress.xml; M: /trunk/xsl/params/refentry.generate.title.xml; M: /trunk/xsl/params/punct.honorific.xml; M: /trunk/xsl/params/column.gap.index.xml; M: /trunk/xsl/params/body.start.indent.xml; M: /trunk/xsl/params/crop.mark.width.xml; M: /trunk/xsl/params/refentry.version.profile.enabled.xml; M: /trunk/xsl/params/superscript.properties.xml; M: /trunk/xsl/params/chunker.output.doctype-public.xml; M: /trunk/xsl/params/saxon.character.representation.xml; M: /trunk/xsl/params/saxon.linenumbering.xml; M: /trunk/xsl/params/shade.verbatim.style.xml; M: /trunk/xsl/params/annotate.toc.xml; M: /trunk/xsl/params/profile.attribute.xml; M: /trunk/xsl/params/callout.graphics.number.limit.xml; M: /trunk/xsl/params/profile.arch.xml; M: /trunk/xsl/params/saxon.tablecolumns.xml; M: /trunk/xsl/params/glossterm.auto.link.xml; M: /trunk/xsl/params/default.units.xml; M: /trunk/xsl/params/qanda.title.level1.properties.xml; M: /trunk/xsl/params/list.block.spacing.xml; M: /trunk/xsl/params/section.level4.properties.xml; M: /trunk/xsl/params/spacing.paras.xml; M: /trunk/xsl/params/column.count.index.xml; M: /trunk/xsl/params/dingbat.font.family.xml; M: /trunk/xsl/params/citerefentry.link.xml; M: /trunk/xsl/params/keep.relative.image.uris.xml; M: /trunk/xsl/params/ulink.footnotes.xml; M: /trunk/xsl/params/prefer.internal.olink.xml; M: /trunk/xsl/params/refentry.title.properties.xml; M: /trunk/xsl/params/variablelist.term.break.after.xml; M: /trunk/xsl/params/use.id.function.xml; M: /trunk/xsl/params/callout.unicode.start.character.xml; M: /trunk/xsl/params/column.gap.titlepage.xml; M: /trunk/xsl/params/editedby.enabled.xml; M: /trunk/xsl/params/funcsynopsis.tabular.threshold.xml; M: /trunk/xsl/params/use.extensions.xml; M: /trunk/xsl/params/index.preferred.page.properties.xml; M: /trunk/xsl/params/man.th.extra3.max.length.xml; M: /trunk/xsl/params/column.gap.back.xml; M: /trunk/xsl/params/tex.math.delims.xml; M: /trunk/xsl/params/article.appendix.title.properties.xml; M: /trunk/xsl/params/ulink.target.xml; M: /trunk/xsl/params/suppress.header.navigation.xml; M: /trunk/xsl/params/olink.resolver.xml; M: /trunk/xsl/params/admon.textlabel.xml; M: /trunk/xsl/params/procedure.properties.xml; M: /trunk/xsl/params/blurb.on.titlepage.enabled.xml; M: /trunk/xsl/params/section.level2.properties.xml; M: /trunk/xsl/params/column.gap.front.xml; M: /trunk/xsl/params/margin.note.title.properties.xml; M: /trunk/xsl/params/glossary.collection.xml; M: /trunk/xsl/params/admon.graphics.xml; M: /trunk/xsl/params/current.docid.xml; M: /trunk/xsl/params/qanda.inherit.numeration.xml; M: /trunk/xsl/params/table.cell.padding.xml; M: /trunk/xsl/params/preface.autolabel.xml; M: /trunk/xsl/params/man.th.extra3.suppress.xml; M: /trunk/xsl/params/wordml.template.xml; M: /trunk/xsl/params/htmlhelp.use.hhk.xml; M: /trunk/xsl/params/textinsert.extension.xml; M: /trunk/xsl/params/ebnf.table.bgcolor.xml; M: /trunk/xsl/params/refentry.source.fallback.profile.xml; M: /trunk/xsl/params/body.font.master.xml; M: /trunk/xsl/params/l10n.gentext.default.language.xml; M: /trunk/xsl/params/list.block.properties.xml; M: /trunk/xsl/params/refentry.source.name.suppress.xml; M: /trunk/xsl/params/htmlhelp.hhp.window.xml; M: /trunk/xsl/params/sidebar.properties.xml; M: /trunk/xsl/params/tex.math.file.xml; M: /trunk/xsl/params/man.justify.xml; M: /trunk/xsl/params/subscript.properties.xml; M: /trunk/xsl/params/column.count.front.xml; M: /trunk/xsl/params/index.term.separator.xml; M: /trunk/xsl/params/biblioentry.properties.xml; M: /trunk/xsl/params/biblioentry.item.separator.xml; M: /trunk/xsl/params/htmlhelp.button.home.url.xml; M: /trunk/xsl/params/column.count.body.xml; M: /trunk/xsl/params/suppress.navigation.xml; M: /trunk/xsl/params/htmlhelp.remember.window.position.xml; M: /trunk/xsl/params/htmlhelp.hhc.section.depth.xml; M: /trunk/xsl/params/xref.with.number.and.title.xml; M: /trunk/xsl/params/make.year.ranges.xml; M: /trunk/xsl/params/region.before.extent.xml; M: /trunk/xsl/params/xref.label-page.separator.xml; M: /trunk/xsl/params/html.longdesc.link.xml; M: /trunk/xsl/params/man.subheading.divider.enabled.xml; M: /trunk/xsl/params/index.entry.properties.xml; M: /trunk/xsl/params/generate.legalnotice.link.xml; M: /trunk/xsl/params/section.autolabel.xml; M: /trunk/xsl/params/html.base.xml; M: /trunk/xsl/params/suppress.footer.navigation.xml; M: /trunk/xsl/params/nominal.image.depth.xml; M: /trunk/xsl/params/table.footnote.number.symbols.xml; M: /trunk/xsl/params/table.footnote.number.format.xml; M: /trunk/xsl/params/callout.graphics.xml; M: /trunk/xsl/params/man.break.after.slash.xml; M: /trunk/xsl/params/function.parens.xml; M: /trunk/xsl/params/part.autolabel.xml; M: /trunk/xsl/params/saxon.callouts.xml; M: /trunk/xsl/params/css.decoration.xml; M: /trunk/xsl/params/htmlhelp.button.home.xml; M: /trunk/xsl/params/email.delimiters.enabled.xml; M: /trunk/xsl/params/column.count.lot.xml; M: /trunk/xsl/params/draft.mode.xml; M: /trunk/xsl/params/use.role.for.mediaobject.xml; M: /trunk/xsl/params/refentry.separator.xml; M: /trunk/xsl/params/man.font.funcsynopsisinfo.xml; M: /trunk/xsl/params/man.output.manifest.filename.xml; M: /trunk/xsl/params/process.empty.source.toc.xml; M: /trunk/xsl/params/man.output.in.separate.dir.xml; M: /trunk/xsl/params/graphicsize.use.img.src.path.xml; M: /trunk/xsl/params/man.output.encoding.xml; M: /trunk/xsl/params/column.gap.lot.xml; M: /trunk/xsl/params/profile.role.xml; M: /trunk/xsl/params/column.count.titlepage.xml; M: /trunk/xsl/params/show.comments.xml; M: /trunk/xsl/params/informalfigure.properties.xml; M: /trunk/xsl/params/entry.propagates.style.xml; M: /trunk/xsl/params/bibliography.collection.xml; M: /trunk/xsl/params/contrib.inline.enabled.xml; M: /trunk/xsl/params/section.title.level5.properties.xml; M: /trunk/xsl/params/fop.extensions.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.xml; M: /trunk/xsl/params/man.hyphenate.urls.xml; M: /trunk/xsl/params/profile.condition.xml; M: /trunk/xsl/params/header.column.widths.xml; M: /trunk/xsl/params/annotation.js.xml; M: /trunk/xsl/params/chunker.output.standalone.xml; M: /trunk/xsl/params/targets.filename.xml; M: /trunk/xsl/params/default.float.class.xml; M: /trunk/xsl/params/chapter.autolabel.xml; M: /trunk/xsl/params/sidebar.float.type.xml; M: /trunk/xsl/params/profile.separator.xml; M: /trunk/xsl/params/generate.index.xml; M: /trunk/xsl/params/nongraphical.admonition.properties.xml; M: /trunk/xsl/params/navig.graphics.xml; M: /trunk/xsl/params/htmlhelp.button.next.xml; M: /trunk/xsl/params/insert.olink.pdf.frag.xml; M: /trunk/xsl/params/htmlhelp.button.stop.xml; M: /trunk/xsl/params/footnote.font.size.xml; M: /trunk/xsl/params/profile.value.xml; M: /trunk/xsl/params/ebnf.table.border.xml; M: /trunk/xsl/params/htmlhelp.hhc.folders.instead.books.xml; M: /trunk/xsl/params/glossary.as.blocks.xml; M: /trunk/xsl/params/body.end.indent.xml; M: /trunk/xsl/params/use.role.as.xrefstyle.xml; M: /trunk/xsl/params/man.indent.blurbs.xml; M: /trunk/xsl/params/chunker.output.encoding.xml; M: /trunk/xsl/params/chunker.output.omit-xml-declaration.xml; M: /trunk/xsl/params/sans.font.family.xml; M: /trunk/xsl/params/html.cleanup.xml; M: /trunk/xsl/params/htmlhelp.hhp.xml; M: /trunk/xsl/params/htmlhelp.only.xml; M: /trunk/xsl/params/eclipse.plugin.name.xml; M: /trunk/xsl/params/section.title.level3.properties.xml; M: /trunk/xsl/params/man.th.extra1.suppress.xml; M: /trunk/xsl/params/chunk.section.depth.xml; M: /trunk/xsl/params/htmlhelp.hhp.tail.xml; M: /trunk/xsl/params/sidebar.title.properties.xml; M: /trunk/xsl/params/hyphenate.xml; M: /trunk/xsl/params/paper.type.xml; M: /trunk/xsl/params/chunk.tocs.and.lots.has.title.xml; M: /trunk/xsl/params/symbol.font.family.xml; M: /trunk/xsl/params/page.margin.bottom.xml; M: /trunk/xsl/params/callout.unicode.number.limit.xml; M: /trunk/xsl/params/itemizedlist.properties.xml; M: /trunk/xsl/params/root.filename.xml; M: /trunk/xsl/params/tablecolumns.extension.xml; M: /trunk/xsl/params/htmlhelp.show.favorities.xml; M: /trunk/xsl/params/informaltable.properties.xml; M: /trunk/xsl/params/revhistory.table.cell.properties.xml; M: /trunk/xsl/params/htmlhelp.default.topic.xml; M: /trunk/xsl/params/compact.list.item.spacing.xml; M: /trunk/xsl/params/page.height.portrait.xml; M: /trunk/xsl/params/html.head.legalnotice.link.types.xml; M: /trunk/xsl/params/passivetex.extensions.xml; M: /trunk/xsl/params/orderedlist.label.properties.xml; M: /trunk/xsl/params/othercredit.like.author.enabled.xml; M: /trunk/xsl/params/header.content.properties.xml; M: /trunk/xsl/params/refentry.meta.get.quietly.xml; M: /trunk/xsl/params/section.properties.xml; M: /trunk/xsl/params/htmlhelp.button.hideshow.xml; M: /trunk/xsl/params/simplesect.in.toc.xml; M: /trunk/xsl/params/chunk.quietly.xml; M: /trunk/xsl/params/htmlhelp.enumerate.images.xml; M: /trunk/xsl/params/section.title.level1.properties.xml; M: /trunk/xsl/params/qanda.defaultlabel.xml; M: /trunk/xsl/params/htmlhelp.enhanced.decompilation.xml; M: /trunk/xsl/params/man.th.title.max.length.xml; M: /trunk/xsl/params/footnote.number.format.xml; M: /trunk/xsl/params/body.margin.bottom.xml; M: /trunk/xsl/params/htmlhelp.window.geometry.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.xml; M: /trunk/xsl/params/use.svg.xml; M: /trunk/xsl/params/qanda.title.level6.properties.xml; M: /trunk/xsl/params/collect.xref.targets.xml; M: /trunk/xsl/params/html.extra.head.links.xml; M: /trunk/xsl/params/variablelist.as.table.xml; M: /trunk/xsl/params/man.indent.width.xml; M: /trunk/xsl/params/eclipse.plugin.id.xml; M: /trunk/xsl/params/linenumbering.width.xml; M: /trunk/xsl/params/axf.extensions.xml; M: /trunk/xsl/params/menuchoice.separator.xml; M: /trunk/xsl/params/glossterm.separation.xml; M: /trunk/xsl/params/htmlhelp.autolabel.xml; M: /trunk/xsl/params/chunk.separate.lots.xml; M: /trunk/xsl/params/man.hyphenate.computer.inlines.xml; M: /trunk/xsl/params/linenumbering.separator.xml; M: /trunk/xsl/params/htmlhelp.title.xml; M: /trunk/xsl/params/index.number.separator.xml; M: /trunk/xsl/params/htmlhelp.button.prev.xml; M: /trunk/xsl/params/refentry.manual.fallback.profile.xml; M: /trunk/xsl/params/table.frame.border.color.xml; M: /trunk/xsl/params/footnote.sep.leader.properties.xml; M: /trunk/xsl/params/hyphenate.verbatim.characters.xml; M: /trunk/xsl/params/table.cell.border.thickness.xml; M: /trunk/xsl/params/template.xml; M: /trunk/xsl/params/margin.note.properties.xml; M: /trunk/xsl/params/man.segtitle.suppress.xml; M: /trunk/xsl/params/generate.toc.xml; M: /trunk/xsl/params/formal.object.properties.xml; M: /trunk/xsl/params/footnote.mark.properties.xml; M: /trunk/xsl/params/header.table.height.xml; M: /trunk/xsl/params/htmlhelp.button.back.xml; M: /trunk/xsl/params/qanda.title.level4.properties.xml; M: /trunk/xsl/params/man.links.are.numbered.xml; M: /trunk/xsl/params/manual.toc.xml; M: /trunk/xsl/params/olink.lang.fallback.sequence.xml; M: /trunk/xsl/params/refentry.manual.profile.enabled.xml; M: /trunk/xsl/params/ulink.hyphenate.chars.xml; M: /trunk/xsl/params/manifest.xml; M: /trunk/xsl/params/olink.fragid.xml; M: /trunk/xsl/params/refentry.date.profile.xml; M: /trunk/xsl/params/linenumbering.extension.xml; M: /trunk/xsl/params/component.title.properties.xml; M: /trunk/xsl/params/alignment.xml; M: /trunk/xsl/params/refentry.version.profile.xml; M: /trunk/xsl/params/ebnf.assignment.xml; M: /trunk/xsl/params/htmlhelp.button.print.xml; M: /trunk/xsl/params/annotation.support.xml; M: /trunk/xsl/params/sidebar.float.width.xml; M: /trunk/xsl/params/normal.para.spacing.xml; M: /trunk/xsl/params/xref.title-page.separator.xml; M: /trunk/xsl/params/callout.unicode.font.xml; M: /trunk/xsl/params/default.table.frame.xml; M: /trunk/xsl/params/pages.template.xml; M: /trunk/xsl/params/htmlhelp.button.zoom.xml; M: /trunk/xsl/params/admonition.title.properties.xml; M: /trunk/xsl/params/callout.graphics.extension.xml; M: /trunk/xsl/params/make.valid.html.xml; M: /trunk/xsl/params/qanda.title.level2.properties.xml; M: /trunk/xsl/params/page.margin.top.xml; M: /trunk/xsl/params/xep.index.item.properties.xml; M: /trunk/xsl/params/section.level5.properties.xml; M: /trunk/xsl/params/line-height.xml; M: /trunk/xsl/params/table.cell.border.color.xml; M: /trunk/xsl/params/qandadiv.autolabel.xml; M: /trunk/xsl/params/xref.label-title.separator.xml; M: /trunk/xsl/params/chunk.tocs.and.lots.xml; M: /trunk/xsl/params/man.font.funcprototype.xml; M: /trunk/xsl/params/process.source.toc.xml; M: /trunk/xsl/params/page.orientation.xml; M: /trunk/xsl/params/refentry.generate.name.xml; M: /trunk/xsl/params/navig.showtitles.xml; M: /trunk/xsl/params/table.table.properties.xml; M: /trunk/xsl/params/arbortext.extensions.xml; M: /trunk/xsl/params/informalequation.properties.xml; M: /trunk/xsl/params/headers.on.blank.pages.xml; M: /trunk/xsl/params/table.footnote.properties.xml; M: /trunk/xsl/params/root.properties.xml; M: /trunk/xsl/params/htmlhelp.display.progress.xml; M: /trunk/xsl/params/htmlhelp.hhp.windows.xml; M: /trunk/xsl/params/graphical.admonition.properties.xml; M: /trunk/xsl/params/refclass.suppress.xml; M: /trunk/xsl/params/profile.conformance.xml; M: /trunk/xsl/params/htmlhelp.button.forward.xml; M: /trunk/xsl/params/segmentedlist.as.table.xml; M: /trunk/xsl/params/margin.note.float.type.xml; M: /trunk/xsl/params/man.table.footnotes.divider.xml; M: /trunk/xsl/params/man.output.quietly.xml; M: /trunk/xsl/params/htmlhelp.hhc.show.root.xml; M: /trunk/xsl/params/footers.on.blank.pages.xml; M: /trunk/xsl/params/crop.mark.offset.xml; M: /trunk/xsl/params/olink.doctitle.xml; M: /trunk/xsl/params/section.level3.properties.xml; M: /trunk/xsl/params/callout.unicode.xml; M: /trunk/xsl/params/formal.procedures.xml; M: /trunk/xsl/params/toc.section.depth.xml; M: /trunk/xsl/params/index.prefer.titleabbrev.xml; M: /trunk/xsl/params/nominal.image.width.xml; M: /trunk/xsl/params/htmlhelp.show.menu.xml; M: /trunk/xsl/params/linenumbering.everyNth.xml; M: /trunk/xsl/params/double.sided.xml; M: /trunk/xsl/params/generate.revhistory.link.xml; M: /trunk/xsl/params/olink.properties.xml; M: /trunk/xsl/params/tex.math.in.alt.xml; M: /trunk/xsl/params/man.output.subdirs.enabled.xml; M: /trunk/xsl/params/section.title.properties.xml; M: /trunk/xsl/params/column.count.back.xml; M: /trunk/xsl/params/toc.indent.width.xml; M: /trunk/xsl/params/man.charmap.uri.xml; M: /trunk/xsl/params/index.method.xml; M: /trunk/xsl/params/generate.section.toc.level.xml; M: /trunk/xsl/params/page.width.portrait.xml; M: /trunk/xsl/params/man.th.extra2.max.length.xml; M: /trunk/xsl/params/abstract.properties.xml; M: /trunk/xsl/params/revhistory.table.properties.xml; M: /trunk/xsl/params/nominal.table.width.xml; M: /trunk/xsl/params/ulink.show.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.title.xml; M: /trunk/xsl/params/index.div.title.properties.xml; M: /trunk/xsl/params/profile.userlevel.xml; M: /trunk/xsl/params/html.cellpadding.xml; M: /trunk/xsl/params/orderedlist.label.width.xml; M: /trunk/xsl/params/crop.marks.xml; M: /trunk/xsl/params/menuchoice.menu.separator.xml; M: /trunk/xsl/params/author.othername.in.middle.xml; M: /trunk/xsl/params/section.level1.properties.xml; M: /trunk/xsl/params/textdata.default.encoding.xml; M: /trunk/xsl/params/label.from.part.xml; M: /trunk/xsl/params/use.embed.for.svg.xml; M: /trunk/xsl/params/list.item.spacing.xml; M: /trunk/xsl/params/htmlhelp.hhc.width.xml; M: /trunk/xsl/params/column.gap.body.xml; M: /trunk/xsl/params/rootid.xml; M: /trunk/xsl/params/glosslist.as.blocks.xml; M: /trunk/xsl/params/index.range.separator.xml; M: /trunk/xsl/params/html.ext.xml; M: /trunk/xsl/params/callout.list.table.xml; M: /trunk/xsl/params/highlight.source.xml; M: /trunk/xsl/params/show.revisionflag.xml; M: /trunk/xsl/params/man.output.manifest.enabled.xml; M: /trunk/xsl/params/make.single.year.ranges.xml; M: /trunk/xsl/params/pgwide.properties.xml; M: /trunk/xsl/params/generate.id.attributes.xml; M: /trunk/xsl/params/emphasis.propagates.style.xml; M: /trunk/xsl/params/abstract.title.properties.xml; M: /trunk/xsl/params/htmlhelp.hhc.xml; M: /trunk/xsl/params/monospace.properties.xml; M: /trunk/xsl/params/htmlhelp.hhk.xml; M: /trunk/xsl/params/table.borders.with.css.xml; M: /trunk/xsl/params/man.links.are.underlined.xml; M: /trunk/xsl/params/profile.vendor.xml; M: /trunk/xsl/params/shade.verbatim.xml; M: /trunk/xsl/params/callout.graphics.path.xml; M: /trunk/xsl/params/olink.debug.xml; M: /trunk/xsl/params/make.graphic.viewport.xml; M: /trunk/xsl/params/footnote.number.symbols.xml; M: /trunk/xsl/params/man.charmap.enabled.xml; M: /trunk/xsl/params/page.height.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.url.xml; M: /trunk/xsl/params/man.font.table.title.xml; M: /trunk/xsl/params/revhistory.title.properties.xml; M: /trunk/xsl/params/chunker.output.media-type.xml; M: /trunk/xsl/params/glossterm.width.xml; M: /trunk/xsl/params/points.per.em.xml; M: /trunk/xsl/params/page.margin.inner.xml; M: /trunk/xsl/params/itemizedlist.label.width.xml; M: /trunk/xsl/params/ulink.hyphenate.xml; M: /trunk/xsl/params/crop.mark.bleed.xml; M: /trunk/xsl/params/use.id.as.filename.xml; M: /trunk/xsl/params/section.title.level6.properties.xml; M: /trunk/xsl/params/highlight.default.language.xml; M: /trunk/xsl/params/man.th.extra2.suppress.xml; M: /trunk/xsl/params/id.warnings.xml; M: /trunk/xsl/params/title.margin.left.xml; M: /trunk/xsl/params/chunker.output.doctype-system.xml; M: /trunk/xsl/params/man.indent.verbatims.xml; M: /trunk/xsl/params/table.frame.border.thickness.xml; M: /trunk/xsl/params/monospace.verbatim.properties.xml; M: /trunk/xsl/params/formal.title.properties.xml; M: /trunk/xsl/params/margin.note.width.xml; M: /trunk/xsl/params/man.hyphenate.filenames.xml; M: /trunk/xsl/params/blockquote.properties.xml; M: /trunk/xsl/params/callout.defaultcolumn.xml; M: /trunk/xsl/params/profile.security.xml; M: /trunk/xsl/params/informal.object.properties.xml; M: /trunk/xsl/params/formal.title.placement.xml; M: /trunk/xsl/params/draft.watermark.image.xml; M: /trunk/xsl/params/equation.properties.xml; M: /trunk/xsl/params/body.font.family.xml; M: /trunk/xsl/params/ignore.image.scaling.xml; M: /trunk/xsl/params/chunk.first.sections.xml; M: /trunk/xsl/params/base.dir.xml; M: /trunk/xsl/params/footnote.properties.xml; M: /trunk/xsl/params/olink.outline.ext.xml; M: /trunk/xsl/params/img.src.path.xml; M: /trunk/xsl/params/qanda.title.properties.xml; M: /trunk/xsl/params/ebnf.statement.terminator.xml; M: /trunk/xsl/params/callouts.extension.xml; M: /trunk/xsl/params/manifest.in.base.dir.xml; M: /trunk/xsl/params/fop1.extensions.xml; M: /trunk/xsl/params/olink.sysid.xml; M: /trunk/xsl/params/section.title.level4.properties.xml; M: /trunk/xsl/params/monospace.font.family.xml; M: /trunk/xsl/params/l10n.gentext.language.xml; M: /trunk/xsl/params/graphic.default.extension.xml; M: /trunk/xsl/params/default.image.width.xml; M: /trunk/xsl/params/htmlhelp.button.refresh.xml; M: /trunk/xsl/params/chunker.output.cdata-section-elements.xml; M: /trunk/xsl/params/admon.graphics.path.xml; M: /trunk/xsl/params/admon.style.xml; M: /trunk/xsl/params/profile.revision.xml; M: /trunk/xsl/params/generate.manifest.xml; M: /trunk/xsl/params/html.longdesc.xml; M: /trunk/xsl/params/footer.rule.xml; M: /trunk/xsl/params/eclipse.plugin.provider.xml; M: /trunk/xsl/params/refentry.source.name.profile.xml; M: /trunk/xsl/params/toc.max.depth.xml; M: /trunk/xsl/params/chunker.output.indent.xml; M: /trunk/xsl/params/html.head.legalnotice.link.multiple.xml; M: /trunk/xsl/params/toc.list.type.xml; M: /trunk/xsl/params/link.mailto.url.xml; M: /trunk/xsl/params/table.properties.xml; M: /trunk/xsl/params/side.float.properties.xml; M: /trunk/xsl/params/man.charmap.use.subset.xml; M: /trunk/xsl/params/annotation.graphic.open.xml; M: /trunk/xsl/params/html.cellspacing.xml; M: /trunk/xsl/params/default.table.width.xml; M: /trunk/xsl/params/xep.extensions.xml; M: /trunk/xsl/params/admonition.properties.xml; M: /trunk/xsl/params/toc.margin.properties.xml; M: /trunk/xsl/params/chunk.toc.xml; M: /trunk/xsl/params/table.entry.padding.xml; M: /trunk/xsl/params/header.rule.xml; M: /trunk/xsl/params/glossentry.show.acronym.xml; M: /trunk/xsl/params/variablelist.as.blocks.xml; M: /trunk/xsl/params/man.hyphenate.xml; M: /trunk/xsl/params/refentry.source.name.profile.enabled.xml; M: /trunk/xsl/params/section.label.includes.component.label.xml; M: /trunk/xsl/params/bridgehead.in.toc.xml; M: /trunk/xsl/params/section.title.level2.properties.xml; M: /trunk/xsl/params/admon.graphics.extension.xml; M: /trunk/xsl/params/inherit.keywords.xml; M: /trunk/xsl/params/insert.xref.page.number.xml; M: /trunk/xsl/params/pixels.per.inch.xml; M: /trunk/xsl/params/refentry.pagebreak.xml; M: /trunk/xsl/params/profile.lang.xml; M: /trunk/xsl/params/insert.olink.page.number.xml; M: /trunk/xsl/params/generate.meta.abstract.xml; M: /trunk/xsl/params/graphicsize.extension.xml; M: /trunk/xsl/params/man.indent.lists.xml; M: /trunk/xsl/params/funcsynopsis.decoration.xml; M: /trunk/xsl/params/runinhead.title.end.punct.xml; M: /trunk/xsl/params/man.string.subst.map.xml; M: /trunk/xsl/params/man.links.list.enabled.xml; M: /trunk/xsl/params/section.autolabel.max.depth.xml; M: /trunk/xsl/params/htmlhelp.show.advanced.search.xml; M: /trunk/xsl/params/htmlhelp.map.file.xml; M: /trunk/xsl/params/l10n.gentext.use.xref.language.xml; M: /trunk/xsl/params/body.font.size.xml; M: /trunk/xsl/params/html.stylesheet.type.xml; M: /trunk/xsl/params/refentry.xref.manvolnum.xml; M: /trunk/xsl/params/runinhead.default.title.end.punct.xml; M: /trunk/xsl/params/navig.graphics.extension.xml; M: /trunk/xsl/params/itemizedlist.label.properties.xml; M: /trunk/xsl/params/htmlhelp.force.map.and.alias.xml; M: /trunk/xsl/params/profile.os.xml; M: /trunk/xsl/params/htmlhelp.alias.file.xml; M: /trunk/xsl/params/page.margin.outer.xml; M: /trunk/xsl/params/annotation.graphic.close.xml; M: /trunk/xsl/params/eclipse.autolabel.xml; M: /trunk/xsl/params/table.frame.border.style.xml; M: /trunk/xsl/params/navig.graphics.path.xml; M: /trunk/xsl/params/htmlhelp.hhc.binary.xml; M: /trunk/xsl/params/index.on.type.xml; M: /trunk/xsl/params/target.database.document.xml; M: /trunk/xsl/params/man.subheading.divider.xml; M: /trunk/xsl/params/chunker.output.method.xml; M: /trunk/xsl/params/make.index.markup.xml; M: /trunk/xsl/params/olink.base.uri.xml; M: /trunk/xsl/params/phrase.propagates.style.xml; M: /trunk/xsl/params/man.indent.refsect.xml; M: /trunk/xsl/params/example.properties.xml; M: /trunk/xsl/params/man.font.table.headings.xml; M: /trunk/xsl/params/profile.revisionflag.xml; M: /trunk/xsl/params/region.after.extent.xml; M: /trunk/xsl/params/qanda.title.level5.properties.xml; M: /trunk/xsl/params/marker.section.level.xml; M: /trunk/xsl/params/footer.table.height.xml; M: /trunk/xsl/params/autotoc.label.separator.xml; M: /trunk/xsl/params/footer.column.widths.xml; M: /trunk/xsl/params/hyphenate.verbatim.xml; M: /trunk/xsl/params/xref.properties.xml; M: /trunk/xsl/params/man.output.base.dir.xml; M: /trunk/xsl/params/man.links.list.heading.xml; M: /trunk/xsl/params/insert.link.page.number.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.title.xml; M: /trunk/xsl/params/l10n.lang.value.rfc.compliant.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Updated index.method doc to describe revised setup for importing <tag>index</tag> extensions.<alt>M: /trunk/xsl/params/index.method.xml - Robert Stayton</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
+content on HTML <tag>title</tag> pages:
+
+<parameter>contrib.inline.enabled</parameter>:
+ If non-zero (the default), output of the <tag>contrib</tag> element is
+ displayed as inline content rather than as block content.
+
+<parameter>othercredit.like.author.enabled</parameter>:
+ If non-zero, output of the <tag>othercredit</tag> element on titlepages is
+ displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
+ (the default), <tag>othercredit</tag> output is displayed using a style
+ different than that of <tag>author</tag> and <tag>editor</tag>.
+
+<parameter>blurb.on.titlepage.enabled</parameter>:
+ If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
+ displayed on <tag>title</tag> pages. If zero (the default), output from
+ those elements is suppressed on <tag>title</tag> pages (unless you are
+ using a titlepage customization that causes them to be included).
+
+<parameter>editedby.enabled</parameter>
+ If non-zero (the default), a localized Edited by heading is
+ displayed above <tag>editor</tag> names in output of the <tag>editor</tag> element.<alt>A: /trunk/xsl/params/contrib.inline.enabled.xml; A: /trunk/xsl/params/blurb.on.titlepage.enabled.xml; A: /trunk/xsl/params/othercredit.like.author.enabled.xml; A: /trunk/xsl/params/editedby.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
+default), delimiters are generated around e-mail addresses (output
+of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>A: /trunk/xsl/params/email.delimiters.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
+non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
+of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
+(from Daniel Leidert). Currently on affects HTML output (no patch
+for FO output provided).<alt>A: /trunk/xsl/params/qanda.nested.in.toc.xml - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+<listitem>
+<literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>A: /trunk/xsl/params/highlight.source.xml; A: /trunk/xsl/params/highlight.default.language.xml - Jirka Kosek</alt></phrase></literallayout>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.71.0-->
+
+<sect2 xml:id="V1.71.0_Tools">
+<title>Tools</title>
+<para>The following changes have been made to the
+ <filename>tools</filename> code
+ since the 1.70.1 release.</para>
+<itemizedlist>
+
+<listitem>
+<literallayout><phrase role="commit-message">Racheted down font sizes of headings in example makefile FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added param and attribute set to example makefile, for getting
+wrapping in verbatims in FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Renamed Makefile.paramDoc to Makefile.docParam.<alt>A: /trunk/xsl/tools/make/Makefile.docParam; D: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added Makefile.paramDoc file, for creating versions of param.xsl
+files with doc embedded.<alt>A: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+<listitem>
+<literallayout><phrase role="commit-message">Added variable to example makefile for controlling whether HTML or
+XHTML is generated.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
+</listitem>
+
+</itemizedlist>
+</sect2><!--end of Tools changes for 1.71.0-->
+</sect1>
+
+<sect1 xml:id="V1701">
+<title>Release: 1.70.1</title>
+
+<para>This is a stable release of the 1.70 stylesheets. It includes only a
+few small changes from 1.70.0.</para>
+
+<para>The following is a list of changes that have been made
+ since the 1.70.0 release.</para>
+
+<sect2 xml:id="V1701_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.70.0 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</para>
+<para role="commit-changes">Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support DBv5 revisions with full author name (not only authorinitials)</para>
+<para role="commit-changes">Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for 1.70.1-->
+
+<sect2 xml:id="V1701_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.70.0 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Support DBv5 revisions with full author name (not only authorinitials)</para>
+<para role="commit-changes">Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for 1.70.1-->
+
+<sect2 xml:id="V1701_HTMLHelp">
+<title>HTMLHelp</title>
+<para>The following changes have been made to the
+ <filename>htmlhelp</filename> code
+ since the 1.70.0 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3).</para>
+<para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support chunk.tocs.and.lots in HTML Help</para>
+<para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTMLHelp changes for 1.70.1-->
+
+<sect2 xml:id="V1701_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.70.0 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</para>
+<para role="commit-changes">Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for 1.70.1-->
+
+</sect1>
+
+<sect1 xml:id="V1700">
+<title>Release: 1.70.0</title>
+<para>As with all DocBook Project <link linkend="dot0">dot-zero</link>
+releases, this is an experimental release. It will be followed shortly
+by a stable release.</para>
+
+<para>This release adds a number of new features,
+including:</para>
+
+<itemizedlist>
+ <listitem>
+ <para>support for selecting alternative index-collation methods
+ (in particular, support for using a collation library developed by
+ Eliot Kimber)</para>
+ </listitem>
+ <listitem>
+ <para>improved handling of DocBook 5 document instances (through a
+ namespace-stripping mechanism)</para>
+ </listitem>
+ <listitem>
+ <para>full support for CALS and HTML tables in manpages
+ output</para>
+ </listitem>
+ <listitem>
+ <para>a mechanism for preserving relative URIs in documents that
+ make use of XInclude</para>
+ </listitem>
+ <listitem>
+ <para>support for the "new" <literal>.90</literal> version of
+ FOP</para>
+ </listitem>
+ <listitem>
+ <para>enhanced capabilities for controlling formatting of lists in HTML
+ and FO output</para>
+ </listitem>
+ <listitem>
+ <para>autogeneration of AUTHOR and COPYRIGHT sections in manpages
+ output</para>
+ </listitem>
+ <listitem>
+ <para>support for generating crop marks in FO/PDF output</para>
+ </listitem>
+ <listitem>
+ <para>support for qandaset as a root element in FO output</para>
+ </listitem>
+ <listitem>
+ <para>support for floatstyle and orient on all table types</para>
+ </listitem>
+ <listitem>
+ <para>support for floatstyle in figure, and example</para>
+ </listitem>
+ <listitem>
+ <para>pgwide.properties attribute-set supports extending figure,
+ example and table into the left indent area instead of spanning
+ multiple columns.</para>
+ </listitem>
+</itemizedlist>
+ <para>The following is a detailed list of enhancements and API
+ changes that have been made since the 1.69.1 release.</para>
+
+<sect2 xml:id="V1700_Common">
+<title>Common</title>
+<para>The following changes have been made to the
+ <filename>common</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Add the xsl:key for the kimber
+indexing method.</para>
+<para role="commit-changes">Modified: common/autoidx-ng.xsl,1.2 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for
+<tag>qandaset</tag>.</para>
+<para role="commit-changes">Modified: common/labels.xsl,1.37;
+common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support dbhtml/dbfo start PI for
+<tag>orderedlist</tag> numbering in both HTML and
+FO</para>
+<para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added CVS
+header.</para>
+<para role="commit-changes">Modified: common/stripns.xsl,1.12 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Changed content model of text
+element to ANY rather than #PCDATA because they could contain
+markup.</para>
+<para role="commit-changes">Modified: common/targetdatabase.dtd,1.7 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+<tag>refentry</tag>.meta.get.quietly param.</para>
+<para>If zero (the
+default), notes and warnings about "missing" markup are generated
+during gathering of <tag>refentry</tag> metadata. If
+non-zero, the metadata is gathered "quietly" -- that is, the
+notes and warnings are suppressed.</para>
+<para>NOTE: If you are
+processing a large amount of <tag>refentry</tag> content, you
+may be able to speed up processing significantly by setting a
+non-zero value for
+<tag>refentry</tag>.meta.get.quietly.</para>
+<para role="commit-changes">Modified: common/refentry.xsl,1.17;
+manpages/param.ent,1.15; manpages/param.xweb,1.17;
+params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>After namespace stripping, the
+source document is the temporary tree created by the stripping
+process and it has the wrong base <tag>URI</tag> for relative
+references. Earlier versions of this code used to try to fix that
+by patching the elements with relative @fileref attributes. That
+was inadequate because it calculated an absolute base <tag>URI</tag>
+without considering that there might be xml:base attributes
+already in effect. It seems obvious now that the right thing to
+do is simply to put the xml:base on the root of the document. And
+that seems to work.</para>
+<para role="commit-changes">Modified: common/stripns.xsl,1.7 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for "software" and
+"sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
+treated identically to "source", and "setdesc" is treated
+identically to "manual".</para>
+<para role="commit-changes">Modified: common/refentry.xsl,1.10;
+params/man.th.extra2.max.length.xml,1.3;
+params/refentry.source.name.profile.xml,1.4 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for DocBook 5
+namespace-stripping in manpages stylesheet. Closes request
+#1210692.</para>
+<para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added &lt;xsl:template
+match="/"&gt; to make stripns.xsl usable as a standalone
+stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that
+DocBook XSLT drivers that include this stylesheet all override
+the match="/" template.</para>
+<para role="commit-changes">Modified: common/stripns.xsl,1.4 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Number figures, examples, and
+tables from <tag>book</tag> if there is no prefix (i.e. if
+<parameter>chapter.autolabel</parameter> is set to 0). This avoids
+having the list of figures where the figures mysteriously restart
+their numeration periodically when
+<parameter>chapter.autolabel</parameter> is set to
+0.</para>
+<para role="commit-changes">Modified: common/labels.xsl,1.36 - David Cramer</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add <tag>task</tag> template in
+<tag>title</tag>.markup mode.</para>
+<para role="commit-changes">Modified: common/titles.xsl,1.34 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add children (with ids) of formal
+objects to target data.</para>
+<para role="commit-changes">Modified: common/targets.xsl,1.10 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for case when
+<tag>personname</tag> doesn't contain specific name markup (as allowed
+in DocBook 5.0)</para>
+<para role="commit-changes">Modified: common/common.xsl,1.54 - Jirka
+Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Common changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_Extensions">
+<title>Extensions</title>
+<para>The following changes have been made to the
+ <filename>extensions</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Support Xalan
+2.7</para>
+<para role="commit-changes">Modified: extensions/xalan27/.cvsignore,1.1;
+extensions/xalan27/build.xml,1.1;
+extensions/xalan27/nbproject/.cvsignore,1.1;
+extensions/xalan27/nbproject/build-impl.xml,1.1;
+extensions/xalan27/nbproject/genfiles.properties,1.1;
+extensions/xalan27/nbproject/project.properties,1.1;
+extensions/xalan27/nbproject/project.xml,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1;
+extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Handle the case where the imageFn
+is actually a <tag>URI</tag>. This still needs
+work.</para>
+<para role="commit-changes">Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4
+- Norman Walsh</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Extensions changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_FO">
+<title>FO</title>
+<para>The following changes have been made to the
+ <filename>fo</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Adapted to the new indexing
+code. Now works just like a wrapper that calls kosek indexing method,
+originally implemented here.</para>
+<para role="commit-changes">Modified: fo/autoidx-ng.xsl,1.5 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added parameters for header/footer
+<tag>table</tag> minimum height.</para>
+<para role="commit-changes">Modified: fo/pagesetup.xsl,1.60;
+fo/param.ent,1.100; fo/param.xweb,1.113 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add the <tag>index</tag>.method
+parameter.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Integrate support for three
+indexing methods: - the original English-only method. -
+Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
+method using Saxon extensions. Use the '<tag>index</tag>.method'
+parameter to select.</para>
+<para role="commit-changes">Modified: fo/autoidx.xsl,1.38 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for <tag>TOC</tag> for
+<tag>qandaset</tag> in fo output.</para>
+<para role="commit-changes">Modified: fo/autotoc.xsl,1.30;
+fo/qandaset.xsl,1.20 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added parameter
+<parameter>ulink.hyphenate</parameter>.chars. Added parameter
+insert.<tag>link</tag>.page.number.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.98;
+fo/param.xweb,1.111 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented feature request
+#942524 to add insert.<tag>link</tag>.page.number to allow link
+element cross references to have a page number.</para>
+<para role="commit-changes">Modified: fo/xref.xsl,1.67 -
+Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for
+<parameter>ulink.hyphenate</parameter>.chars so more characters
+can be break points in urls.</para>
+<para role="commit-changes">Modified: fo/xref.xsl,1.66 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented patch #1075144 to make
+the url text in a ulink in FO output an active <tag>link</tag> as
+well.</para>
+<para role="commit-changes">Modified: fo/xref.xsl,1.65 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para><tag>table</tag> footnotes now
+have their own <tag>table</tag>.<tag>footnote</tag>.properties
+attribute set.</para>
+<para role="commit-changes">Modified: fo/footnote.xsl,1.23 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add <tag>qandaset</tag> to
+root.elements.</para>
+<para role="commit-changes">Modified: fo/docbook.xsl,1.41 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added mode="page.sequence" to make
+it easier to put content into a page sequence. First used for
+<tag>qandaset</tag>.</para>
+<para role="commit-changes">Modified: fo/component.xsl,1.37 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented feature request
+#1434408 to support formatting
+of <tag>biblioentry</tag>.</para>
+<para role="commit-changes">Modified: fo/biblio.xsl,1.35 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+<tag>biblioentry</tag>.properties.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.97;
+fo/param.xweb,1.110 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support PTC/Arbortext
+bookmarks</para>
+<para role="commit-changes">Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+<tag>table</tag>.<tag>footnote</tag>.properties to permit
+<tag>table</tag> footnotes to format differently from regular
+footnotes.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Refactored <tag>table</tag>
+templates to unify their processing and support all options in
+all types. Now <tag>table</tag> and <tag>informaltable</tag>, in
+both Cals and Html markup, use the same templates where possible,
+and all support pgwide, rotation, and floats. There is also a
+placeholder <tag>table</tag>.container template to
+support wrapping a <tag>table</tag> in a layout <tag>table</tag>,
+so the XEP <tag>table</tag> <tag>title</tag> "continued"
+extension can be more easily implemented.</para>
+<para role="commit-changes">Modified: fo/formal.xsl,1.52;
+fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new attribute set
+<tag>toc</tag>.line.properties for controlling appearance of lines in
+ToC/LoT</para>
+<para role="commit-changes">Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95;
+fo/param.xweb,1.108 - Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for float to example
+and <tag>equation</tag>. Added support for pgwide to
+<tag>figure</tag>, example, and <tag>equation</tag> (the latter
+two via a dbfo pgwide="1" processing
+instruction).</para>
+<para role="commit-changes">Modified: fo/formal.xsl,1.51 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add pgwide.properties
+attribute-set.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added <tag>refclass</tag>.suppress
+param.</para>
+<para>If the value of <tag>refclass</tag>.suppress is
+non-zero, then display <tag>refclass</tag> contents is suppressed
+in output. Affects HTML and FO output
+only.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
+html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Improved support for
+<tag>task</tag> subelements</para>
+<para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
+Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Adjusted spacing around
+K&amp;R-formatted <tag>Funcdef</tag> and <tag>Paramdef</tag>
+output such that it can more easily be discerned where one ends
+and the other begins. Closes #1213264.</para>
+<para role="commit-changes">Modified: fo/synop.xsl,1.18 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Made handling of
+paramdef/parameter in FO output consistent with that in HTML and
+manpages output. Closes #1213259.</para>
+<para role="commit-changes">Modified: fo/synop.xsl,1.17 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Made handling of
+<tag>Refnamediv</tag> consistent with formatting in HTML
+and manpages output; specifically, changed so that
+<tag>Refname</tag> (comma-separated list of multiple instances
+found) is used (instead of <tag>Refentrytitle</tag> as
+previously), then em-dash, then the <tag>Refpurpose</tag>. Closes
+#1212562.</para>
+<para role="commit-changes">Modified: fo/refentry.xsl,1.30 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added output of
+<tag>Releaseinfo</tag> to recto titlepage ("<tag>copyright</tag>"
+page) for <tag>Book</tag> in FO output. This makes it consistent
+with HTML output. Closes #1327034. Thanks to Paul DuBois for
+reporting.</para>
+<para role="commit-changes">Modified: fo/titlepage.templates.xml,1.28 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added condition for setting
+block-progression-dimension.minimum on table-row, instead of
+height, when <parameter>fop1.extensions</parameter> is
+non-zero. For an explanation of the reason for the change,
+<tag>see</tag>: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages</para>
+<para role="commit-changes">Modified: fo/pagesetup.xsl,1.59
+- Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new
+<tag>refclass</tag>.suppress param for suppressing display
+of <tag>Refclass</tag> in HTML and FO output. Did not add it to
+manpages because manpages stylesheet is currently just silently
+ignoring <tag>Refclass</tag> anyway. Closes request
+#1461065. Thanks to Davor Ocelic (docelic) for
+reporting.</para>
+<para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for keep-together PI
+to informal objects.</para>
+<para role="commit-changes">Modified: fo/formal.xsl,1.50 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for
+<parameter>fop1.extensions</parameter>.</para>
+<para role="commit-changes">Modified: fo/formal.xsl,1.49;
+fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for fop1
+bookmarks.</para>
+<para role="commit-changes">Modified: fo/docbook.xsl,1.39 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add fop1.extentions parameter to
+add support for fop development version.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.92;
+fo/param.xweb,1.105 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Start supporting fop development
+version, which will become fop version 1.</para>
+<para role="commit-changes">Modified: fo/fop1.xsl,1.1 -
+Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add template for <tag>task</tag>
+in mode="xref-to".</para>
+<para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para><tag>table</tag> footnotes now
+also get <tag>footnote</tag>.properties
+attribute-set.</para>
+<para role="commit-changes">Modified: fo/footnote.xsl,1.22 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added <tag>index</tag>.separator
+named template to compute the separator punctuation based on
+locale.</para>
+<para role="commit-changes">Modified: fo/autoidx.xsl,1.36 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for <tag>link</tag>,
+<tag>olink</tag>, and <tag>xref</tag> within OO
+<tag>Classsynopsis</tag> and children. (Because DocBook NG/5
+allows it).</para>
+<para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support <tag>date</tag> as an
+inline</para>
+<para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new parameter
+<parameter>keep.relative.image.uris</parameter></para>
+<para role="commit-changes">Modified: fo/param.ent,1.91;
+fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
+params/keep.relative.image.uris.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Map Unicode space characters
+U+2000-U+200A to fo:leaders.</para>
+<para role="commit-changes">Modified: fo/docbook.xsl,1.38;
+fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Output a real em dash for em-dash
+dingbat (instead of two hypens).</para>
+<para role="commit-changes">Modified: fo/fo.xsl,1.7 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support default <tag>label</tag>
+width parameters for itemized and ordered lists</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.64;
+fo/param.ent,1.90; fo/param.xweb,1.103;
+params/itemizedlist.label.width.xml,1.1;
+params/orderedlist.label.width.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Generate localized
+<tag>title</tag> for <tag>Refsynopsisdiv</tag> if no
+appropriate <tag>Title</tag> descendant found in source. Closes
+#1212398. This change makes behavior for the <tag>Synopsis</tag>
+<tag>title</tag> consistent with the behavior of HTML and
+manpages output.</para>
+<para>Also, added
+xsl:use-attribute-sets="normal.<tag>para</tag>.spacing" to
+block generated for <tag>Cmdsynopsis</tag> output. Previously,
+that block had no spacing at all specified, which resulted it
+being crammed up to closely to the <tag>Synopsis</tag>
+head.</para>
+<para role="commit-changes">Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added parameters to support
+localization of <tag>index</tag>
+item punctuation.</para>
+<para role="commit-changes">Modified: fo/autoidx.xsl,1.35 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+<parameter>index.number.separator</parameter>,
+<parameter>index.range.separator</parameter>,
+and <parameter>index.term.separator</parameter> parameters to
+support localization of punctuation in <tag>index</tag>
+entries.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added "Cross References"
+<tag>section</tag> in HTML doc (for consistency with the FO
+doc). Also, moved the existing FO "Cross
+References" <tag>section</tag> to follow the "Linking"
+<tag>section</tag>.</para>
+<para role="commit-changes">Modified: fo/param.xweb,1.101; html/param.xweb,1.95 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added ID attribues to all
+<tag>Reference</tag> elements (e.g., id="tables" for the doc for
+<tag>section</tag> on <tag>Table</tag> params). So pages for
+all subsections of ref docs now have stable filenames instead
+of arbitrary generated filenames.</para>
+<para role="commit-changes">Modified: fo/param.xweb,1.100;
+html/param.xweb,1.94 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added two new parameters for
+handling of multi-term
+<tag>varlistentry</tag> elements:</para>
+<para><parameter>variablelist.term.break.after</parameter>:
+When the <parameter>variablelist.term.break.after</parameter> is
+non-zero, it will generate a line break after each
+<tag>term</tag> multi-term
+<tag>varlistentry</tag>.</para>
+<para><parameter>variablelist.term.separator</parameter>:
+When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
+elements, the string specified in the value of the
+<parameter>variablelist.term.separator</parameter> parameter is
+placed after each <tag>term</tag> except the last. The default
+is ", " (a comma followed by a space). To suppress rendering of
+the separator, set the value of
+<parameter>variablelist.term.separator</parameter> to the empty
+string ("").</para>
+<para>These parameters are primarily intended to be
+useful if you have multi-term varlistentries that have long
+terms.</para>
+<para>Closes #1306676. Thanks to Sam Steingold for
+providing an example "lots of long terms" doc that demonstrated
+the value of having these options.</para>
+<para>Also, added
+normalize-space() call to processing of each
+<tag>term</tag>.</para>
+<para>This change affects all output formats
+(HTML, PDF, manpages). The default behavior should pretty much
+remain the same as before, but it is possible (as always) that
+the change may introduce some
+new bugginess.</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
+fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
+html/param.xweb,1.93; manpages/lists.xsl,1.22;
+manpages/param.ent,1.14; manpages/param.xweb,1.16;
+params/variablelist.term.break.after.xml,1.1;
+params/variablelist.term.separator.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add <tag>sidebar</tag> titlepage
+placeholder attset for styles.</para>
+<para role="commit-changes">Modified: fo/titlepage.xsl,1.37 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add titlepage for
+<tag>sidebar</tag>.</para>
+<para role="commit-changes">Modified: fo/titlepage.templates.xml,1.27 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented RFE
+#1292615.</para>
+<para>Added bunch of new parameters (attribute sets)
+that affect list presentation: list.block.properties,
+<tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
+<tag>itemizedlist</tag>.<tag>label</tag>.properties and
+<tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
+of stylesheets has not been changed but further customizations will be
+much more easier.</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
+fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
+params/itemizedlist.properties.xml,1.1;
+params/list.block.properties.xml,1.1;
+params/orderedlist.label.properties.xml,1.1;
+params/orderedlist.properties.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented RFE
+#1242092.</para>
+<para>You can enable crop marks in your document by
+setting crop.marks=1 and xep.extensions=1. Appearance of crop
+marks can be controlled by parameters
+<parameter>crop.mark.bleed</parameter> (6pt),
+<parameter>crop.mark.offset</parameter> (24pt) and
+<parameter>crop.mark.width</parameter> (0.5pt).</para>
+<para>Also there
+is new named template called user-xep-pis. You can overwrite it in
+order to produce some PIs that can control XEP as described in
+http://www.renderx.com/reference.html#Output_Formats</para>
+<para role="commit-changes">Modified: fo/docbook.xsl,1.36;
+fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
+params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
+params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of FO changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_HTML">
+<title>HTML</title>
+<para>The following changes have been made to the
+ <filename>html</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>implemented
+<tag>index</tag>.method parameter and three
+methods.</para>
+<para role="commit-changes">Modified: html/autoidx.xsl,1.28 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>added <tag>index</tag>.method
+parameter to support 3 indexing methods.</para>
+<para role="commit-changes">Modified: html/param.ent,1.94;
+html/param.xweb,1.103 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented feature request
+#1072510 as a processing instruction to permit including external
+HTML content into HTML output.</para>
+<para role="commit-changes">Modified: html/pi.xsl,1.9 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new parameter
+<parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
+controls presence of <tag>title</tag> in a separate chunk with
+ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
+generating frameset output (well, yes those frames, but some customers
+really want them ;-).</para>
+<para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
+html/param.ent,1.93; html/param.xweb,1.102;
+params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support dbhtml/dbfo start PI for
+<tag>orderedlist</tag> numbering in both HTML and
+FO</para>
+<para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Allow <tag>ToC</tag> without
+<tag>title</tag> also for set and
+<tag>book</tag>.</para>
+<para role="commit-changes">Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 -
+Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented floats uniformly for
+<tag>figure</tag>, example, <tag>equation</tag>
+and <tag>informalfigure</tag>, <tag>informalexample</tag>, and
+<tag>informalequation</tag>.</para>
+<para role="commit-changes">Modified: html/formal.xsl,1.22 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added the
+autotoc.<tag>label</tag>.in.hyperlink param.</para>
+<para>If the value
+of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
+are included in hyperlinked titles in the <tag>TOC</tag>. If it
+is instead zero, labels are still displayed prior to the
+hyperlinked titles, but are not hyperlinked along with the
+titles.</para>
+<para>Closes patch #1065868. Thanks to anatoly techtonik
+for the patch.</para>
+<para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
+html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added two new params:
+html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
+and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
+<para>If
+the value of the <parameter>generate.legalnotice.link</parameter> is
+non-zero, then the stylesheet generates (in the head
+<tag>section</tag> of the HTML source) either a single HTML
+<tag>link</tag> element or, if the value of
+the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
+non-zero, one <tag>link</tag> element for each <tag>link</tag>
+type specified. Each <tag>link</tag> has the
+following attributes:</para>
+<para> - a rel attribute whose value
+is derived from the value of
+html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
+<para> -
+an href attribute whose value is set to the URL of the file
+containing the <tag>legalnotice</tag></para>
+<para> - a <tag>title</tag>
+attribute whose value is set to the <tag>title</tag> of the
+corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
+programatically determined by the stylesheet)</para>
+<para>For
+example:</para>
+<para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
+href="ln-id2524073.html" title="Legal Notice"&gt;</para>
+<para>Closes
+#1476450. Thanks to Sam Steingold.</para>
+<para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
+html/param.ent,1.91; html/param.xweb,1.100;
+params/generate.legalnotice.link.xml,1.4;
+params/html.head.legalnotice.link.multiple.xml,1.1;
+params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added <tag>refclass</tag>.suppress
+param.</para>
+<para>If the value of <tag>refclass</tag>.suppress is
+non-zero, then display <tag>refclass</tag> contents is suppressed
+in output. Affects HTML and FO output
+only.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
+html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Improved support for
+<tag>task</tag> subelements</para>
+<para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
+Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new
+<tag>refclass</tag>.suppress param for suppressing display
+of <tag>Refclass</tag> in HTML and FO output. Did not add it to
+manpages because manpages stylesheet is currently just silently
+ignoring <tag>Refclass</tag> anyway. Closes request
+#1461065. Thanks to Davor Ocelic (docelic) for
+reporting.</para>
+<para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Process <tag>alt</tag> text with
+normalize-space(). Replace tab indents with
+spaces.</para>
+<para role="commit-changes">Modified: html/graphics.xsl,1.57 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Content of <tag>citation</tag>
+element is automatically linked to the bibliographic <tag>entry</tag>
+with the corresponding <tag>abbrev</tag>.</para>
+<para role="commit-changes">Modified: html/biblio.xsl,1.26;
+html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add template for <tag>task</tag>
+in mode="xref-to".</para>
+<para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Suppress ID warnings if the
+.warnings parameter is 0</para>
+<para role="commit-changes">Modified: html/html.xsl,1.17 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for floatstyle to
+<tag>figure</tag>.</para>
+<para role="commit-changes">Modified: html/formal.xsl,1.21 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Handling of <tag>xref</tag> to
+area/areaset need support in extensions code also. I currently have no
+time to touch extensions code, so code is here to be enabled when
+extension is fixed also.</para>
+<para role="commit-changes">Modified: html/xref.xsl,1.56 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added 3 parameters for overriding
+gentext for <tag>index</tag>
+punctuation.</para>
+<para role="commit-changes">Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added parameters to support
+localization of <tag>index</tag> item punctuation. Added
+<tag>index</tag>.separator named template to compute
+the separator punctuation based on
+locale.</para>
+<para role="commit-changes">Modified: html/autoidx.xsl,1.27 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added a &lt;div
+class="{$class}-contents"&gt; wrapper around output of contents
+of all formal objects. Also, added an optional &lt;br
+class="{class}-break"/&gt; linebreak after all formal
+objects.</para>
+<para>WARNING: Because this change places an additional
+DIV between the DIV wrapper for the <tag>equation</tag> and the
+<tag>equation</tag> contents, it may break some existing CSS
+stylesheets that have been created with the assumption that there
+would never be an intervening DIV there.</para>
+<para>The following is
+an example of what <tag>Equation</tag> output looks like as a
+result of the changes described above.</para>
+<para> &lt;div
+class="<tag>equation</tag>"&gt; &lt;a name="three"
+id="three"&gt;&lt;/a&gt;</para>
+<para> &lt;p
+class="<tag>title</tag>"&gt;&lt;b&gt;(1.3)&lt;/b&gt;&lt;/p&gt;</para>
+<para>
+&lt;div class="equation-contents"&gt; &lt;span
+class="<tag>mathphrase</tag>"&gt;1+1=3&lt;/span&gt;
+&lt;/div&gt; &lt;/div&gt;&lt;br
+class="equation-break"&gt;</para>
+<para>Rationale: These changes allow
+CSS control of the placement of the formal-object
+<tag>title</tag> relative to the formal-object
+contents. For example, using the CSS "float" <tag>property</tag>
+enables the <tag>title</tag> and contents to be rendered on the
+same line. Example stylesheet:</para>
+<para> .<tag>equation</tag>
+{ margin-top: 20px; margin-bottom: 20px; }
+.equation-contents { float: left; }</para>
+<para>
+.<tag>equation</tag> .<tag>title</tag> { margin-top: 0;
+float: right; margin-right: 200px; }</para>
+<para>
+.<tag>equation</tag> .<tag>title</tag> b { font-weight:
+normal; }</para>
+<para> .equation-break { clear: both;
+}</para>
+<para>Note that the purpose of the ".equation-break" class is
+to provide a way to clear off the floats.</para>
+<para>If you want
+to instead have the <tag>equation</tag> <tag>title</tag> rendered to
+the left of the <tag>equation</tag> contents, you can do
+something like this:</para>
+<para> .<tag>equation</tag> {
+margin-top: 20px; width: 300px; margin-bottom: 20px;
+} .equation-contents { float: right; }</para>
+<para>
+.<tag>equation</tag> .<tag>title</tag> { margin-top: 0;
+float: left; margin-right: 200px; }</para>
+<para>
+.<tag>equation</tag> .<tag>title</tag> b { font-weight:
+normal; }</para>
+<para> .equation-break { clear: both;
+}</para>
+<para role="commit-changes">Modified: html/formal.xsl,1.20 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added a chunker.output.quiet
+top-level parameter so that the chunker can be made quiet by
+default</para>
+<para role="commit-changes">Modified: html/chunker.xsl,1.26 - Norman Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for <tag>link</tag>,
+<tag>olink</tag>, and <tag>xref</tag> within OO
+<tag>Classsynopsis</tag> and children. (Because DocBook NG/5
+allows it).</para>
+<para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>New parameter:
+<parameter>id.warnings</parameter>. If non-zero, warnings are
+generated for titled objects that don't have titles. True by default;
+I wonder if this will be too aggressive?</para>
+<para role="commit-changes">Modified: html/biblio.xsl,1.25;
+html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
+html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
+html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
+html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>If the
+<parameter>keep.relative.image.uris</parameter> parameter is true,
+don't use the absolute <tag>URI</tag> (as calculated from xml:base) in
+the img src attribute, us the value the <tag>author</tag>
+specified. Note that we still have to calculate the absolute
+<tag>filename</tag> for use in the image intrinsics
+extension.</para>
+<para role="commit-changes">Modified: html/graphics.xsl,1.56 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support <tag>date</tag> as an
+inline</para>
+<para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new parameter
+<parameter>keep.relative.image.uris</parameter></para>
+<para role="commit-changes">Modified: fo/param.ent,1.91;
+fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
+params/keep.relative.image.uris.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added two new parameters for
+handling of multi-term
+<tag>varlistentry</tag> elements:</para>
+<para><parameter>variablelist.term.break.after</parameter>:
+When the <parameter>variablelist.term.break.after</parameter> is
+non-zero, it will generate a line break after each
+<tag>term</tag> multi-term
+<tag>varlistentry</tag>.</para>
+<para><parameter>variablelist.term.separator</parameter>:
+When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
+elements, the string specified in the value of the
+<parameter>variablelist.term.separator</parameter> parameter is
+placed after each <tag>term</tag> except the last. The default
+is ", " (a comma followed by a space). To suppress rendering of
+the separator, set the value of
+<parameter>variablelist.term.separator</parameter> to the empty
+string ("").</para>
+<para>These parameters are primarily intended to be
+useful if you have multi-term varlistentries that have long
+terms.</para>
+<para>Closes #1306676. Thanks to Sam Steingold for
+providing an example "lots of long terms" doc that demonstrated
+the value of having these options.</para>
+<para>Also, added
+normalize-space() call to processing of each
+<tag>term</tag>.</para>
+<para>This change affects all output formats
+(HTML, PDF, manpages). The default behavior should pretty much
+remain the same as before, but it is possible (as always) that
+the change may introduce some
+new bugginess.</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
+fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
+html/param.xweb,1.93; manpages/lists.xsl,1.22;
+manpages/param.ent,1.14; manpages/param.xweb,1.16;
+params/variablelist.term.break.after.xml,1.1;
+params/variablelist.term.separator.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added "wrapper-name" param to
+inline.charseq named template, enabling it to output inlines
+other than just "span". <tag>Acronym</tag> and <tag>Abbrev</tag>
+templates now use inline.charseq to output HTML
+"<tag>acronym</tag>" and "abbr" elements (instead of
+"span"). Closes #1305468. Thanks to Sam Steingold for suggesting
+the change.</para>
+<para role="commit-changes">Modified: html/inline.xsl,1.45 - Michael(tm)
+Smith</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of HTML changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_Manpages">
+<title>Manpages</title>
+<para>The following changes have been made to the
+ <filename>manpages</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Added the following
+params:</para>
+<para> - man.indent.width (string-valued) -
+man.indent.refsect (boolean) - man.indent.blurbs (boolean)
+- man.indent.lists (boolean) - man.indent.verbatims
+(boolean)</para>
+<para>Note that in earlier snapshots, man.indent.width
+was named man.indentation.default.value and the boolean params
+had names like man.indentation.*.adjust. Also the
+man.indent.blurbs param was called man.indentation.authors.adjust
+(or something).</para>
+<para>The behavior now is: If the value of a
+particular man.indent.* boolean param is non-zero, the
+corresponding contents (refsect*, list items,
+authorblurb/personblurb, vervatims) are displayed with a left
+margin indented by a width equal to the value
+of man.indent.width.</para>
+<para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
+manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
+manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
+manpages/param.ent,1.22; manpages/param.xweb,1.24;
+manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
+params/man.indent.refsect.xml,1.1;
+params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.<tag>table</tag>.footnotes.divider param.</para>
+<para>In each
+<tag>table</tag> that contains footenotes, the string specified
+by the man.<tag>table</tag>.footnotes.divider parameter is output
+before the list of footnotes for the
+<tag>table</tag>.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
+manpages/links.xsl,1.6; manpages/param.ent,1.21;
+manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added the
+man.output.in.separate.dir,
+man.output.<parameter>base.dir</parameter>,
+and man.output.subdirs.enabled parameters.</para>
+<para>The
+man.output.<parameter>base.dir</parameter> parameter specifies the
+base directory into which man-page files are
+output. The man.output.subdirs.enabled parameter controls whether
+the files are output in subdirectories within the base
+directory.</para>
+<para>The values of the
+man.output.<parameter>base.dir</parameter>
+and man.output.subdirs.enabled parameters are used only if the
+value of man.output.in.separate.dir parameter is non-zero. If the
+value of man.output.in.separate.dir is zero, man-page files are
+not output in a separate
+directory.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
+manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
+params/man.output.in.separate.dir.xml,1.1;
+params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.font.<tag>table</tag>.headings and
+man.font.<tag>table</tag>.<tag>title</tag> params, for
+controlling font in <tag>table</tag> headings and
+titles.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
+manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
+params/man.font.table.title.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.font.<tag>funcsynopsisinfo</tag> and
+man.font.<tag>funcprototype</tag> params, for specifying the roff
+font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
+<tag>funcprototype</tag> output.</para>
+<para role="commit-changes">Modified: manpages/block.xsl,1.19;
+manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
+manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
+manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
+params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.<tag>segtitle</tag>.suppress param.</para>
+<para>If the value of
+man.<tag>segtitle</tag>.suppress is non-zero, then display
+of <tag>segtitle</tag> contents is suppressed in
+output.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
+manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.output.<parameter>manifest</parameter>.enabled and
+man.output.manifest.<tag>filename</tag> params.</para>
+<para>If
+man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
+of filenames for man pages generated by the stylesheet
+transformation is written to the file named by
+man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
+manpages/other.xsl,1.19; manpages/param.ent,1.16;
+manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
+params/man.output.manifest.filename.xml,1.1;
+tools/make/Makefile.DocBook,1.4 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+<tag>refentry</tag>.meta.get.quietly param.</para>
+<para>If zero (the
+default), notes and warnings about "missing" markup are generated
+during gathering of <tag>refentry</tag> metadata. If
+non-zero, the metadata is gathered "quietly" -- that is, the
+notes and warnings are suppressed.</para>
+<para>NOTE: If you are
+processing a large amount of <tag>refentry</tag> content, you
+may be able to speed up processing significantly by setting a
+non-zero value for
+<tag>refentry</tag>.meta.get.quietly.</para>
+<para role="commit-changes">Modified: common/refentry.xsl,1.17;
+manpages/param.ent,1.15; manpages/param.xweb,1.17;
+params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Changed names of all boolean
+indentation params to man.indent.* Also discarded individual
+man.indent.*.value params and switched to just using a common
+man.indent.width param (3n by default).</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.66;
+manpages/info.xsl,1.19; manpages/lists.xsl,1.29;
+manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added boolean
+man.output.in.separate.dir param, to control whether or not man
+files are output in separate directory.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.65;
+manpages/utility.xsl,1.14 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added options for controlling
+indentation of verbatim output. Controlled through the
+man.indentation.verbatims.adjust
+and man.indentation.verbatims.value params. Closes
+#1242997</para>
+<para role="commit-changes">Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added options for controlling
+indentation in lists and in *blurb output in the AUTHORS
+<tag>section</tag>. Controlled through
+the man.indentation.lists.adjust,
+man.indentation.lists.value, man.indentation.authors.adjust, and
+man.indentation.authors.value parameters. Default is 3 characters
+(instead of the roff default of 8 characters). Closes
+#1449369.</para>
+<para>Also, removed the indent that was being set on
+<tag>informalexample</tag> outuput. I will instead add an option
+for indenting verbatims, which I think is what the
+<tag>informalexample</tag> indent was intended
+for originally.</para>
+<para role="commit-changes">Modified: manpages/block.xsl,1.14;
+manpages/docbook.xsl,1.63; manpages/info.xsl,1.18;
+manpages/lists.xsl,1.28 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Changed line-spacing call before
+<tag>synopfragment</tag> to use ".sp -1n" ("n" units specified)
+instead of plain ".sp -1"</para>
+<para role="commit-changes">Modified: manpages/synop.xsl,1.28 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for writing man
+files into a specific output directory and into appropriate
+subdirectories within that output directory. Controlled through
+the man.<parameter>base.dir</parameter> parameter (similar to the
+<parameter>base.dir</parameter> support in the HTML stylesheet) and
+the man.subdirs.enabled parameter, which automatically determines
+the name of an appropriate subdir (for example, man/man7,
+man/man1, etc.) based on the <tag>section</tag> number/manvolnum
+of the source <tag>Refentry</tag>.</para>
+<para>Closes #1255036 and
+#1170317. Thanks to Denis Bradford for the original feature
+request, and to Costin Stroie for submitting a patch that was
+very helpful in implementing the
+support.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Refined XPath statements and
+notification messages for <tag>refentry</tag> metadata
+handling.</para>
+<para role="commit-changes">Modified: common/common.xsl,1.59; common/refentry.xsl,1.14;
+manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for
+<tag>copyright</tag> and <tag>legalnotice</tag>. The manpages
+stylesheets now output a <tag>COPYRIGHT</tag> <tag>section</tag>,
+after the AUTHORS <tag>section</tag>, if a <tag>copyright</tag>
+or <tag>legalnotice</tag> is found in the source. The
+<tag>section</tag> contains the <tag>copyright</tag> contents followed
+by the <tag>legalnotice</tag> contents. Closes
+#1450209.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Drastically reworked all of the
+XPath expressions used in <tag>refentry</tag> metadata gathering
+-- completely removed $parentinfo and turned $info into a set of
+nodes that includes the *info contents of the <tag>Refentry</tag>
+plus the *info contents all all of its ancestor elements. The
+basic XPath expression now used throughout is (using the example
+of checking for a <tag>date</tag>):</para>
+<para>
+(($info[//date])[last()]/date)[1].</para>
+<para>That selects the "last"
+*info/date <tag>date</tag> in document order -- that is, the one
+eitther on the <tag>Refentry</tag> itself or on the
+closest ancestor to the <tag>Refentry</tag>.</para>
+<para>It's
+likely this change may break some things; may need to pick up
+some pieces later.</para>
+<para>Also, changed the default value for the
+<parameter>man.th.extra2.max.length</parameter> from 40 to
+30.</para>
+<para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
+params/man.th.extra2.max.length.xml,1.2;
+params/refentry.date.profile.xml,1.2;
+params/refentry.manual.profile.xml,1.2;
+params/refentry.source.name.profile.xml,1.2;
+params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
+manpages/other.xsl,1.15 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for DocBook 5
+namespace-stripping in manpages stylesheet. Closes request
+#1210692.</para>
+<para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Fixed handling of <tag>table</tag>
+footnotes. With this checkin, the <tag>table</tag> support in the
+manpages stylesheet is now basically feature complete. So this
+change closes request #619532, "No support for tables" -- the
+oldest currently open manpages feature request, submitted by Ben
+Secrest (blsecres) on 2002-10-07. Congratulations to me [patting
+myself on the back].</para>
+<para role="commit-changes">Modified: manpages/block.xsl,1.11;
+manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added handling for
+<tag>table</tag> titles. Also fixed handling of nested tables;
+nest tables are now "extracted" and displayed just after their
+parent tables.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14
+- Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added option for turning off bold
+formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
+<tag>function</tag> <tag>synopsis</tag> is mandated in the
+man(7) man page and is used almost universally in existing man
+pages. Despite that, it really does look like crap to have an
+entire <tag>Funcsynopsis</tag> output in bold, so I added params
+for turning off the bold formatting and/or replacing it with a
+different roff special font (e.g., "RI" for alternating
+roman/italic instead of the default "BI" for alternating
+bold/italic). The new params
+are "man.<tag>funcprototype</tag>.font" and
+"man.<tag>funcsynopsisinfo</tag>.font". To be documented
+later.</para>
+<para>Closes #1452247. Thanks to Joe Orton for the feature
+request.</para>
+<para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
+manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
+manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Use AUTHORS instead of
+<tag>AUTHOR</tag> if we have multiple people to attribute. Also,
+fixed checking such that we generate
+<tag>author</tag> <tag>section</tag> even if we don't have an
+<tag>author</tag> (as long as there is at least one other
+person/entity we can put in the
+<tag>section</tag>). Also adjusted assembly of content for
+<tag>Author</tag> metainfo field such that we now not only use
+<tag>author</tag>, but try to find a "best match" if we can't
+find an <tag>author</tag> name to put there.</para>
+<para>Closes
+#1233592. Thanks to Sam Steingold for the
+request.</para>
+<para role="commit-changes">Modified: manpages/info.xsl,1.12 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Changes for request #1243027,
+"Impove handling of <tag>AUTHOR</tag> <tag>section</tag>." This
+adds support for <tag>Collab</tag>, Corpauthor, Corpcredt,
+<tag>Orgname</tag>, <tag>Publishername</tag>, and
+<tag>Publisher</tag>. Also adds support for output
+of <tag>Affiliation</tag> and its children, and support for using
+gentext strings for auto-attributing roles (<tag>Author</tag>,
+<tag>Editor</tag>, <tag>Publisher</tag>, Translator, etc.). Also
+did a lot of code cleanup and modularization of all the
+<tag>AUTHOR</tag> handling code. And fixed a bug that was causing
+<tag>Author</tag> <tag>info</tag> to not be picked up correctly
+for metainfo comment we embed in man-page
+source.</para>
+<para role="commit-changes">Modified: manpages/info.xsl,1.11 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support bold output for
+"<tag>emphasis</tag> remap='B'". (because Eric Raymond's
+doclifter(1) tool converts groff source marked up with ".B"
+request or "\fB" escapes to DocBook "<tag>emphasis</tag>
+remap='B'".)</para>
+<para role="commit-changes">Modified: manpages/inline.xsl,1.14 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for
+<tag>Segmentedlist</tag>. Details: Output is tabular, with no
+option for "list" type output. Output for <tag>Segtitle</tag>
+elements can be supressed by
+setting man.<tag>segtitle</tag>.suppress. If <tag>Segtitle</tag>
+content is output, it is rendered in italic type (not bold
+because not all terminals support bold and so italic ensures the
+stand out on those terminals). Extra space (.sp line) at end of
+<tag>table</tag> code ensures that it gets handled correctly in
+the case where its source is the child of a <tag>Para</tag>.
+Closes feature-request #1400097. Thanks to Daniel Leidert for the
+patch and push, and to Alastair Rankine for filing the original
+feature request.</para>
+<para role="commit-changes">Modified: manpages/lists.xsl,1.23;
+manpages/utility.xsl,1.10 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Improved handling or
+Author/Editor/Othercredit.</para>
+<para>Reworked content of
+(non-visible) comment added at top of each page (metadata
+stuff).</para>
+<para>Added support for generating a
+<parameter>manifest</parameter> file (useful for cleaning up
+after builds, etc.)</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.46;
+manpages/info.xsl,1.9; manpages/other.xsl,1.12;
+manpages/utility.xsl,1.6 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added two new parameters for
+handling of multi-term
+<tag>varlistentry</tag> elements:</para>
+<para><parameter>variablelist.term.break.after</parameter>:
+When the <parameter>variablelist.term.break.after</parameter> is
+non-zero, it will generate a line break after each
+<tag>term</tag> multi-term
+<tag>varlistentry</tag>.</para>
+<para><parameter>variablelist.term.separator</parameter>:
+When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
+elements, the string specified in the value of the
+<parameter>variablelist.term.separator</parameter> parameter is
+placed after each <tag>term</tag> except the last. The default
+is ", " (a comma followed by a space). To suppress rendering of
+the separator, set the value of
+<parameter>variablelist.term.separator</parameter> to the empty
+string ("").</para>
+<para>These parameters are primarily intended to be
+useful if you have multi-term varlistentries that have long
+terms.</para>
+<para>Closes #1306676. Thanks to Sam Steingold for
+providing an example "lots of long terms" doc that demonstrated
+the value of having these options.</para>
+<para>Also, added
+normalize-space() call to processing of each
+<tag>term</tag>.</para>
+<para>This change affects all output formats
+(HTML, PDF, manpages). The default behavior should pretty much
+remain the same as before, but it is possible (as always) that
+the change may introduce some
+new bugginess.</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
+fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
+html/param.xweb,1.93; manpages/lists.xsl,1.22;
+manpages/param.ent,1.14; manpages/param.xweb,1.16;
+params/variablelist.term.break.after.xml,1.1;
+params/variablelist.term.separator.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Manpages changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_Params">
+<title>Params</title>
+<para>The following changes have been made to the
+ <filename>params</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>New parameters to set
+header/footer <tag>table</tag> minimum
+height.</para>
+<para role="commit-changes">Modified: params/footer.table.height.xml,1.1;
+params/header.table.height.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support multiple indexing methods
+for different languages.</para>
+<para role="commit-changes">Modified: params/index.method.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Remove <tag>qandaset</tag> and
+<tag>qandadiv</tag> from <parameter>generate.toc</parameter> for fo
+output because formerly it wasn't working, but now it is and
+the default behavior should stay the
+same.</para>
+<para role="commit-changes">Modified: params/generate.toc.xml,1.8 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>add support for page number
+references to <tag>link</tag> element
+too.</para>
+<para role="commit-changes">Modified: params/insert.link.page.number.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Add support for more characters to
+hyphen on when <parameter>ulink.hyphenate</parameter> is turned
+on.</para>
+<para role="commit-changes">Modified: params/ulink.hyphenate.chars.xml,1.1;
+params/ulink.hyphenate.xml,1.3 - Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>New attribute-set to format
+<tag>biblioentry</tag> and
+<tag>bibliomixed</tag>.</para>
+<para role="commit-changes">Modified: params/biblioentry.properties.xml,1.1 -
+Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new parameter
+<parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
+controls presence of <tag>title</tag> in a separate chunk with
+ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
+generating frameset output (well, yes those frames, but some customers
+really want them ;-).</para>
+<para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
+html/param.ent,1.93; html/param.xweb,1.102;
+params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new attribute set
+<tag>toc</tag>.line.properties for controlling appearance of lines in
+ToC/LoT</para>
+<para role="commit-changes">Modified: params/toc.line.properties.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Allow <tag>table</tag> footnotes
+to have different properties from regular
+footnotes.</para>
+<para role="commit-changes">Modified: params/table.footnote.properties.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Set properties for pgwide="1"
+objects.</para>
+<para role="commit-changes">Modified: params/pgwide.properties.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added the
+autotoc.<tag>label</tag>.in.hyperlink param.</para>
+<para>If the value
+of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
+are included in hyperlinked titles in the <tag>TOC</tag>. If it
+is instead zero, labels are still displayed prior to the
+hyperlinked titles, but are not hyperlinked along with the
+titles.</para>
+<para>Closes patch #1065868. Thanks to anatoly techtonik
+for the patch.</para>
+<para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
+html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added two new params:
+html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
+and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
+<para>If
+the value of the <parameter>generate.legalnotice.link</parameter> is
+non-zero, then the stylesheet generates (in the head
+<tag>section</tag> of the HTML source) either a single HTML
+<tag>link</tag> element or, if the value of
+the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
+non-zero, one <tag>link</tag> element for each <tag>link</tag>
+type specified. Each <tag>link</tag> has the
+following attributes:</para>
+<para> - a rel attribute whose value
+is derived from the value of
+html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
+<para> -
+an href attribute whose value is set to the URL of the file
+containing the <tag>legalnotice</tag></para>
+<para> - a <tag>title</tag>
+attribute whose value is set to the <tag>title</tag> of the
+corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
+programatically determined by the stylesheet)</para>
+<para>For
+example:</para>
+<para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
+href="ln-id2524073.html" title="Legal Notice"&gt;</para>
+<para>Closes
+#1476450. Thanks to Sam Steingold.</para>
+<para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
+html/param.ent,1.91; html/param.xweb,1.100;
+params/generate.legalnotice.link.xml,1.4;
+params/html.head.legalnotice.link.multiple.xml,1.1;
+params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added the following
+params:</para>
+<para> - man.indent.width (string-valued) -
+man.indent.refsect (boolean) - man.indent.blurbs (boolean)
+- man.indent.lists (boolean) - man.indent.verbatims
+(boolean)</para>
+<para>Note that in earlier snapshots, man.indent.width
+was named man.indentation.default.value and the boolean params
+had names like man.indentation.*.adjust. Also the
+man.indent.blurbs param was called man.indentation.authors.adjust
+(or something).</para>
+<para>The behavior now is: If the value of a
+particular man.indent.* boolean param is non-zero, the
+corresponding contents (refsect*, list items,
+authorblurb/personblurb, vervatims) are displayed with a left
+margin indented by a width equal to the value
+of man.indent.width.</para>
+<para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
+manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
+manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
+manpages/param.ent,1.22; manpages/param.xweb,1.24;
+manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
+params/man.indent.refsect.xml,1.1;
+params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.<tag>table</tag>.footnotes.divider param.</para>
+<para>In each
+<tag>table</tag> that contains footenotes, the string specified
+by the man.<tag>table</tag>.footnotes.divider parameter is output
+before the list of footnotes for the
+<tag>table</tag>.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
+manpages/links.xsl,1.6; manpages/param.ent,1.21;
+manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added the
+man.output.in.separate.dir,
+man.output.<parameter>base.dir</parameter>,
+and man.output.subdirs.enabled parameters.</para>
+<para>The
+man.output.<parameter>base.dir</parameter> parameter specifies the
+base directory into which man-page files are
+output. The man.output.subdirs.enabled parameter controls whether
+the files are output in subdirectories within the base
+directory.</para>
+<para>The values of the
+man.output.<parameter>base.dir</parameter>
+and man.output.subdirs.enabled parameters are used only if the
+value of man.output.in.separate.dir parameter is non-zero. If the
+value of man.output.in.separate.dir is zero, man-page files are
+not output in a separate
+directory.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
+manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
+params/man.output.in.separate.dir.xml,1.1;
+params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.font.<tag>table</tag>.headings and
+man.font.<tag>table</tag>.<tag>title</tag> params, for
+controlling font in <tag>table</tag> headings and
+titles.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
+manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
+params/man.font.table.title.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.font.<tag>funcsynopsisinfo</tag> and
+man.font.<tag>funcprototype</tag> params, for specifying the roff
+font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
+<tag>funcprototype</tag> output.</para>
+<para role="commit-changes">Modified: manpages/block.xsl,1.19;
+manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
+manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
+manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
+params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Changed to select="0" in
+<tag>refclass</tag>.suppress (instead of
+..&gt;0&lt;/..)</para>
+<para role="commit-changes">Modified: params/refclass.suppress.xml,1.3 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.<tag>segtitle</tag>.suppress param.</para>
+<para>If the value of
+man.<tag>segtitle</tag>.suppress is non-zero, then display
+of <tag>segtitle</tag> contents is suppressed in
+output.</para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
+manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
+Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+man.output.<parameter>manifest</parameter>.enabled and
+man.output.manifest.<tag>filename</tag> params.</para>
+<para>If
+man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
+of filenames for man pages generated by the stylesheet
+transformation is written to the file named by
+man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
+<para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
+manpages/other.xsl,1.19; manpages/param.ent,1.16;
+manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
+params/man.output.manifest.filename.xml,1.1;
+tools/make/Makefile.DocBook,1.4 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added <tag>refclass</tag>.suppress
+param.</para>
+<para>If the value of <tag>refclass</tag>.suppress is
+non-zero, then display <tag>refclass</tag> contents is suppressed
+in output. Affects HTML and FO output
+only.</para>
+<para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
+html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added
+<tag>refentry</tag>.meta.get.quietly param.</para>
+<para>If zero (the
+default), notes and warnings about "missing" markup are generated
+during gathering of <tag>refentry</tag> metadata. If
+non-zero, the metadata is gathered "quietly" -- that is, the
+notes and warnings are suppressed.</para>
+<para>NOTE: If you are
+processing a large amount of <tag>refentry</tag> content, you
+may be able to speed up processing significantly by setting a
+non-zero value for
+<tag>refentry</tag>.meta.get.quietly.</para>
+<para role="commit-changes">Modified: common/refentry.xsl,1.17;
+manpages/param.ent,1.15; manpages/param.xweb,1.17;
+params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added support for "software" and
+"sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
+treated identically to "source", and "setdesc" is treated
+identically to "manual".</para>
+<para role="commit-changes">Modified: common/refentry.xsl,1.10;
+params/man.th.extra2.max.length.xml,1.3;
+params/refentry.source.name.profile.xml,1.4 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Drastically reworked all of the
+XPath expressions used in <tag>refentry</tag> metadata gathering
+-- completely removed $parentinfo and turned $info into a set of
+nodes that includes the *info contents of the <tag>Refentry</tag>
+plus the *info contents all all of its ancestor elements. The
+basic XPath expression now used throughout is (using the example
+of checking for a <tag>date</tag>):</para>
+<para>
+(($info[//date])[last()]/date)[1].</para>
+<para>That selects the "last"
+*info/date <tag>date</tag> in document order -- that is, the one
+eitther on the <tag>Refentry</tag> itself or on the
+closest ancestor to the <tag>Refentry</tag>.</para>
+<para>It's
+likely this change may break some things; may need to pick up
+some pieces later.</para>
+<para>Also, changed the default value for the
+<parameter>man.th.extra2.max.length</parameter> from 40 to
+30.</para>
+<para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
+params/man.th.extra2.max.length.xml,1.2;
+params/refentry.date.profile.xml,1.2;
+params/refentry.manual.profile.xml,1.2;
+params/refentry.source.name.profile.xml,1.2;
+params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
+manpages/other.xsl,1.15 - Michael(tm) Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added option for turning off bold
+formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
+<tag>function</tag> <tag>synopsis</tag> is mandated in the
+man(7) man page and is used almost universally in existing man
+pages. Despite that, it really does look like crap to have an
+entire <tag>Funcsynopsis</tag> output in bold, so I added params
+for turning off the bold formatting and/or replacing it with a
+different roff special font (e.g., "RI" for alternating
+roman/italic instead of the default "BI" for alternating
+bold/italic). The new params
+are "man.<tag>funcprototype</tag>.font" and
+"man.<tag>funcsynopsisinfo</tag>.font". To be documented
+later.</para>
+<para>Closes #1452247. Thanks to Joe Orton for the feature
+request.</para>
+<para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
+manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
+manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para><parameter>fop.extensions</parameter> now only
+for FOP version 0.20.5 and earlier.</para>
+<para role="commit-changes">Modified: params/fop.extensions.xml,1.4
+- Robert Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support for fop1 different from
+fop 0.20.5 and earlier.</para>
+<para role="commit-changes">Modified: params/fop1.extensions.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Reset default value to empty
+string so template uses gentext first, then the parameter value
+if not empty.</para>
+<para role="commit-changes">Modified: params/index.number.separator.xml,1.2;
+params/index.range.separator.xml,1.2;
+params/index.term.separator.xml,1.2 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>New parameter:
+<parameter>id.warnings</parameter>. If non-zero, warnings are
+generated for titled objects that don't have titles. True by default;
+I wonder if this will be too aggressive?</para>
+<para role="commit-changes">Modified: html/biblio.xsl,1.25;
+html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
+html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
+html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
+html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added new parameter
+<parameter>keep.relative.image.uris</parameter></para>
+<para role="commit-changes">Modified: fo/param.ent,1.91;
+fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
+params/keep.relative.image.uris.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Support default <tag>label</tag>
+width parameters for itemized and ordered lists</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.64;
+fo/param.ent,1.90; fo/param.xweb,1.103;
+params/itemizedlist.label.width.xml,1.1;
+params/orderedlist.label.width.xml,1.1 - Norman
+Walsh</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added parameters to localize
+punctuation in indexes.</para>
+<para role="commit-changes">Modified: params/index.number.separator.xml,1.1;
+params/index.range.separator.xml,1.1;
+params/index.term.separator.xml,1.1 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Added two new parameters for
+handling of multi-term
+<tag>varlistentry</tag> elements:</para>
+<para><parameter>variablelist.term.break.after</parameter>:
+When the <parameter>variablelist.term.break.after</parameter> is
+non-zero, it will generate a line break after each
+<tag>term</tag> multi-term
+<tag>varlistentry</tag>.</para>
+<para><parameter>variablelist.term.separator</parameter>:
+When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
+elements, the string specified in the value of the
+<parameter>variablelist.term.separator</parameter> parameter is
+placed after each <tag>term</tag> except the last. The default
+is ", " (a comma followed by a space). To suppress rendering of
+the separator, set the value of
+<parameter>variablelist.term.separator</parameter> to the empty
+string ("").</para>
+<para>These parameters are primarily intended to be
+useful if you have multi-term varlistentries that have long
+terms.</para>
+<para>Closes #1306676. Thanks to Sam Steingold for
+providing an example "lots of long terms" doc that demonstrated
+the value of having these options.</para>
+<para>Also, added
+normalize-space() call to processing of each
+<tag>term</tag>.</para>
+<para>This change affects all output formats
+(HTML, PDF, manpages). The default behavior should pretty much
+remain the same as before, but it is possible (as always) that
+the change may introduce some
+new bugginess.</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
+fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
+html/param.xweb,1.93; manpages/lists.xsl,1.22;
+manpages/param.ent,1.14; manpages/param.xweb,1.16;
+params/variablelist.term.break.after.xml,1.1;
+params/variablelist.term.separator.xml,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+<listitem role="commit-message">
+<para>Convert 'no' to string in default
+value.</para>
+<para role="commit-changes">Modified: params/olink.doctitle.xml,1.4 - Robert
+Stayton</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented RFE
+#1292615.</para>
+<para>Added bunch of new parameters (attribute sets)
+that affect list presentation: list.block.properties,
+<tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
+<tag>itemizedlist</tag>.<tag>label</tag>.properties and
+<tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
+of stylesheets has not been changed but further customizations will be
+much more easier.</para>
+<para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
+fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
+params/itemizedlist.properties.xml,1.1;
+params/list.block.properties.xml,1.1;
+params/orderedlist.label.properties.xml,1.1;
+params/orderedlist.properties.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Implemented RFE
+#1242092.</para>
+<para>You can enable crop marks in your document by
+setting crop.marks=1 and xep.extensions=1. Appearance of crop
+marks can be controlled by parameters
+<parameter>crop.mark.bleed</parameter> (6pt),
+<parameter>crop.mark.offset</parameter> (24pt) and
+<parameter>crop.mark.width</parameter> (0.5pt).</para>
+<para>Also there
+is new named template called user-xep-pis. You can overwrite it in
+order to produce some PIs that can control XEP as described in
+http://www.renderx.com/reference.html#Output_Formats</para>
+<para role="commit-changes">Modified: fo/docbook.xsl,1.36;
+fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
+params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
+params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
+Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Changed short descriptions in doc
+for *autolabel* params to match new autolabel
+behavior.</para>
+<para role="commit-changes">Modified: params/appendix.autolabel.xml,1.5;
+params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5;
+params/preface.autolabel.xml,1.4 - Michael(tm)
+Smith</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Params changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_Profiling">
+<title>Profiling</title>
+<para>The following changes have been made to the
+ <filename>profiling</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Profiling now works together with
+namespace stripping (V5 documents). Namespace striping should work
+with all stylesheets named profile-, even if they are not supporting
+namespace stripping in a non-profiling
+variant.</para>
+<para role="commit-changes">Modified: profiling/profile-mode.xsl,1.4;
+profiling/xsl2profile.xsl,1.7 - Jirka Kosek</para>
+</listitem>
+<listitem role="commit-message">
+<para>Moved profiling stage out of
+templates. This make possible to reuse profiled content by several
+templates and still maintaing node indentity (needed for example for
+HTML Help where content is processed multiple times).</para>
+<para>I
+don't know why this was not on the top level before. Maybe some XSLT
+processors choked on it. I hope this will be OK
+now.</para>
+<para role="commit-changes">Modified: profiling/xsl2profile.xsl,1.5 - Jirka
+Kosek</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Profiling changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_Tools">
+<title>Tools</title>
+<para>The following changes have been made to the
+ <filename>tools</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>Moved Makefile.DocBook from
+<tag>contrib</tag> module to xsl
+module.</para>
+<para role="commit-changes">Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm)
+Smith</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of Tools changes for snapshot_2006-05-15_0803-->
+
+<sect2 xml:id="V1700_WordML">
+<title>WordML</title>
+<para>The following changes have been made to the
+ <filename>wordml</filename> code
+ since the 1.69.1 release.</para>
+<itemizedlist>
+<listitem role="commit-message">
+<para>added <tag>contrib</tag> element,
+better handling of default paragraph
+style</para>
+<para role="commit-changes">Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2;
+wordml/wordml-final.xsl,1.14 - Steve Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>added
+<tag>bridgehead</tag></para>
+<para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.6;
+wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5;
+wordml/template-pages.xml,1.7; wordml/template.dot,1.4;
+wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve
+Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>added blocks stylesheet to support
+bibliographies, glossaries and qandasets</para>
+<para role="commit-changes">Modified: wordml/Makefile,1.4;
+wordml/README,1.3; wordml/blocks-spec.xml,1.1;
+wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
+wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3;
+wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6;
+wordml/template.dot,1.3; wordml/template.xml,1.13;
+wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12;
+wordml/wordml-sections.xsl,1.3 - Steve Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>added <tag>mediaobject</tag>
+<tag>caption</tag></para>
+<para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.4;
+wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12;
+wordml/template-pages.xml,1.5; wordml/template.dot,1.2;
+wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve
+Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>added
+callouts</para>
+<para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14;
+wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11;
+wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve
+Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>added Word template
+file</para>
+<para role="commit-changes">Modified: wordml/template.dot,1.1 - Steve Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>added <tag>abstract</tag>, fixed
+<tag>itemizedlist</tag>, ulink</para>
+<para role="commit-changes">Modified: wordml/specifications.xml,1.10;
+wordml/wordml-final.xsl,1.9 - Steve Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>fixed Makefile added many
+features to Pages support added <tag>revhistory</tag>, inlines,
+highlights, <tag>abstract</tag></para>
+<para role="commit-changes">Modified: wordml/Makefile,1.2;
+wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2;
+wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9;
+wordml/template-pages.xml,1.3; wordml/template.xml,1.11;
+wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve
+Ball</para>
+</listitem>
+<listitem role="commit-message">
+<para>fixed handling linebreaks when
+generating WordML added Apple Pages
+support</para>
+<para role="commit-changes">Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 -
+Steve Ball</para>
+</listitem>
+</itemizedlist>
+</sect2><!--end of WordML changes for snapshot_2006-05-15_0803-->
+</sect1>
+
+ <sect1 xml:id="V1691">
+ <title>Release 1.69.1</title>
+ <para>This release is a minor bug-fix update to the 1.69.0
+ release. Along with bug fixes, it includes one
+ configuration-parameter change: The default value of the
+ <parameter>annotation.support</parameter> parameter is now
+ <literal>0</literal> (off). The reason for that change is that
+ there have been reports that <tag>annotation</tag> handling is
+ causing a significant performance degradation in processing of
+ large documents with <command>xsltproc</command>.</para>
+ </sect1>
+ <!-- end of notes for 1.69.1 release -->
+
+ <sect1 xml:id="V1690">
+ <title>Release 1.69.0</title>
+ <para>The release includes major feature changes,
+ particularly in the <link linkend="V1690_MAN">manpages
+ stylesheets</link>, as well as a large number of bug fixes.</para>
+
+ <para>As with all DocBook Project <quote>dot zero</quote> releases, this is an
+ <link linkend="dot0">experimental release </link>.</para>
+
+ <sect2 xml:id="V1690_COMMON">
+ <title>Common</title>
+ <itemizedlist>
+ <listitem>
+ <para>This release adds localizations for the following
+ languages:
+ <simplelist type="inline">
+ <?dbchoice choice="and"?>
+ <member>Albanian</member>
+ <member>Amharic</member>
+ <member>Azerbaijani</member>
+ <member>Hindi</member>
+ <member>Irish (Gaelic)</member>
+ <member>Gujarati</member>
+ <member>Kannada</member>
+ <member>Mongolian</member>
+ <member>Oriya</member>
+ <member>Punjabi</member>
+ <member>Tagalog</member>
+ <member>Tamil</member>
+ <member>Welsh</member>
+ </simplelist>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for specifying number format for auto
+ labels for <tag>chapter</tag>, <tag>appendix</tag>,
+ <tag>part</tag>, and <tag>preface</tag>. Contolled with the
+ <parameter>appendix.autolabel</parameter>,
+ <parameter>chapter.autolabel</parameter>,
+ <parameter>part.autolabel</parameter>, and
+ <parameter>preface.autolabel</parameter> parameters.</para>
+ </listitem>
+ <listitem>
+ <para>Added basic support for <tag>biblioref</tag> cross
+ referencing.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag class="attribute">align</tag>
+ on <tag>caption</tag> in <tag>mediaobject</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for processing documents that use the
+ DocBook V5 namespace.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag>termdef</tag> and
+ <tag>mathphrase</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>EXPERIMENTAL: Incorporated the Slides and Website
+ stylesheets into the DocBook XSL stylesheets package. So,
+ for example, Website documents can now be processed using
+ the following URI for the driver Website
+ <filename>tabular.xsl</filename> file: <literallayout class="monospaced"><uri>http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</uri></literallayout></para>
+ </listitem>
+ <listitem>
+ <para>A <tag>procedure</tag> without a <tag>title</tag> is
+ now treated as an <quote>informal</quote> procedure (meaning
+ that it is not added to any generated <quote>list of
+ procedures</quote> and has no affect on numbering of
+ generated labels for other procedures).</para>
+ </listitem>
+ <listitem>
+ <para><tag>docname</tag> is no longer added to
+ <tag>olink</tag> when pointing to a root element.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Added support for generation of choice separator in
+ inline simplelist. This enables auto-generation of an
+ appropriate localized <quote>choice separator</quote> (for
+ example, <quote>and</quote> or <quote>or</quote>) before the
+ final item in an inline <tag>simplelist</tag>.</para>
+ <para>To indicate that you want a choice separator
+ generated for a particular list, you need to put a processing
+ instruction (PI) of the form
+ <tag class="xmlpi">dbchoice choice="foo"</tag> as a
+ child of the list. For example:
+ <literallayout class="monospaced"> &lt;para&gt;Choose from
+ ONE and ONLY ONE of the following:
+ &lt;simplelist type="inline"&gt;
+ &lt;?dbchoice choice="or" ?&gt;
+ &lt;member&gt;A&lt;/member&gt;
+ &lt;member&gt;B&lt;/member&gt;
+ &lt;member&gt;C&lt;/member&gt;.&lt;/simplelist&gt;&lt;/para&gt;</literallayout>
+
+ Output (for English):
+ <blockquote>
+ <para>Choose from ONE and only ONE of the
+ following choices: A, B, or C.</para>
+ </blockquote>
+ As a temporary workaround for the fact that most of the
+ DocBook non-English locale files don't have a localization for
+ the word <quote>or</quote>, you can put in a literal string to
+ be used; example for French: <tag class="pi">dbchoice choice="ou"</tag>. That is, use
+ <quote>ou</quote> instead of <quote>or</quote>.</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+ <sect2 xml:id="V1690_FO">
+ <title>FO</title>
+ <itemizedlist>
+ <listitem>
+ <para> Added <literal>content-type</literal> property to
+ <literal>external-graphic</literal> element, based on
+ <tag>imagedata</tag> <tag class="attribute">format</tag>
+ attribute.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for generating
+ <literal>&lt;rx:meta-field creator="$VERSION"/&gt;</literal>
+ field for XEP output. This makes the DocBook XSL
+ stylesheet version information available through the
+ <guimenu>Document Properties</guimenu> menu in Acrobat
+ Reader and other PDF viewers.</para>
+ </listitem>
+ <listitem>
+ <para>Trademark symbol handling made consistent with
+ handling of same in HTML stylesheets. Prior to this change,
+ if you processed a document that contained no value for the
+ <tag class="attribute">class</tag> attribute on the
+ <tag>trademark</tag> element, the HTML stylesheets would
+ default to rendering a superscript <literal>TM
+ </literal>symbol after the <tag>trademark</tag> contents,
+ but the FO stylesheets would render nothing.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for generating XEP bookmarks for
+ <tag>refentry</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for HTML markup <tag>table</tag> <tag class="attribute">border</tag> attribute, applied to each
+ table cell.</para>
+ </listitem>
+ <listitem>
+ <para>The <function>table.width</function> template can now
+ sum column specs if none use <literal>%</literal> or
+ <literal>*</literal>.</para>
+ </listitem>
+ <listitem>
+ <para>Added <literal>fox:destination</literal> extension
+ inside <literal>fox:outline</literal> to support linking to
+ internal destinations.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for customizing
+ <literal>abstract</literal> with property sets. Controlled
+ with the <parameter>abstract.properties</parameter> and
+ <parameter>abstract.title.properties</parameter>
+ parameters.</para>
+ </listitem>
+ <listitem>
+ <para>Add <tag>footnote</tag>s in <tag>table</tag> title to
+ table footnote set, and add support for table footnotes to
+ HTML table markup.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag>title</tag> in
+ <tag>glosslist</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag>itemizedlist</tag> symbol
+ <literal>none</literal>.</para>
+ </listitem>
+ <listitem>
+ <para>Implemented the new
+ <parameter>graphical.admonition.properties</parameter> and
+ <parameter>nongraphical.admonition.properties</parameter>
+ attribute sets.</para>
+ </listitem>
+ <listitem>
+ <para>Added <tag class="attribute">id</tag> to
+ <tag>formalpara</tag> and some other blocks that were
+ missing it.</para>
+ </listitem>
+ <listitem>
+ <para>Changed the anchor template to output
+ <literal>fo:inline</literal> instead of
+ <literal>fo:wrapper</literal>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <parameter>toc.max.depth</parameter>
+ parameter.</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 xml:id="V1690_HELP">
+ <title>Help</title>
+ <itemizedlist>
+ <listitem>
+ <para>Eclipse Help: Added support for generating olink
+ database.</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 xml:id="V1690_HTML">
+ <title>HTML</title>
+ <itemizedlist>
+ <listitem>
+ <para>Added a first cut at support in HTML output for
+ DocBook 5 style <tag>annotation</tag>s. Controlled using the
+ <parameter>annotation.support</parameter> parameter, and
+ implemented using JavaScript and CSS styling. For more
+ details, see the documentation for the
+ <parameter>annotation.js</parameter>,
+ <parameter>annotation.css</parameter>,
+ <parameter>annotation.graphic.open</parameter>, and
+ <parameter>annotation.graphic.close</parameter>
+ parameters.</para>
+ </listitem>
+ <listitem>
+ <para>Generate client-side image map for
+ <tag>imageobjectco</tag> with areas using
+ <literal>calspair</literal> units</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag class="xmlpi">img.src.path</tag> PI.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for passing
+ <parameter>img.src.path</parameter> to DocBook Java XSLT
+ image extensions when appropriate. Controlled using the
+ <parameter>graphicsize.use.img.src.path</parameter>
+ parameter.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for (not
+ valid for DocBook 4) <tag class="attribute">xlink:href</tag>
+ on <tag>area</tag> and (not valid for DocBook 4)
+ <tag>alt</tag> in <tag>area</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added new parameter
+ <parameter>default.table.frame</parameter> to control table
+ framing if there is no <tag class="attribute">frame</tag>
+ attribute on a table.</para>
+ </listitem>
+ <listitem>
+ <para>Added initial, experimental support for generating
+ content for the HTML <literal>title</literal> attribute from
+ content of the <tag>alt</tag> element. This change adds
+ support for the following inline elements only (none of them
+ are block elements):
+ <simplelist type="inline">
+ <?dbchoice choice="and"?>
+ <member><tag>abbrev</tag></member>
+ <member><tag>accel</tag></member>
+ <member><tag>acronym</tag></member>
+ <member><tag>action</tag></member>
+ <member><tag>application</tag></member>
+ <member><tag>authorinitials</tag></member>
+ <member><tag>beginpage</tag></member>
+ <member><tag>citation</tag></member>
+ <member><tag>citerefentry</tag></member>
+ <member><tag>citetitle</tag></member>
+ <member><tag>city</tag></member>
+ <member><tag>classname</tag></member>
+ <member><tag>code</tag></member>
+ <member><tag>command</tag></member>
+ <member><tag>computeroutput</tag></member>
+ <member><tag>constant</tag></member>
+ <member><tag>country</tag></member>
+ <member><tag>database</tag></member>
+ <member><tag>email</tag></member>
+ <member><tag>envar</tag></member>
+ <member><tag>errorcode</tag></member>
+ <member><tag>errorname</tag></member>
+ <member><tag>errortext</tag></member>
+ <member><tag>errortype</tag></member>
+ <member><tag>exceptionname</tag></member>
+ <member><tag>fax</tag></member>
+ <member><tag>filename</tag></member>
+ <member><tag>firstname</tag></member>
+ <member><tag>firstterm</tag></member>
+ <member><tag>foreignphrase</tag></member>
+ <member><tag>function</tag></member>
+ <member><tag>glossterm</tag></member>
+ <member><tag>guibutton</tag></member>
+ <member><tag>guiicon</tag></member>
+ <member><tag>guilabel</tag></member>
+ <member><tag>guimenu</tag></member>
+ <member><tag>guimenuitem</tag></member>
+ <member><tag>guisubmenu</tag></member>
+ <member><tag>hardware</tag></member>
+ <member><tag>honorific</tag></member>
+ <member><tag>interface</tag></member>
+ <member><tag>interfacename</tag></member>
+ <member><tag>keycap</tag></member>
+ <member><tag>keycode</tag></member>
+ <member><tag>keysym</tag></member>
+ <member><tag>lineage</tag></member>
+ <member><tag>lineannotation</tag></member>
+ <member><tag>literal</tag></member>
+ <member><tag>markup</tag></member>
+ <member><tag>medialabel</tag></member>
+ <member><tag>methodname</tag></member>
+ <member><tag>mousebutton</tag></member>
+ <member><tag>option</tag></member>
+ <member><tag>optional</tag></member>
+ <member><tag>otheraddr</tag></member>
+ <member><tag>othername</tag></member>
+ <member><tag>package</tag></member>
+ <member><tag>parameter</tag></member>
+ <member><tag>personname</tag></member>
+ <member><tag>phone</tag></member>
+ <member><tag>pob</tag></member>
+ <member><tag>postcode</tag></member>
+ <member><tag>productname</tag></member>
+ <member><tag>productnumber</tag></member>
+ <member><tag>prompt</tag></member>
+ <member><tag>property</tag></member>
+ <member><tag>quote</tag></member>
+ <member><tag>refentrytitle</tag></member>
+ <member><tag>remark</tag></member>
+ <member><tag>replaceable</tag></member>
+ <member><tag>returnvalue</tag></member>
+ <member><tag>tag</tag></member>
+ <member><tag>shortcut</tag></member>
+ <member><tag>state</tag></member>
+ <member><tag>street</tag></member>
+ <member><tag>structfield</tag></member>
+ <member><tag>structname</tag></member>
+ <member><tag>subscript</tag></member>
+ <member><tag>superscript</tag></member>
+ <member><tag>surname</tag></member>
+ <member><tag>symbol</tag></member>
+ <member><tag>systemitem</tag></member>
+ <member><tag>tag</tag></member>
+ <member><tag>termdef</tag></member>
+ <member><tag>token</tag></member>
+ <member><tag>trademark</tag></member>
+ <member><tag>type</tag></member>
+ <member><tag>uri</tag></member>
+ <member><tag>userinput</tag></member>
+ <member><tag>varname</tag></member>
+ <member><tag>wordasword</tag></member>
+ </simplelist>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Added support for chunking <tag>revhistory</tag> into
+ separate file (similar to the support for doing same with
+ <tag>legalnotice</tag>). Patch from Thomas
+ Schraitle. Controlled through <parameter>new
+ generate.revhistory.link</parameter> parameter.</para>
+ </listitem>
+ <listitem>
+ <para>l10n.xsl: Made language codes RFC compliant. Added a
+ new boolean config parameter,
+ <parameter>l10n.lang.value.rfc.compliant</parameter>. If it
+ is non-zero (the default), any underscore in a language code
+ will be converted to a hyphen in HTML output. If it is zero,
+ the language code will be left as-is.</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+ <sect2 xml:id="V1690_MAN">
+ <title>man</title>
+ <para>This release closes out 44 manpages stylesheet bug reports
+ and feature requests. It adds more than 35 new configuration
+ parameters for controlling aspects of man-page output --
+ including hyphenation and justification, handling of links,
+ conversion of Unicode characters, and contents of man-page
+ headers and footers.</para>
+ <itemizedlist>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>New options for globally disabling/enabling
+ hyphenation and justification:
+ <parameter>man.justify</parameter> and
+ <parameter>man.hyphenate</parameter>.</para>
+ <para>Note that the default
+ for the both of those is zero (off), because justified text
+ looks good only when it is also hyphenated; to quote the
+ <quote>Hyphenation</quote> node from the groff info page:
+ <blockquote>
+ <para><emphasis>Since the odds are not great for finding a
+ set of words, for every output line, which fit nicely on a
+ line without inserting excessive amounts of space between
+ words, `gtroff' hyphenates words so that it can justify
+ lines without inserting too much space between
+ words.</emphasis></para>
+ </blockquote>
+ The problem is that groff can end up hyphenating a lot of
+ things that you don't want hyphenated (variable names and
+ command names, for example). Keeping both justification and
+ hyphenation disabled ensures that hyphens won't get inserted
+ where you don't want to them, and you don't end up with
+ lines containing excessive amounts of space between
+ words. These default settings run counter to how most
+ existing man pages are formatted. But there are some notable
+ exceptions, such as the perl man pages.</para>
+ </listitem>
+ <listitem>
+ <para> Added parameters for controlling hyphenation of
+ computer inlines, filenames, and URLs. By default, even when
+ hyphenation is enabled (globally), hyphenation is now
+ suppressed for "computer inlines" (currently, just
+ <tag>classname</tag>, <tag>constant</tag>, <tag>envar</tag>,
+ <tag>errorcode</tag>, <tag>option</tag>,
+ <tag>replaceable</tag>, <tag>userinput</tag>,
+ <tag>type</tag>, and <tag>varname</tag>, and for
+ <tag>filenames</tag>, and for URLs from <tag>link</tag>. It
+ can be (re)enabled using the
+ <parameter>man.hyphenate.computer.inlines</parameter>,
+ <parameter>man.hyphenate.filenames</parameter>, and
+ <parameter>man.hyphenate.urls parameters</parameter>.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Implemented a new system for replacing Unicode
+ characters. There are two parts to the new system: a
+ <quote>string substitution map</quote> for doing
+ <quote>essential</quote> replacements, and a
+ <quote>character map</quote> that can optionally be disabled
+ and enabled.</para>
+ <para>The new system fixes all open bugs that had to do with
+ literal Unicode numbered entities such as &amp;#8220; and
+ &amp;#8221; showing up in output, and greatly expands the
+ ability of the stylesheets to generate <quote>good</quote> roff
+ equivalents for Unicode symbols and special
+ characters.</para>
+ <para>Here are some details...</para>
+ <para>The previous manpages mechanism for replacing Unicode
+ symbols and special characters with roff equivalents (the
+ <function>replace-entities</function> template) was not
+ scalable and not complete. The mechanism handled a somewhat
+ arbitrary selection of less than 20 or so Unicode
+ characters. But there are potentially more than
+ <emphasis>800</emphasis> Unicode special characters that
+ have some groff equivalent they can be mapped to. And there
+ are about 34 symbols in the Latin-1 (ISO-8859-1) block
+ alone. Users might reasonably expect that if they include
+ any of those Latin-1 characters in their DocBook source
+ documents, they will get correctly converted to known roff
+ equivalents in output.</para>
+ <para>In addition to those common symbols, certain users may
+ have a need to use symbols from other Unicode blocks. Say,
+ somebody who is documenting an application related to math
+ might need to use a bunch of symbols from the
+ <quote>Mathematical Operators</quote> Unicode block (there
+ are about 65 characters in that block that have reasonable
+ roff equivalents). Or somebody else might really like
+ Dingbats -- such as the checkmark character -- and so might
+ use a bunch of things from the <quote>Dingbat</quote> block
+ (141 characters in that that have roff equivalents or that
+ can at least be <quote>degraded</quote> somewhat gracefully
+ into roff).</para>
+ <para>So, the old <function>replace-entities</function>
+ mechanism was replaced with a completely different mechanism
+ that is based on use of two <quote>maps</quote>: a
+ <quote>substitution map</quote> and a <quote>character
+ map</quote> (the latter in a format compliant with the XSLT
+ 2.0 spec and therefore completely <quote>forward
+ compatible</quote> with XSLT 2.0).</para>
+ <para>The substitution map is controlled through the
+ <parameter>man.string.subst.map</parameter> parameter, and
+ is used to replace things like the backslash character
+ (which needs special handling to prevent it from being
+ interpreted as a roff escape). The substitution map cannot
+ be disabled, because disabling it will cause the output to
+ be broken. However, you can add to it and change it if
+ needed.</para>
+
+ <para>The <quote>character map</quote> mechanism, on the
+ other hand, can be completely disabled. It is enabled by
+ default, and, by default, does replacement of all Latin-1
+ symbols, along with most special spaces, dashes, and quotes
+ (about 75 characters by default). Also, you can optionally
+ enable a <quote>full</quote> character map that provides
+ support for converting all 800 or so of the characters that
+ have some reasonable groff equivalent.</para>
+
+ <para>The character-map mechanism is controlled through the
+ following parameters:
+ <variablelist>
+ <varlistentry>
+ <term><parameter>man.charmap.enabled</parameter></term>
+ <listitem><para>turns character-map support
+ on/off</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>man.charmap.use.subset</parameter></term>
+ <listitem><para>specifies that a subset of the character
+ map is used instead of the full map</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>man.charmap.subset.profile</parameter></term>
+ <listitem><para>specifies profile of character-map
+ subset</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>man.charmap.uri</parameter></term>
+ <listitem><para>specifies an alternate character map to
+ use instead of the <quote>standard</quote> character map
+ provided in the distribution</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Implemented out-of-line handling of display of URLs
+ for links (currently, only for <tag>ulink</tag>). This gives
+ you three choices for handling of links:
+ <orderedlist>
+ <listitem>
+ <para>Number and list links. Each link is numbered
+ inline, with a number in square brackets preceding the
+ link contents, and a numbered list of all links is added
+ to the end of the document.</para>
+ </listitem>
+ <listitem>
+ <para>Only list links. Links are not numbered, but an
+ (unnumbered) list of links is added to the end of the
+ document.</para>
+ </listitem>
+ <listitem>
+ <para>Suppress links. Don't number links and don't add
+ any list of links to the end of the document.</para>
+ </listitem>
+ </orderedlist>
+ You can also choose whether links should be underlined. The
+ default is <quote>the works</quote> -- list, number, and
+ underline links. You can use the
+ <parameter>man.links.list.enabled</parameter>, <parameter>
+ man.links.are.numbered</parameter>, and
+ <parameter>man.links.are.underlined</parameter> parameters
+ to change the defaults. The default heading for the link
+ list is REFERENCES. You can be change that using the
+ <parameter>man.links.list.heading</parameter>
+ parameter.</para>
+ </listitem>
+ <listitem>
+ <para>Changed default output encoding to UTF-8. <emphasis role="bold">This does not mean that man pages are output in
+ raw UTF-8</emphasis>, because the character map is applied
+ before final output, causing all UTF-8 characters covered in
+ the map to be converted to roff equivalents.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Added support for processing <tag>refsect3</tag> and
+ <tag>formalpara</tag> and nested <tag>refsection</tag>
+ elements, down to any arbitrary level of nesting.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Output of the <literal>NAME</literal> and
+ <literal>SYNOPSIS</literal> and <literal>AUTHOR</literal>
+ headings and the headings for admonitions (<tag>note</tag>,
+ <tag>caution</tag>, etc.) are no longer hard-coded for
+ English. Instead, headings are generated for those in the
+ correct locale (just as the FO and HTML stylesheets
+ do).</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Re-worked mechanism for assembling page
+ headers/footers (the contents of the <literal>.TH</literal>
+ macro <quote>title line</quote>).</para>
+
+ <para>Here are some details...</para>
+
+ <para>All man pages contain a <literal>.TH</literal> roff
+ macro whose contents are used for rendering the <quote>title
+ line</quote> displayed in the header and footer of each
+ page. Here are a couple of examples of real-world man pages
+ that have useful page headers/footers: <literallayout class="monospaced">
+ gtk-options(7) GTK+ User's Manual gtk-options(7) &lt;-- header
+ GTK+ 1.2 2003-10-20 gtk-options(7) &lt;-- footer
+
+ svgalib(7) Svgalib User Manual svgalib(7) &lt;-- header
+ Svgalib 1.4.1 16 December 1999 svgalib(7) &lt;-- footer</literallayout></para>
+
+ <para>And here are the terms with which the
+ <literal>groff_man(7)</literal> man page refers to the
+ various parts of the header/footer: <literallayout class="monospaced">
+ title(section) extra3 title(section) &lt;- header
+ extra2 extra1 title(section) &lt;- footer</literallayout></para>
+ <para> Or, using the names with which the <literal>man(7)</literal>
+ man page refers to those same fields: <literallayout class="monospaced">
+ title(section) manual title(section) &lt;- page header
+ source date title(section) &lt;- page footer</literallayout></para>
+
+ <para>The easiest way to control the contents of those
+ fields is to mark up your <tag>refentry</tag> content like
+ the following (note that this is a <quote>minimal</quote>
+ example). <programlisting>
+ &lt;refentry&gt;
+ &lt;info&gt;
+ &lt;date&gt;2003-10-20&lt;/date&gt; <co xml:id="V1690_date-co" linkends="V1690_date"/>
+ &lt;/info&gt;
+ &lt;refmeta&gt;
+ &lt;refentrytitle&gt;gtk-options&lt;/refentrytitle&gt; <co xml:id="V1690_title-co" linkends="V1690_title"/>
+ &lt;manvolnum&gt;7&lt;/manvolnum&gt; <co xml:id="V1690_manvolnum-co" linkends="V1690_manvolnum"/>
+ &lt;refmiscinfo class="source-name"&gt;GTK+&lt;/refmiscinfo&gt; <co xml:id="V1690_source-name-co" linkends="V1690_source-name"/>
+ &lt;refmiscinfo class="version"&gt;1.2&lt;/refmiscinfo&gt; <co xml:id="V1690_version-co" linkends="V1690_version"/>
+ &lt;refmiscinfo class="manual"&gt;GTK+ User's Manual&lt;/refmiscinfo&gt; <co xml:id="V1690_manual-co" linkends="V1690_manual"/>
+ &lt;/refmeta&gt;
+ &lt;refnamediv&gt;
+ &lt;refname&gt;gtk-options&lt;/refname&gt;
+ &lt;refpurpose&gt;Standard Command Line Options for GTK+ Programs&lt;/refpurpose&gt;
+ &lt;/refnamediv&gt;
+ &lt;refsect1&gt;
+ &lt;title&gt;Description&lt;/title&gt;
+ &lt;para&gt;This manual page describes the command line options, which
+ are common to all GTK+ based applications.&lt;/para&gt;
+ &lt;/refsect1&gt;
+ &lt;/refentry&gt;</programlisting>
+ <calloutlist>
+ <callout arearefs="V1690_date-co" xml:id="V1690_date">
+ <para>Sets the <quote>date</quote> part of the header/footer.</para>
+ </callout>
+ <callout arearefs="V1690_title-co" xml:id="V1690_title">
+ <para>Sets the <quote>title</quote> part.</para>
+ </callout>
+ <callout arearefs="V1690_manvolnum-co" xml:id="V1690_manvolnum">
+ <para>Sets the <quote>section</quote> part.</para>
+ </callout>
+ <callout arearefs="V1690_source-name-co" xml:id="V1690_source-name">
+ <para>Sets the <quote>source name</quote> part.</para>
+ </callout>
+ <callout arearefs="V1690_version-co" xml:id="V1690_version">
+ <para>Sets the <quote>version</quote> part.</para>
+ </callout>
+ <callout arearefs="V1690_manual-co" xml:id="V1690_manual">
+ <para>Sets the <quote>manual</quote> part.</para>
+ </callout>
+ </calloutlist>
+ </para>
+ <para>Below are explanations of the steps the stylesheets
+ take to attempt to assemble and display
+ <quote>good</quote> headers and footer. [In the
+ descriptions, note that <replaceable>*info</replaceable>
+ is the <tag>refentry</tag> <quote>info</quote> child
+ (whatever its name), and
+ <replaceable>parentinfo</replaceable> is the
+ <quote>info</quote> child of its parent (again, whatever
+ its name).]
+ <variablelist>
+ <varlistentry>
+ <term>extra1 field (date)</term>
+ <listitem>
+ <para>Content of the <quote>extra1</quote> field is
+ what shows up in the <emphasis role="bold">center
+ footer</emphasis> position of each page. The
+ <literal>man(7)</literal> man page describes it as
+ <quote>the date of the last revision</quote>.</para>
+ <para>To provide this content, if the
+ <parameter>refentry.date.profile.enabled</parameter>
+ is non-zero, the stylesheets check the value of
+ <parameter>refentry.date.profile</parameter>.</para>
+ <para>Otherwise, by default, they check for a
+ <tag>date</tag> or <tag>pubdate</tag> not only in the
+ <replaceable>*info</replaceable> contents, but also in
+ the <replaceable>parentinfo</replaceable>
+ contents.</para>
+ <para>If a date cannot be found, the stylesheets now
+ automatically generate a localized <quote>long
+ format</quote> date, ensuring that this field always
+ has content in output.</para>
+ <para>However, if for some reason you want to suppress
+ this field, you can do so by setting a non-zero value
+ for <parameter>man.th.extra1.suppress</parameter>.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>extra2 field (source)</term>
+ <listitem>
+ <para>On Linux systems and on systems with a modern
+ groff, the content of the <quote>extra2</quote> field
+ are what shows up in the <emphasis role="bold">left
+ footer</emphasis> position of each page.</para>
+
+ <para>The <literal>man(7)</literal> man page describes
+ this as <quote>the source of the command</quote>, and
+ provides the following examples:
+ <itemizedlist>
+ <listitem>
+ <para>For binaries, use somwething like: GNU,
+ NET-2, SLS Distribution, MCC Distribution.</para>
+ </listitem>
+ <listitem>
+ <para>For system calls, use the version of the
+ kernel that you are currently looking at: Linux
+ 0.99.11.</para>
+ </listitem>
+ <listitem>
+ <para>For library calls, use the source of the
+ function: GNU, BSD 4.3, Linux DLL 4.4.1.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>In practice, there are many pages that simply
+ have a version number in the <quote>source</quote>
+ field. So, it looks like what we have is a two-part
+ field,
+ <replaceable>Name</replaceable> <replaceable>Version</replaceable>,
+ where:
+ <variablelist>
+ <varlistentry>
+ <term>Name</term>
+ <listitem>
+ <para>product name (e.g., BSD) or org. name
+ (e.g., GNU)</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Version</term>
+ <listitem>
+ <para>version name</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ Each part is optional. If the
+ <replaceable>Name</replaceable> is a product name,
+ then the <replaceable>Version</replaceable> is
+ probably the version of the product. Or there may be
+ no <replaceable>Name</replaceable>, in which case, if
+ there is a <replaceable>Version</replaceable>, it is
+ probably the version of the item itself, not the
+ product it is part of. Or, if the
+ <replaceable>Name</replaceable> is an organization
+ name, then there probably will be no
+ <replaceable>Version</replaceable>.
+ </para>
+ <para>To provide this content, if the
+ <parameter>refentry.source.name.profile.enabled</parameter>
+ and
+ <parameter>refentry.version.profile.enabled</parameter>
+ parameter are non-zero, the stylesheets check the
+ value of <parameter>refentry.source.name.profile</parameter>
+ <parameter>refentry.version.profile</parameter>.</para>
+
+ <para>Otherwise, by default, they check the following
+ places, in the following order:
+ <orderedlist>
+ <listitem>
+ <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag>[@class = 'version']</literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productnumber</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productname</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productname</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
+ </listitem>
+ <listitem>
+ <para>[nothing found, so leave it empty]</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>extra3 field</term>
+ <listitem>
+ <para>On Linux systems and on systems with a modern
+ groff, the content of the <quote>extra3</quote> field
+ are what shows up in the <emphasis role="bold">center
+ header</emphasis> position of each page. Some man
+ pages have <quote>extra2</quote> content, some
+ don't. If a particular man page has it, it is most
+ often <quote>context</quote> data about some larger
+ system the documented item belongs to (for example,
+ the name or description of a group of related
+ applications). The stylesheets now check the following
+ places, in the following order, to look for content to
+ add to the <quote>extra3</quote> field.</para>
+ <orderedlist>
+ <listitem>
+ <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>title</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced">parent's <tag>title</tag></literallayout>
+ </listitem>
+ <listitem>
+ <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
+ </listitem>
+ <listitem>
+ <para>[nothing found, so leave it empty]</para>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Reworked <replaceable>*info</replaceable> gathering. For
+ each <tag>refentry</tag> found, the stylesheets now cache its
+ <replaceable>*info</replaceable> content, then check for any
+ valid parent of it that might have metainfo content and cache
+ that, if found; they then then do all further matches against
+ those node-sets (rather than re-selecting the original
+ <replaceable>*info</replaceable> nodes each time they are
+ needed).</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>New option for breaking strings after forward
+ slashes. This enables long URLs and pathnames to be broken
+ across lines. Controlled through
+ <parameter>man.break.after.slash</parameter> parameter.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Output for servicemark and trademark are now
+ <literal>(SM)</literal> and <literal>(TM)</literal>. There is
+ a groff <literal>"\(tm"</literal> escape, but output from that
+ is not acceptable.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>New option for controlling the length of the title
+ part of the <literal>.TH</literal> title line. Controlled
+ through the <parameter>man.th.title.max.length</parameter>
+ parameter.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>New option for specifying output encoding of each man
+ page; controlled with
+ <parameter>man.output.encoding</parameter> (similar to the
+ HTML <parameter>chunker.output.encoding </parameter>
+ parameter).</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>New option for suppressing filename messages when
+ generating output; controlled with
+ <parameter>man.output.quietly</parameter> (similar to the HTML
+ <parameter>chunk.quietly</parameter> parameter).</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>The text of cross-references to first-level
+ <tag>refentry</tag> (<tag>refsect1</tag>, top-level
+ <tag>refsection</tag>, <tag>refnamediv</tag>, and
+ <tag>refsynopsisdiv</tag>) are now capitalized.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Cross-references to <tag>refnamediv</tag> now use the
+ localized <literal>NAME</literal> title instead of using the
+ first <tag>refname</tag> child. This makes the output
+ inconsistent with HTML and FO output, but for man-page output,
+ it seems to make better sense to have the
+ <literal>NAME</literal>. (It may actually make better sense to
+ do it that way in HTML and FO output as well...)</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Added support for processing <tag>funcparams</tag>.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Removed the space that was being output between
+ <tag>funcdef</tag> and <tag>paramdef</tag>; example: was:
+ <literal>float rand (void)</literal>; now:
+ <literal>float rand(void)</literal></para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Turned off bold formatting for the <tag>type</tag>
+ element when it occurs within a <tag>funcdef</tag> or
+ <tag>paramdef</tag></para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Corrected rendering of <tag>simplelist</tag>. Any
+ <literal>&lt;simplelist type="inline"</literal> instance
+ is now rendered as a comma-separated list (also with an
+ optional localized <quote>and</quote> or <quote>or</quote> before the last item -- see
+ description elsewhere in these release notes). Any simplelist
+ instance whose <tag class="attribute">type</tag> is not
+ <literal>inline</literal> is rendered as a one-column vertical
+ list (ignoring the values of the <tag class="attribute">type</tag> and <tag class="attribute">columns</tag> attributes if present)</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Comment added at top of roff source for each page now
+ includes DocBook XSL stylesheets version number (as in the
+ HTML stylesheets)</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Made change to prevent <quote>sticky</quote> fonts
+ changes. Now, when the manpages stylesheets encounter node
+ sets that need to be boldfaced or italicized, they put the
+ <literal>\fBfoo\fR</literal> and <literal>\fIbar\fR</literal>
+ groff bold/italic instructions separately around each node in
+ the set.</para>
+ </listitem>
+ <listitem>
+ <para>synop.xsl: Boldface everything in
+ <tag>funcsynopsis</tag> output except parameters (which are in
+ ital). The <literal>man(7)</literal> man page says:
+ <blockquote>
+ <para>For functions, the arguments are always specified
+ using italics, even in the SYNOPSIS section, where the rest
+ of the function is specified in bold.</para>
+ </blockquote>
+ A look through the contents of the
+ <filename>man/man2</filename> directory shows that most
+ (all) existing pages do follow this <quote>everything in
+ funcsynopsis bold</quote> rule. That means the
+ <tag>type</tag> content and any punctuation (parens,
+ semicolons, <tag>vararg</tag>s) also must be bolded.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Removed code for adding backslashes before periods/dots
+ in roff source, because backslashes in front of periods/dots
+ in roff source are needed only in the very rare case where a
+ period is the very first character in a line, without any
+ space in front of it. A better way to deal with that rare case
+ is for you to add a zero-width space in front of the offending
+ dot(s) in your source</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Removed special handling of the <tag>quote</tag>
+ element. That was hard-coded to cause anything marked up with
+ the <tag>quote</tag> element to be output preceded by two
+ backticks and followed by two apostrophes -- that is, that
+ old-school kludge for generating <quote>curly</quote> quotes in Emacs and
+ in X-Windows fonts. While Emacs still seems to support that, I
+ don't think X-Windows has for a long time now. And, anyway, it
+ looks (and has always looked) like crap when viewed on a
+ normal tty/console. In addition, it breaks localiztion of
+ <tag>quote</tag>. By default, <tag>quote</tag> content is
+ output with localized quotation marks, which, depending on the
+ locale, may or may not be left and right double quotation
+ marks.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Changed mappings for left and right single quotation
+ marks. Those had previously been incorrectly mapped to the
+ backtick (&amp;#96;) and apostrophe (&amp;39;) characters (for
+ kludgy reasons -- see above). They are now correctly mapped to
+ the <literal>\(oq</literal> and <literal>\(cq</literal> roff
+ escapes. If you want the old (broken) behavior, you need to
+ manually change the mappings for those in the value of the
+ <parameter>man.string.subst.map</parameter> parameter.</para>
+ </listitem>
+ <listitem>
+ <para>Removed <filename>xref.xsl</filename> file. Now, of the
+ various cross-reference elements, only the <tag>ulink</tag>
+ element is handled differently; the rest are handled exactly
+ as the HTML stylesheets handle them, except that no hypertext
+ links are generated. (Because there is no equivalent hypertext
+ mechanism is man pages.)</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>New option for making <quote>subheading dividers</quote> in generated
+ roff source. The dividers are not visible in the rendered man
+ page; they are just there to make the source
+ readable. Controlled using
+ <parameter>man.subheading.divider</parameter>.</para>
+ </listitem>
+ <!-- ======================================================= -->
+ <listitem>
+ <para>Fixed many places where too much space was being added
+ between lines.</para>
+ </listitem>
+ </itemizedlist>
+ <!-- end of MAN changes for 1.69.0 release -->
+ </sect2>
+</sect1>
+ <!-- end of notes for 1.69.0 release -->
+
+ <sect1 xml:id="V1681">
+ <title>Release 1.68.1</title>
+ <para>The release adds localization support for Farsi (thanks to
+ Sina Heshmati) and improved support for the XLink-based DocBook NG
+ <tag>db:link</tag> element. Other than that, it is a minor
+ bug-fix update to the 1.68.0 release. The main thing it fixes is a
+ build error that caused the XSLT Java extensions to be jarred up
+ with the wrong package structure. Thanks to Jens Stavnstrup for
+ quickly reporting the problem, and to Mauritz Jeanson for
+ investigating and finding the cause.</para>
+ </sect1>
+ <!-- end of notes for 1.68.1 release -->
+
+ <sect1 xml:id="V1680">
+ <title>Release 1.68.0</title>
+ <para>This release includes some features changes, particularly
+ for FO/PDF output, and a number of bug fixes.
+ <itemizedlist xml:id="V1680_FO">
+ <title>FO</title>
+ <listitem>
+ <para>Moved footnote properties to attribute-sets.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for side floats, margin notes, and
+ custom floats.</para>
+ </listitem>
+ <listitem>
+ <para>Added new parameters
+ <parameter>body.start.indent</parameter> and
+ <parameter>body.end.indent</parameter> to the
+ <parameter>set.flow.properties template</parameter>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag class="attribute">xml:id</tag></para>
+ </listitem>
+ <listitem>
+ <para>Added support for
+ <tag>refdescriptor</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for multiple <tag>refnamediv</tag>s.</para>
+ </listitem>
+ <listitem>
+ <para>Added <parameter>index.entry.properties</parameter>
+ attribute-set to support customization of index
+ entries.</para>
+ </listitem>
+ <listitem>
+ <para>Added <parameter>set.flow.properties
+ template</parameter> call to each <tag>fo:flow</tag>
+ to support customizations entry point.</para>
+ </listitem>
+ <listitem>
+ <para>Add support for <literal>@floatstyle</literal> in
+ <tag>figure</tag></para>
+ </listitem>
+ <listitem>
+ <para>Moved hardcoded properties for index division titles
+ to the <parameter>index.div.title.properties</parameter>
+ attribute-set.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for
+ <tag>table-layout</tag>="<tag class="attvalue">auto</tag>" for XEP.</para>
+ </listitem>
+ <listitem>
+ <para>Added <parameter>index.div.title.properties</parameter>
+ attribute-set.</para>
+ </listitem>
+ <listitem>
+ <para><parameter>$verbose</parameter> parameter is now
+ passed to most elements.</para>
+ </listitem>
+ <listitem>
+ <para>Added <tag>refentry</tag> to
+ <tag>toc</tag> in <tag>part</tag>, as it is
+ permitted by the DocBook schema/DTD.</para>
+ </listitem>
+ <listitem>
+ <para>Added backmatter elements and
+ <tag>article</tag> to <tag>toc</tag> in
+ <tag>part</tag>, since they are permitted by the
+ DocBook schema/DTD.</para>
+ </listitem>
+ <listitem>
+ <para>Added <tag class="attribute">mode</tag>="<tag class="attvalue">toc</tag>" for
+ <tag>simplesect</tag>, since it is now permitted in
+ the <tag>toc</tag> if
+ <parameter>simplesect.in.toc</parameter> is set.</para>
+ </listitem>
+ <listitem>
+ <para>Moved hard-coded properties to
+ <parameter>nongraphical.admonintion.properties</parameter>
+ and <parameter>graphical.admonition.properties</parameter>
+ attribute sets.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <literal>sidebar-width</literal> and
+ <literal>float-type</literal> processing instructions in
+ <tag>sidebar</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>For tables with HTML markup elements, added support
+ for <literal>dbfo bgcolor</literal> PI, the attribute-sets
+ named <parameter>table.properties</parameter>,
+ <parameter>informaltable.properties</parameter>,
+ <parameter>table.table.properties</parameter>, and
+ <parameter>table.cell.padding</parameter>. Also added
+ support for the templates named
+ <parameter>table.cell.properties</parameter> and
+ <parameter>table.cell.block.properties</parameter> so that
+ tabstyles can be implemented. Also added support for tables
+ containing only <tag>tr</tag> instead of
+ <tag>tbody</tag> with <tag>tr</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added new paramater
+ <parameter>hyphenate.verbatim.characters</parameter> which
+ can specify characters after which a line break can occur in
+ verbatim environments. This parameter can be used to extend
+ the initial set of characters which contain only space and
+ non-breakable space.</para>
+ </listitem>
+ <listitem>
+ <para>Added <parameter>itemizedlist.label.markup</parameter> to enable
+ selection of different bullet symbol. Also added several
+ potential bullet characters, commented out by default.</para>
+ </listitem>
+ <listitem>
+ <para>Enabled all id's in XEP output for external olinking.</para>
+ </listitem>
+ </itemizedlist>
+
+ <itemizedlist xml:id="V1680_HTML">
+ <title>HTML</title>
+ <listitem>
+ <para>Added support for
+ <tag>refdescriptor</tag>.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for multiple <tag>refnamediv</tag>s.</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <tag class="attribute">xml:id</tag></para>
+ </listitem>
+ <listitem>
+ <para><tag>refsynopsisdiv</tag> as a section for
+ counting section levels</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist xml:id="V1680_images">
+ <title>Images</title>
+ <listitem>
+ <para>Added new SVG admonition graphics and navigation images.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </sect1>
+ <!-- end of notes for 1.68.0 release -->
+
+ <sect1 xml:id="V1672">
+ <title>Release 1.67.2</title>
+ <para>This release fixes a table bug introduced in the 1.67.1
+ release.</para>
+ </sect1>
+ <sect1 xml:id="V1671">
+ <title>Release 1.67.1</title>
+ <para>This release includes a number of bug fixes.</para>
+ <para>The following lists provide details about API and feature changes.
+ <itemizedlist xml:id="V1671_FO">
+ <title>FO</title>
+ <listitem>
+ <para>Tables: Inherited cell properties are now passed to the
+ <literal>table.cell.properties</literal> template so they can
+ be overridden by a customization.</para>
+ </listitem>
+ <listitem>
+ <para>Tables: Added support for bgcolor PI on table row
+ element.</para>
+ </listitem>
+ <listitem>
+ <para>TOCs: Added new parameter
+ <parameter>simplesect.in.toc</parameter>; default value of
+ <literal>0</literal> causes simplesect to be omitted from TOCs; to
+ cause <tag>simplesect</tag> to be included in TOCs, you
+ must set the value of <parameter>simplesect.in.toc</parameter> to
+ <literal>1</literal>.Comment from Norm:
+
+ <blockquote>
+ <para><emphasis>Simplesect elements aren't supposed to
+ appear in the ToC at all... The use case for simplesect
+ is when, for example, every chapter in a book ends with
+ "Exercises" or "For More Information" sections and you
+ don't want those to appear in the ToC.</emphasis></para>
+ </blockquote>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Sections: Reverted change that caused a variable reference
+ to be used in a template match and rewrote code to preserve
+ intended semantics.</para>
+ </listitem>
+ <listitem>
+ <para>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
+ list output from PassiveTeX</para>
+ </listitem>
+ <listitem>
+ <para>Moved the literal attributes from
+ <parameter>component.title</parameter> to the
+ <parameter>component.title.properties</parameter> attribute-set so
+ they can be customized.</para>
+ </listitem>
+ <listitem>
+ <para>Lists: Added <tag>glossdef</tag>'s first
+ <tag>para</tag> to special handling in
+ <literal>fo:list-item-body</literal>.</para>
+ </listitem>
+ </itemizedlist>
+
+ <itemizedlist xml:id="V1671_HTML">
+ <title>HTML</title>
+ <listitem>
+ <para>TOCs: Added new parameter
+ <parameter>simplesect.in.toc</parameter>; for details, see
+ the list of <xref linkend="V1671_FO"/> changes for this
+ release.</para>
+ </listitem>
+ <listitem>
+ <para>Indexing: Added new parameter
+ <parameter>index.prefer.titleabbrev</parameter>; when set to
+ <literal>1</literal>, index references will use
+ <tag>titleabbrev</tag> instead of
+ <tag>title</tag> when available.</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist xml:id="V1671_HELP">
+ <title>HTML Help</title>
+ <listitem>
+ <para>Added support for generating windows-1252-encoded
+ output using Saxon; for more details, see the list of <xref linkend="V1671_EXT"/> changes for this release.</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist xml:id="V1671_MAN">
+ <title>man pages</title>
+ <listitem>
+ <para>Replaced named/numeric character-entity references for
+ non-breaking space with groff equivalent (backslash-tilde).</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist xml:id="V1671_EXT">
+ <title>XSL Java extensions</title>
+ <listitem>
+ <para>Saxon extensions: Added the
+ <classname>Windows1252</classname> class. It extends Saxon
+ 6.5.x with the windows-1252 character set, which is
+ particularly useful when generating HTML Help for Western
+ European Languages (code from
+ <personname><firstname>Pontus</firstname>
+ <surname>Haglund</surname></personname> and contributed to the
+ DocBook community by Sectra AB, Sweden).</para>
+ <para>To use:
+ <orderedlist>
+ <listitem>
+ <para>Make sure that the Saxon 6.5.x jar file and the jar file for
+ the DocBook XSL Java extensions are in your <envar>CLASSPATH</envar></para>
+ </listitem>
+ <listitem>
+ <para>Create a DocBook XSL customization layer -- a file named
+ <filename>mystylesheet.xsl</filename> or whatever -- that, at a
+ minimum, contains the following:
+ <screen> &lt;xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ version='1.0'&gt;
+ &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/&gt;
+ &lt;xsl:output method="html" encoding="WINDOWS-1252" indent="no"/&gt;
+ &lt;xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
+ &lt;xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
+ &lt;xsl:param name="saxon.character.representation" select="'native'"&gt;&lt;/xsl:param&gt;
+ &lt;/xsl:stylesheet&gt;</screen>
+ </para>
+ <para>Invoke Saxon with the
+ <literal>encoding.windows-1252</literal> Java system property set
+ to <literal>com.nwalsh.saxon.Windows1252</literal>; for example
+ <screen> java \
+ -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
+ com.icl.saxon.StyleSheet \
+ mydoc.xml mystylesheet.xsl</screen>
+
+ Or, for a more complete "real world" case showing other
+ options you'll typically want to use:
+ <screen> java \
+ -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
+ -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
+ -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
+ -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
+ com.icl.saxon.StyleSheet \
+ -x org.apache.xml.resolver.tools.ResolvingXMLReader \
+ -y org.apache.xml.resolver.tools.ResolvingXMLReader \
+ -r org.apache.xml.resolver.tools.CatalogResolver \
+ mydoc.xml mystylesheet.xsl</screen>
+
+ In both cases, the "mystylesheet.xsl" file should be a
+ DocBook customization layer containing the parameters
+ show in step 2.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Saxon extensions: Removed Saxon 8 extensions from release package</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </sect1>
+<sect1 xml:id="V1670">
+ <title>Release 1.67.0</title>
+ <itemizedlist>
+ <listitem>
+ <para>A number of important bug fixes.</para>
+ </listitem>
+ <listitem>
+ <para>Added Saxon8 extensions</para>
+ </listitem>
+ <listitem>
+ <para>Enabled <literal>dbfo table-width</literal> on
+ <tag>entrytbl</tag> in FO output</para>
+ </listitem>
+ <listitem>
+ <para>Added support for <literal>role=strong</literal> on
+ <tag>emphasis</tag> in FO output</para>
+ </listitem>
+ <listitem>
+ <para>Added new FO parameter
+ <parameter>hyphenate.verbatim</parameter> that can be used to turn
+ on "intelligent" wrapping of verbatim environments.</para>
+ </listitem>
+ <listitem>
+ <para>Replaced all <literal>&lt;tt&gt;&lt;/tt&gt;</literal> output with
+ <literal>&lt;code&gt;&lt;/code&gt;</literal></para>
+ </listitem>
+ <listitem>
+ <para>Changed <literal>admon.graphic.width</literal> template to a
+ mode so that different admonitions can have different graphical
+ widths.</para>
+ </listitem>
+ <listitem>
+ <para>Deprecated the HTML <parameter>shade.verbatim</parameter>
+ parameter (use CSS instead)</para>
+ </listitem>
+ <listitem>
+ <para>Wrapped ToC
+ <tag>refentrytitle</tag>/<tag>refname</tag> and
+ <tag>refpurpose</tag> in span with class values. This
+ makes it possible to style them using a CSS stylesheet.</para>
+ </listitem>
+ <listitem>
+ <para>Use <literal>strong/em</literal> instead of
+ <literal>b/i</literal> in HTML output</para>
+ </listitem>
+ <listitem>
+ <para>Added support for converting <tag>Emphasis</tag> to
+ groff italic and <tag>Emphasis role='bold'</tag> to
+ bold. Controlled by
+ <parameter>emphasis.propagates.style</parameter> param, but not
+ documented yet using litprog system. Will do that next (planning
+ to add some other parameter-controllable options for hyphenation
+ and handling of line spacing).</para>
+ </listitem>
+ <listitem>
+ <para><parameter>callout.graphics.number.limit.xml</parameter>
+ param: Changed the default from <literal>10</literal> to
+ <literal>15</literal>.</para>
+ </listitem>
+ <listitem>
+ <para><parameter>verbatim.properties</parameter>: Added
+ <literal>hyphenate=false</literal></para>
+ </listitem>
+ <listitem>
+ <para>Saxon and Xalan Text.java extensions: Added support for
+ <methodname>URIResolver()</methodname> on insertfile href's</para>
+ </listitem>
+ <listitem>
+ <para>Added generated <filename>RELEASE-NOTES.txt</filename>
+ file.</para>
+ </listitem>
+ <listitem>
+ <para>Added <filename>INSTALL</filename> file (executable file for
+ generating catalog.xml)</para>
+ </listitem>
+ <listitem>
+ <para>Removed obsolete <filename>tools</filename> directory from
+ package</para>
+ </listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1661">
+<title>Release 1.66.1</title>
+ <itemizedlist>
+<listitem>
+<para>A number of important bug fixes.
+</para>
+</listitem>
+<listitem>
+<para>
+Now <literal>xml:base</literal> attributes that are generated by an
+XInclude processor are resolved for image files.
+</para>
+</listitem>
+<listitem>
+<para>
+Rewrote olink templates to support several new features.
+</para>
+<itemizedlist>
+<listitem>
+<para>
+Extended full olink support to FO output.
+</para>
+</listitem>
+<listitem>
+<para>
+Add support for <literal>xrefstyle</literal> attribute in olinks.
+</para>
+</listitem>
+<listitem>
+<para>
+New parameters to support new olink features:
+<parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
+<parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
+<parameter>prefer.internal.olink</parameter>.
+See the reference page for each parameter for more
+information.</para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<para>
+Added <parameter>index.on.type</parameter> parameter for new <tag class="attribute">type</tag>
+attribute introduced in DocBook 4.3 for indexterms and index.
+This allows you to create multiple indices containing
+different categories of entries.
+For users of 4.2 and earlier, you can use the new parameter <parameter>index.on.role</parameter>
+instead.
+</para>
+</listitem>
+<listitem>
+<para>
+Added new
+<parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
+below a certain depth.
+This permits you to number major section levels and leave minor
+section levels unnumbered.</para>
+</listitem>
+<listitem>
+<para>
+Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
+the line separating footnotes in printed output.
+</para>
+</listitem>
+<listitem>
+<para>
+Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
+attributes.
+The prefix is added to whatever path is already generated by the
+stylesheet for each image file.</para>
+</listitem>
+<listitem>
+<para>
+Added new attribute-sets
+<parameter>informalequation.properties</parameter>,
+<parameter>informalexample.properties</parameter>,
+<parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
+so each such element type can be formatted
+individually if needed.
+</para>
+</listitem>
+<listitem>
+<para>
+Add <parameter>component.label.includes.part.label</parameter>
+parameter to add any part number to chapter, appendix
+and other component labels when
+the <parameter>label.from.part</parameter> parameter is nonzero.
+This permits you to distinguish multiple chapters with the same
+chapter number in cross references and the TOC.</para>
+</listitem>
+<listitem>
+<para>
+Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
+This parameter lets you generate separate chunk files for each LOT
+(list of tables, list of figures, etc.).</para>
+</listitem>
+<listitem>
+<para>Added several table features:</para>
+<itemizedlist>
+<listitem>
+<para>
+Added <parameter>table.table.properties</parameter> attribute set to add
+properties to the fo:table element.
+</para>
+</listitem>
+<listitem>
+<para>
+Added placeholder templates named <literal>table.cell.properties</literal>
+and <literal>table.cell.block.properties</literal> to enable adding properties
+to any <tag>fo:table-cell</tag> or the cell's <tag>fo:block</tag>, respectively.
+ These templates are a start for implementing table styles.</para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<para>
+Added new attribute
+set <parameter>component.title.properties</parameter> for easy modifications of
+component's title formatting in FO output.
+</para>
+</listitem>
+<listitem>
+<para>
+Added Saxon support for an <tag class="attribute">encoding</tag> attribute on the <tag class="element">textdata</tag> element. Added new parameter
+<parameter>textdata.default.encoding</parameter> which specifies encoding when
+<tag class="attribute">encoding</tag> attribute on
+<tag class="element">textdata</tag> is missing.
+</para>
+</listitem>
+<listitem>
+<para>
+Template <literal>label.this.section</literal> now controls whole
+section label, not only sub-label which corresponds to
+particular label. Former behaviour was IMHO bug as it was
+not usable.
+</para>
+</listitem>
+<listitem>
+<para>
+Formatting in titleabbrev for TOC and headers
+is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup.
+</para>
+</listitem>
+<listitem>
+<para>
+Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
+property</literal> for page sequences in print output.
+Customizing this template lets you change when page numbering restarts. This is similar to the <literal>format.page.number</literal> template that lets you change how the page number formatting changes in the output.
+</para>
+</listitem>
+<listitem>
+<para>
+Added <literal>force.page.count</literal> template to set the force-page-count
+property for page sequences in print output.
+This is similar to the <literal>format.page.number</literal> template.
+</para>
+</listitem>
+<listitem>
+<para>
+Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document
+lang, not from system environment.
+</para>
+</listitem>
+<listitem>
+<para>
+Numbering and formatting of normal
+and ulink footnotes (if turned on) has been unified.
+Now ulink footnotes are mixed in with any other footnotes.</para>
+</listitem>
+<listitem>
+<para>
+Added support for <tag>renderas</tag> attribute in section and
+sect1 et al.
+This permits you to render a given section title as if it were a different level.</para>
+</listitem>
+<listitem>
+<para>
+Added support for <tag>label</tag> attribute in footnote to manually
+supply the footnote mark.
+</para>
+</listitem>
+<listitem>
+<para>
+Added support for DocBook 4.3 <tag>corpcredit</tag> element.
+</para>
+</listitem>
+<listitem>
+<para>
+Added support for a <literal>dbfo keep-together</literal> PI for
+formal objects (table, figure, example, equation, programlisting). That permits a formal object to be kept together if it is not already, or to be broken if it
+is very long and the
+default keep-together is not appropriate.
+</para>
+</listitem>
+<listitem>
+<para>
+For graphics files, made file extension matching case
+insensitive, and updated the list of graphics extensions.
+</para>
+</listitem>
+<listitem>
+<para>
+Allow <tag>calloutlist</tag> to have block content before
+the first callout
+</para>
+</listitem>
+<listitem>
+<para>
+Added <literal>dbfo-need</literal> processing instruction to provide
+soft page breaks.
+</para>
+</listitem>
+<listitem>
+<para>
+Added implementation of existing but unused
+<parameter>default.image.width</parameter> parameter for graphics.
+</para>
+</listitem>
+<listitem>
+<para>
+Support DocBook NG <tag>tag</tag> inline element.
+</para>
+</listitem>
+<listitem>
+<para>
+It appears that XEP now supports Unicode characters in
+bookmarks. There is no further need to strip accents from
+characters.
+</para>
+</listitem>
+<listitem>
+<para>
+Make <tag>segmentedlist</tag> HTML markup
+more semantic and available to CSS styles.
+</para>
+</listitem>
+<listitem>
+<para>
+Added <literal>user.preroot</literal> placeholder template to
+permit xsl-stylesheet and other PIs and comments to be
+output before the HTML root element.
+</para>
+</listitem>
+<listitem>
+<para>
+Non-chunked legalnotice now gets an &lt;a
+name="id"&gt; element in HTML output
+so it can be referenced with xref or link.
+</para>
+</listitem>
+<listitem>
+<para>
+In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
+and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
+spec.
+</para>
+</listitem>
+<listitem>
+<para>
+Added several patches to htmlhelp from W. Borgert
+</para>
+</listitem>
+<listitem>
+<para>
+Added Bosnian locale file as common/bs.xml.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1650">
+<title>Release 1.65.0</title>
+<itemizedlist>
+<listitem>
+<para>A number of important bug fixes.
+</para>
+</listitem>
+<listitem>
+<para>Added a workaround to allow these stylesheets to process DocBook NG
+documents. (It’s a hack that pre-processes the document to strip off the
+namespace and then uses <function>exsl:node-set</function> to process
+the result.)
+</para>
+</listitem>
+<listitem>
+<para>Added alternative indexing mechanism which has better
+internationalization support. New indexing method allows grouping of
+accented letters like e, é, ë into the same group under letter "e". It
+can also treat special letters (e.g. "ch") as one character and place
+them in the correct position (e.g. between "h" and "i" in Czech
+language).</para>
+<para>In order to use this mechanism you must create customization
+layer which imports some base stylesheet (like
+<filename>fo/docbook.xsl</filename>,
+<filename>html/chunk.xsl</filename>) and then includes appropriate
+stylesheet with new indexing code
+(<filename>fo/autoidx-ng.xsl</filename> or
+<filename>html/autoidx-ng.xsl</filename>). For example:</para>
+<programlisting>&lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ version="1.0"&gt;
+
+&lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/&gt;
+&lt;xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/&gt;
+
+&lt;/xsl:stylesheet&gt;</programlisting>
+<para>New method is known to work with Saxon and it should also work
+with xsltproc 1.1.1 and later. Currently supported languages are
+English, Czech, German, French, Spanish and Danish.</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1641">
+<title>Release 1.64.1</title>
+<itemizedlist>
+<para>General bug fixes and improvements. Sorry about the failure to produce
+an updated release notes file for 1.62.0—1.63.2</para>
+<listitem>
+<para>In the course of fixing bug #849787, wrapping Unicode callouts
+with an appropriate font change in the Xalan extensions, I discovered
+that the Xalan APIs have changed a bit. So <filename>xalan2.jar</filename>
+will work with older Xalan 2 implementations, <filename>xalan25.jar</filename>
+works with Xalan 2.5.</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1610">
+<title>Release 1.61.0</title>
+<itemizedlist>
+<para>Lots of bug fixes and improvements.</para>
+<listitem>
+<para>Initial support for timestamp PI. From now you
+ can use &lt;?dbtimestamp format="Y-m-d H:M:S"?&gt; to get current
+ datetime in your document. Added localization support for datetime PI
+</para>
+</listitem>
+<listitem>
+<para>Added level 6 to test for <tag>section</tag> depth in
+section.level template so that
+section.title.level6.properties will be used for sections
+that are 6 deep or deeper. This should also cause a h6 to be
+created in html output.
+</para>
+</listitem>
+<listitem>
+<para>Don't use SVG graphics if <parameter>use.svg</parameter>=0
+</para>
+</listitem>
+<listitem>
+<para>Now uses number-and-title-template for sections
+ only if <parameter>section.autolabel</parameter> is not zero.
+</para>
+</listitem>
+<listitem>
+<para>Added missing 'english-language-name' attribute to
+the l10n element, and the missing 'style' attribute to the
+template element so the current gentext documents will
+validate.
+</para>
+</listitem>
+<listitem>
+<para>Corrected several references to parameter
+ <parameter>qanda.defaultlabel</parameter> that were missing the "$".
+</para>
+</listitem>
+<listitem>
+<para>Now accepts <parameter>admon.textlabel</parameter> parameter to turn off
+ Note, Warning, etc. label.
+</para>
+</listitem>
+<listitem>
+<para>FeatReq #684561: support more XEP metadata
+</para>
+</listitem>
+<listitem>
+<para>Added hyphenation support. Added support for <tag>coref</tag>.
+Added <tag>beginpage</tag> support. (does nothing; see TDG).
+</para>
+</listitem>
+<listitem>
+<para>Added support for
+hyphenation-character, hyphenation-push-character-count, and
+hyphenation-remain-character-count
+</para>
+</listitem>
+<listitem>
+<para>Added <parameter>root.properties</parameter>,
+<parameter>ebnf.assignment</parameter>,
+and <parameter>ebnf.statement.terminator</parameter>
+</para>
+</listitem>
+<listitem>
+<para>Support bgcolor PI in table cells; make sure
+rowsep and colsep don't have any effect on the last row or
+column
+</para>
+</listitem>
+<listitem>
+<para>Handle <tag>othercredit</tag> on titlepage a little
+better
+</para>
+</listitem>
+<listitem>
+<para>Applied fix from Jeff Beal that fixed the bug
+that put secondary page numbers on primary entries. Same
+with tertiary page numbers on secondary entries.
+</para>
+</listitem>
+<listitem>
+<para>Added definition of missing variable
+<parameter>collection</parameter>.
+</para>
+</listitem>
+<listitem>
+<para>Make <tag>footnote</tag> formatting 'normal' even when it
+occurs in a context that has special formatting
+</para>
+</listitem>
+<listitem>
+<para>Added warning when <parameter>glossary.collection</parameter> is not
+blank, but it cannot open the specified file.
+</para>
+</listitem>
+<listitem>
+<para>Pick up the frame attribute on <tag>table</tag> and
+<tag>informaltable</tag>.
+</para>
+</listitem>
+<listitem>
+<para><tag>indexdiv</tag>/<tag>title</tag>
+in non-autogenerated indexes are
+now picked up.
+</para>
+</listitem>
+<listitem>
+<para>Removed (unused)
+component.title.properties
+</para>
+</listitem>
+<listitem>
+<para>Move IDs from
+page-sequences down to titlepage blocks
+</para>
+</listitem>
+<listitem>
+<para>Use
+proportional-column-width(1) on more <tag>table</tag>s.
+</para>
+<para>Use proportional-column-width() for
+header/footer tables; suppress relative-align when when
+using FOP
+</para>
+</listitem>
+<listitem>
+<para>Check for <parameter>glossterm.auto.link</parameter> when linking
+firstterms; don't output gl. prefix on glossterm links
+</para>
+</listitem>
+<listitem>
+<para>Generate Part ToCs
+</para>
+</listitem>
+<listitem>
+<para>Support <tag>glossary</tag>, <tag>bibliography</tag>,
+and <tag>index</tag> in component ToCs.
+</para>
+</listitem>
+<listitem>
+<para>Refactored chunking code so that
+customization of chunk algorithm and chunk elements is more
+practical
+</para>
+</listitem>
+<listitem>
+<para>Support <tag>textobject</tag>/<tag>phrase</tag>
+on <tag>inlinemediaobject</tag>.
+</para>
+</listitem>
+<listitem>
+<para>Support 'start' PI on ordered lists
+</para>
+</listitem>
+<listitem>
+<para>Fixed test of $toc PI to turn on qandaset TOC.
+</para>
+</listitem>
+<listitem>
+<para>Added process.chunk.footnotes to sect2 through
+5 to fix bug of missing footnotes when chunk level greater
+than 1.
+</para>
+</listitem>
+<listitem>
+<para>Added
+paramater <parameter>toc.max.depth</parameter> which controls maximal depth of ToC
+as requested by PHP-DOC group.
+</para>
+</listitem>
+<listitem>
+<para>Exempted <tag>titleabbrev</tag> from preamble processing in
+lists, and fixed variablelist preamble code to use the same
+syntax as the other lists.
+</para>
+</listitem>
+<listitem>
+<para>Added support for elements between variablelist
+and first varlistentry since DocBook 4.2 supports that now.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1601">
+<title>Release 1.60.1</title>
+<itemizedlist>
+<para>Lots of bug fixes.</para>
+<listitem>
+<para>The format of the <filename>titlepage.templates.xml</filename> files and
+the stylesheet that transforms them have been significantly changed. All of the
+attributes used to control the templates are now namespace qualified. So what
+used to be:</para>
+<programlisting>&lt;t:titlepage element="article" wrapper="fo:block"&gt;</programlisting>
+<para>is now:</para>
+<programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"&gt;</programlisting>
+<para>Attributes from other namespaces (including those that are unqualified) are
+now copied directly through. In practice, this means that the names that used
+to be <quote>fo:</quote> qualified:</para>
+<programlisting>&lt;title named-template="component.title"
+ param:node="ancestor-or-self::article[1]"
+ fo:text-align="center"
+ fo:keep-with-next="always"
+ fo:font-size="&amp;hsize5;"
+ fo:font-weight="bold"
+ fo:font-family="{$title.font.family}"/&gt;</programlisting>
+<para>are now unqualified:</para>
+<programlisting>&lt;title t:named-template="component.title"
+ param:node="ancestor-or-self::article[1]"
+ text-align="center"
+ keep-with-next="always"
+ font-size="&amp;hsize5;"
+ font-weight="bold"
+ font-family="{$title.font.family}"/&gt;</programlisting>
+<para>The <tag>t:titlepage</tag> and <tag>t:titlepage-content</tag>
+elements both generate wrappers now. And unqualified attributes on those elements
+are passed through. This means that you can now make the title font apply to
+ane entire titlepage and make the entire <quote>recto</quote>
+titlepage centered by specifying the font and alignment on the those elements:</para>
+<programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"
+ font-family="{$title.font.family}"&gt;
+
+ &lt;t:titlepage-content t:side="recto"
+ text-align="center"&gt;</programlisting>
+
+
+
+
+
+</listitem>
+<listitem>
+<para>Support use of <tag>titleabbrev</tag> in running
+headers and footers.
+</para>
+</listitem>
+<listitem>
+<para>Added (experimental) <parameter>xref.with.number.and.title</parameter>
+parameter to enable number/title cross references even when the
+default would
+be just the number.
+</para>
+</listitem>
+<listitem>
+<para>Generate <tag>part</tag> ToCs if they're requested.
+</para>
+</listitem>
+<listitem>
+<para>Use proportional-column-width() in header/footer tables.
+</para>
+</listitem>
+<listitem>
+<para>Handle alignment correctly when <tag>screenshot</tag>
+wraps a graphic in a <tag>figure</tag>.
+</para>
+</listitem>
+<listitem>
+<para>Format <tag>chapter</tag> and <tag>appendix</tag>
+cross references consistently.
+</para>
+</listitem>
+<listitem>
+<para>Attempt to support tables with multiple <tag>tgroup</tag>s
+in FO.
+</para>
+</listitem>
+<listitem>
+<para>Output <tag>fo:table-columns</tag> in
+<tag>simplelist</tag> tables.
+</para>
+</listitem>
+<listitem>
+<para>Use <filename>titlepage.templates.xml</filename> for
+<tag>indexdiv</tag> and <tag>glossdiv</tag> formatting.
+</para>
+</listitem>
+<listitem>
+<para>Improve support for new bibliography elements.
+</para>
+</listitem>
+<listitem>
+<para>Added
+<parameter>footnote.number.format</parameter>,
+<parameter>table.footnote.number.format</parameter>,
+<parameter>footnote.number.symbols</parameter>, and
+<parameter>table.footnote.number.symbols</parameter> for better control of
+footnote markers.
+</para>
+</listitem>
+<listitem>
+<para>Added <tag>glossentry.show.acronyms</tag>.
+</para>
+</listitem>
+<listitem>
+<para>Suppress the draft-mode page masters when
+<parameter>draft-mode</parameter> is <quote>no</quote>.
+</para>
+</listitem>
+<listitem>
+<para>Make blank pages verso not recto. D'Oh!
+</para>
+</listitem>
+<listitem>
+<para>Improved formatting of <tag>ulink</tag> footnotes.
+</para>
+</listitem>
+<listitem>
+<para>Fixed bugs in graphic width/height calculations.
+</para>
+</listitem>
+<listitem>
+<para>Added class attributes to inline elements.
+</para>
+</listitem>
+<listitem>
+<para>Don't add <quote>.html</quote> to the filenames identified
+with the <quote>dbhtml</quote> PI.
+</para>
+</listitem>
+<listitem>
+<para>Don't force a ToC when sections contain <tag>refentry</tag>s.
+</para>
+</listitem>
+<listitem>
+<para>Make section title sizes a function of the
+<parameter>body.master.size</parameter>.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1592">
+<title>Release 1.59.2</title>
+<itemizedlist>
+<para>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
+</para>
+<listitem>
+<para>Removed the region-name from the region-body of blank pages. There's
+no reason to give the body of blank pages a unique name and doing so causes
+a mismatch that FOP detects.
+</para>
+</listitem>
+<listitem>
+<para>Output IDs for the first paragraphs in listitems.
+</para>
+</listitem>
+<listitem>
+<para>Fixed some small bugs in the handling of page numbers in double-sided mode.
+</para>
+</listitem>
+<listitem>
+<para>Attempt to prevent duplicated IDs from being produced when
+<tag class="attribute">endterm</tag> on <tag>xref</tag> points
+to something with nested structure.
+</para>
+</listitem>
+<listitem>
+<para>Fix aligment problems in <tag>equation</tag>s.
+</para>
+</listitem>
+<listitem>
+<para>Output the type attribute on unordered lists (UL) in HTML only if
+the css.decoration parameter is true.
+</para>
+</listitem>
+<listitem>
+<para>Calculate the font size in formal.title.properties so that it's 1.2 times
+the base font size, not a fixed "12pt".
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1591">
+<title>Release 1.59.1</title>
+<itemizedlist>
+<para>The 1.59.1 fixes a few bugs.
+</para>
+<listitem>
+<para>Added Bulgarian localization.
+</para>
+</listitem>
+<listitem>
+<para>Indexing improvements; localize book indexes to books but allow setindex
+to index an entire set.
+</para>
+</listitem>
+<listitem>
+<para>The default value for rowsep and colsep is now "1" as per CALS.
+</para>
+</listitem>
+<listitem>
+<para>Added support for <tag>titleabbrev</tag> (use them for cross
+references).
+</para>
+</listitem>
+<listitem>
+<para>Improvements to <tag>mediaobject</tag> for selecting print vs. online
+images.
+</para>
+</listitem>
+<listitem>
+<para>Added seperate property sets for <tag>figure</tag>s,
+<tag>example</tag>s, <tag>equation</tag>s, <tag>tables</tag>s,
+and <tag>procedure</tag>s.
+</para>
+</listitem>
+<listitem>
+<para>Make <tag>lineannotation</tag>s italic.
+</para>
+</listitem>
+<listitem>
+<para>Support <tag class="attribute">xrefstyle</tag> attribute.
+</para>
+</listitem>
+<listitem>
+<para>Make <tag class="attribute">endterm</tag> on
+<tag>xref</tag> higher priority than
+<tag class="attribute">xreflabel</tag> target.
+</para>
+</listitem>
+<listitem>
+<para>Glossary formatting improvements.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1580">
+<title>Release 1.58.0</title>
+<itemizedlist>
+<para>The 1.58.0 adds some initial support for extensions in xsltproc, adds
+a few features, and fixes bugs.
+</para>
+<listitem>
+<para>This release contains the first attempt at extension support for xsltproc.
+The only extension available to date is the one that adjusts table column widths.
+Run <filename>extensions/xsltproc/python/xslt.py</filename>.
+</para>
+</listitem>
+<listitem>
+<para>Fixed bugs in calculation of adjusted column widths to correct for rounding
+errors.
+</para>
+</listitem>
+<listitem>
+<para>Support nested <tag>refsection</tag> elements correctly.
+</para>
+</listitem>
+<listitem>
+<para>Reworked <literal>gentext.template</literal> to take context into consideration.
+The name of elements in localization files is now an xpath-like context list, not
+just a simple name.
+</para>
+</listitem>
+<listitem>
+<para>Made some improvements to bibliography formatting.
+</para>
+</listitem>
+<listitem>
+<para>Improved graphical formatting of admonitions.
+</para>
+</listitem>
+<listitem>
+<para>Added support for <tag>entrytbl</tag>.
+</para>
+</listitem>
+<listitem>
+<para>Support spanning index terms.
+</para>
+</listitem>
+<listitem>
+<para>Support <tag>bibliosource</tag>.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1570">
+<title>Release 1.57.0</title>
+<itemizedlist>
+<listitem>
+<para>The 1.57.0 release wasn't documented here. Oops.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="V1560">
+<title>Release 1.56.0</title>
+<itemizedlist>
+<para>The 1.56.0 release fixes bugs.
+</para>
+<listitem>
+<para>Reworked chunking. <emphasis>This will break all existing customizations
+layers that change the chunking algorithm.</emphasis> If you're customizing chunking,
+look at the new <quote>content</quote> parameter that's passed to
+<literal>process-chunk-element</literal> and friends.
+</para>
+</listitem>
+<listitem>
+<para>Support continued and inherited numeration in <tag>orderedlist</tag>
+formatting for FOs.
+</para>
+</listitem>
+<listitem>
+<para>Added Thai localization.
+</para>
+</listitem>
+<listitem>
+<para>Tweaked stylesheet documentation stylesheets to link to TDG and
+the parameter references.
+</para>
+</listitem>
+<listitem>
+<para>Allow title on tables of contents ("Table of Contents") to be optional.
+Added new keyword to <parameter>generate.toc</parameter>.
+Support tables of contents on sections.
+</para>
+</listitem>
+<listitem>
+<para>Made separate parameters for table borders and table cell borders:
+<parameter>table.frame.border.color</parameter>,
+<parameter>table.frame.border.style</parameter>,
+<parameter>table.frame.border.thickness</parameter>,
+<parameter>table.cell.border.color</parameter>,
+<parameter>table.cell.border.style</parameter>, and
+<parameter>table.cell.border.thickness</parameter>.
+</para>
+</listitem>
+<listitem>
+<para>Suppress formatting of <quote>endofrange</quote> <tag>indexterm</tag>s.
+This is only half-right. They should generate a range, but I haven't figured out how
+to do that yet.
+</para>
+</listitem>
+<listitem>
+<para>Support <tag>revdescription</tag>. (Bug #582192)
+</para>
+</listitem>
+<listitem>
+<para>Added <parameter>default.float.class</parameter> and fixed figure
+floats. (Bug #497603)
+</para>
+</listitem>
+<listitem>
+<para>Fixed formatting of <tag>sbr</tag> in FOs.
+</para>
+</listitem>
+<listitem>
+<para>Added context to the <quote>missing template</quote> error message.
+</para>
+</listitem>
+<listitem>
+<para>Process <tag>arg</tag> correctly in a <tag>group</tag>.
+(Bug #605150)
+</para>
+</listitem>
+<listitem>
+<para>Removed 'keep-with-next' from <parameter>formal.title.properties</parameter>
+attribute set now that the stylesheets support the option of putting
+such titles below the object. Now the $placement value determines if
+'keep-with-next' or 'keep-with-previous' is used in the title block.
+</para>
+</listitem>
+<listitem>
+<para>Wrap <quote>url()</quote> around external-destinations when appropriate.
+</para>
+</listitem>
+<listitem>
+<para>Fixed typo in compact list spacing. (Bug #615464)
+</para>
+</listitem>
+<listitem>
+<para>Removed spurious hash in anchor name. (Bug #617717)
+</para>
+</listitem>
+<listitem>
+<para>Address is now displayed verbatim on title pages. (Bug #618600)
+</para>
+</listitem>
+<listitem>
+<para>The <parameter>bridgehead.in.toc</parameter> parameter is now properly
+supported.
+</para>
+</listitem>
+<listitem>
+<para>Improved effectiveness of HTML cleanup by increasing the number
+of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
+</para>
+</listitem>
+<listitem>
+<para>Support table of contents for <tag>appendix</tag> in
+<tag>article</tag>. (Bug #596599)
+</para>
+</listitem>
+<listitem>
+<para>Don't duplicate footnotes in <tag>bibliography</tag>s and
+<tag>glossary</tag>s. (Bug #583282)
+</para>
+</listitem>
+<listitem>
+<para>Added <parameter>default.image.width</parameter>. (Bug #516859)
+</para>
+</listitem>
+<listitem>
+<para>Totally reworked <tag>funcsynopsis</tag> code; it now
+supports a 'tabular' presentation style for 'wide' prototypes; see
+<parameter>funcsynopsis.tabular.threshold</parameter>. (HTML only
+right now, I think, FO support, uh, real soon now.)
+</para>
+</listitem>
+<listitem>
+<para>Reworked support for difference marking; toned down the colors a bit
+and added a <quote>system.head.content</quote> template so that the diff CSS
+wasn't overriding <quote>user.head.content</quote>. (Bug #610660)
+</para>
+</listitem>
+<listitem>
+<para>Added call to the <quote>*.head.content</quote> elements when writing
+out long description chunks.
+</para>
+</listitem>
+<listitem>
+<para>Make sure <tag>legalnotice</tag> link is correct even when
+chunking to a different <parameter>base.dir</parameter>.
+</para>
+</listitem>
+<listitem>
+<para>Use CSS to set viewport characteristics if
+<parameter>css.decoration</parameter> is non-zero, use div instead of p for making
+graphic a block element; make figure <tag>title</tag>s the
+default alt
+text for images in a <tag>figure</tag>.</para>
+</listitem>
+<listitem>
+<para>Added space-after to <parameter>list.block.spacing</parameter>.
+</para>
+</listitem>
+<listitem>
+<para>Reworked section.level template to give <quote>correct</quote> answer
+instead of being off by one.
+</para>
+</listitem>
+<listitem>
+<para>When processing tables, use the <tag class="attribute">tabstyle</tag>
+attribute as the division class.
+</para>
+</listitem>
+<listitem>
+<para>Fixed bug in <filename>html2xhtml.xsl</filename> that was causing the
+XHTML chunker to output HTML instead of XHTML.
+</para>
+</listitem>
+</itemizedlist>
+</sect1>
+<sect1 xml:id="VOlder">
+ <title>Older releases</title>
+ <para>To view the release notes for older releases, see <uri xlink:href="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml">http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml</uri>. Be
+ aware that there were no release notes for releases prior to the
+ 1.50.0 release.</para>
+</sect1>
+<sect1 xml:id="dot0">
+ <title>About dot-zero releases</title>
+ <para>DocBook Project “dot zero” releases should be
+ considered <emphasis>experimental</emphasis> and are always
+ followed by stable “dot one plus” releases, usually within
+ two or three weeks. Please help to ensure the stability of
+ “dot one plus” releases by carefully testing each
+ “dot zero” release and reporting back about any
+ problems you find. </para>
+ <para>It is not recommended that you use a “dot zero”
+ release in a production system. Instead, you should wait for
+ the “dot one” or greater versions.</para>
+ </sect1>
+</article>