Swiftdiff options
Diffstat (limited to '3rdParty/DocBook/XSL/RELEASE-NOTES.xml')
| -rw-r--r-- | 3rdParty/DocBook/XSL/RELEASE-NOTES.xml | 9240 |
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> -> OPF dc:<tag>subject</tag> mapping and tests</para> +<para>Added DocBook <tag>date</tag> -> OPF dc:date mapping and tests</para> +<para>Added DocBook <tag>abstract</tag> -> 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> <<tag>year</tag>> 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 <p> inside <p> 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> -> 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> -> 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> -> 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 <p> inside <p> 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 <a>s added inside <<tag>blockquote</tag>>; This potentially causes another problem (where something is referenced by has no <tag>anchor</tag>, but someone reporting that should cause the whole <a id='thing'/> 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&T troff that the page needs to be +pre-processed through tbl(1); groff can <tag>figure</tag> it out +automatically, but apparently AT&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 <<tag>cover</tag>> 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 <h1> in each HTML file in rendered ePub files +for <<tag>book</tag>>s +- should include one and only one <h1> in each HTML file in rendered ePub files +for <<tag>book</tag>>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 & 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&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&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 > 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 & 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 <link> 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 <link> in no.anchor.mode mode with the same template as <xref>. +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 <title>. Previously, having inline elements with @id/@xml:id in <title>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 -> 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 <?dbfo pgwide="1"?> 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 [&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: + <paramdef>void *<parameter>dataptr</parameter>[]</paramdef> +... 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&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: + <paramdef>void *<parameter>dataptr</parameter>[]</paramdef> +... 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 <?dbhtml stop-chunking?> 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 <?dbhtml stop-chunking?> 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 [&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 +<link href"..."> 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 <literal> for +inline monospace (not <command> or <code> 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: + + <xsl:param name="man.base.url.for.relative.links" + >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param></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 "\ \&" (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 "\&" 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 "\&." (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&R funcprototype output. It no longer relies +on the HTML kr-tabular templates, but instead just does direct +transformation to roff. For K&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&R output into manpages +stylesheet. The choice between K&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&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 <em> 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 <book>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 <xsl:with-param name="quiet" select="$chunk.quietly"/> 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 <xsl:with-param name="quiet" select="$chunk.quietly"/> +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 <xsl:with-param name="quiet" select="$chunk.quietly"/> 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 <xsl:with-param name="quiet" select="$chunk.quietly"/> 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: + + <xsl:param name="man.base.url.for.relative.links" + >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param></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&R funcprototype output. It no longer relies +on the HTML kr-tabular templates, but instead just does direct +transformation to roff. For K&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&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&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 <a> 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 <xsl:call-template name="process.footnotes"/> 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 <xsl:apply-templates +mode="chunk-filename" select="."/> did not work for single-page output since +the template with that mode is in chunk-code.xsl.</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> & + <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 <xsl:when> 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-<generatedID>" 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 <p> 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 <p> 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 <p> 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 <a> 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> & <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. <<tag>title</tag>> Foo</<tag>title</tag>>) 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 ١.</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 "<xsl:text>&#x0a;</xsl:text>", 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 "<xsl:text>&#x0a;</xsl:text>", 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 <xsl:template +match="/"> 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&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> <<tag>link</tag> rel="<tag>copyright</tag>" +href="ln-id2524073.html" title="Legal Notice"></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 <div +class="{$class}-contents"> wrapper around output of contents +of all formal objects. Also, added an optional <br +class="{class}-break"/> 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> <div +class="<tag>equation</tag>"> <a name="three" +id="three"></a></para> +<para> <p +class="<tag>title</tag>"><b>(1.3)</b></p></para> +<para> +<div class="equation-contents"> <span +class="<tag>mathphrase</tag>">1+1=3</span> +</div> </div><br +class="equation-break"></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> <<tag>link</tag> rel="<tag>copyright</tag>" +href="ln-id2524073.html" title="Legal Notice"></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 +..>0</..)</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"> <para>Choose from + ONE and ONLY ONE of the following: + <simplelist type="inline"> + <?dbchoice choice="or" ?> + <member>A</member> + <member>B</member> + <member>C</member>.</simplelist></para></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><rx:meta-field creator="$VERSION"/></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 &#8220; and + &#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) <-- header + GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer + + svgalib(7) Svgalib User Manual svgalib(7) <-- header + Svgalib 1.4.1 16 December 1999 svgalib(7) <-- 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) <- header + extra2 extra1 title(section) <- 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) <- page header + source date title(section) <- 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> + <refentry> + <info> + <date>2003-10-20</date> <co xml:id="V1690_date-co" linkends="V1690_date"/> + </info> + <refmeta> + <refentrytitle>gtk-options</refentrytitle> <co xml:id="V1690_title-co" linkends="V1690_title"/> + <manvolnum>7</manvolnum> <co xml:id="V1690_manvolnum-co" linkends="V1690_manvolnum"/> + <refmiscinfo class="source-name">GTK+</refmiscinfo> <co xml:id="V1690_source-name-co" linkends="V1690_source-name"/> + <refmiscinfo class="version">1.2</refmiscinfo> <co xml:id="V1690_version-co" linkends="V1690_version"/> + <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> <co xml:id="V1690_manual-co" linkends="V1690_manual"/> + </refmeta> + <refnamediv> + <refname>gtk-options</refname> + <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>This manual page describes the command line options, which + are common to all GTK+ based applications.</para> + </refsect1> + </refentry></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><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 (&#96;) and apostrophe (&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> <xsl:stylesheet + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> + <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/> + <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param> + <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param> + <xsl:param name="saxon.character.representation" select="'native'"></xsl:param> + </xsl:stylesheet></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><tt></tt></literal> output with + <literal><code></code></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 <a +name="id"> 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><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> +<xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/> + +</xsl:stylesheet></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 <?dbtimestamp format="Y-m-d H:M:S"?> 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><t:titlepage element="article" wrapper="fo:block"></programlisting> +<para>is now:</para> +<programlisting><t:titlepage t:element="article" t:wrapper="fo:block"></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><title named-template="component.title" + param:node="ancestor-or-self::article[1]" + fo:text-align="center" + fo:keep-with-next="always" + fo:font-size="&hsize5;" + fo:font-weight="bold" + fo:font-family="{$title.font.family}"/></programlisting> +<para>are now unqualified:</para> +<programlisting><title t:named-template="component.title" + param:node="ancestor-or-self::article[1]" + text-align="center" + keep-with-next="always" + font-size="&hsize5;" + font-weight="bold" + font-family="{$title.font.family}"/></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><t:titlepage t:element="article" t:wrapper="fo:block" + font-family="{$title.font.family}"> + + <t:titlepage-content t:side="recto" + text-align="center"></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> |