diff options
Diffstat (limited to 'docbook-xsl-1.75.2/RELEASE-NOTES.xml')
-rw-r--r-- | docbook-xsl-1.75.2/RELEASE-NOTES.xml | 9379 |
1 files changed, 0 insertions, 9379 deletions
diff --git a/docbook-xsl-1.75.2/RELEASE-NOTES.xml b/docbook-xsl-1.75.2/RELEASE-NOTES.xml deleted file mode 100644 index 55dfb12..0000000 --- a/docbook-xsl-1.75.2/RELEASE-NOTES.xml +++ /dev/null @@ -1,9379 +0,0 @@ -<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: 8504 $ $Date: 2009-07-21 07:22:11 -0700 (Tue, 21 Jul 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.2"> -<title>Release Notes: 1.75.2</title> -<para>The following is a list of changes that have been made - since the 1.75.1 release.</para> - -<sect2 xml:id="rn_V1.75.2_Gentext"> -<title>Gentext</title> -<para>The following changes have been made to the - <filename>gentext</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>dleidert: locale/ja.xml</literal></para><screen><phrase role="commit-message">Improved Japanese translation for Note(s). Closes bug #2823965.</phrase></screen> -</listitem> -<listitem> -<para><literal>dleidert: locale/pl.xml</literal></para><screen><phrase role="commit-message">Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.</phrase></screen> -</listitem> -<listitem> -<para><literal>Robert Stayton: locale/ja.xml</literal></para><screen><phrase role="commit-message">Fix translation of "<tag>index</tag>", per bug report 2796064.</phrase></screen> -</listitem> -<listitem> -<para><literal>Robert Stayton: locale/is.xml</literal></para><screen><phrase role="commit-message">New Icelandic locale file.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of Gentext changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_Common"> -<title>Common</title> -<para>The following changes have been made to the - <filename>common</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Norman Walsh: stripns.xsl</literal></para><screen><phrase role="commit-message">Support more downconvert cases</phrase></screen> -</listitem> -<listitem> -<para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Make sure <tag>title</tag> inside <tag>info</tag> is used if no other <tag>title</tag>.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of Common changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_FO"> -<title>FO</title> -<para>The following changes have been made to the - <filename>fo</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Robert Stayton: pi.xsl</literal></para><screen><phrase role="commit-message">Turn off dbfo-need for <parameter>fop1.extensions</parameter> also, per bug #2816141.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of FO changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_HTML"> -<title>HTML</title> -<para>The following changes have been made to the - <filename>html</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Output "<tag>Copyright</tag>" heading in XHTML too.</phrase></screen> -</listitem> -<listitem> -<para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added stylesheet.result.type test for <tag>copyright</tag>. Closes bug #2813289.</phrase></screen> -</listitem> -<listitem> -<para><literal>Norman Walsh: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Remove ambiguity wrt @span, @rowspan, and @colspan</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of HTML changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_Manpages"> -<title>Manpages</title> -<para>The following changes have been made to the - <filename>manpages</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Mauritz Jeanson: endnotes.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() for ulink content. Closes bug #2793877.</phrase></screen> -</listitem> -<listitem> -<para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added stylesheet.result.type test for <tag>copyright</tag>. Closes bug #2813289.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of Manpages changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_Epub"> -<title>Epub</title> -<para>The following changes have been made to the - <filename>epub</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb</literal></para><screen><phrase role="commit-message">Corrected bugs caused by path and file assumptions were not met</phrase></screen> -</listitem> -<listitem> -<para><literal>Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of Epub changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_Profiling"> -<title>Profiling</title> -<para>The following changes have been made to the - <filename>profiling</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Robert Stayton: profile.xsl</literal></para><screen><phrase role="commit-message">Fix bug 2815493 missing <parameter>exsl.node.set.available</parameter> parameter.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of Profiling changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_XSL-Saxon"> -<title>XSL-Saxon</title> -<para>The following changes have been made to the - <filename>xsl-saxon</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/nwalsh/saxon/Colum⋯</literal></para><screen><phrase role="commit-message">Added fixes so that colgroups in the XHTML namespace are processed properly.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of XSL-Saxon changes for 1.75.2--> - -<sect2 xml:id="rn_V1.75.2_XSL-Xalan"> -<title>XSL-Xalan</title> -<para>The following changes have been made to the - <filename>xsl-xalan</filename> code - since the 1.75.1 release.</para> -<itemizedlist> -<listitem> -<para><literal>Mauritz Jeanson: nbproject/project.xml</literal></para><screen><phrase role="commit-message">Added missing NetBeans configuration.</phrase></screen> -</listitem> -</itemizedlist> -</sect2><!--end of XSL-Xalan changes for 1.75.2--> - -</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> |