10328 lines
513 KiB
XML
10328 lines
513 KiB
XML
|
<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: 8934 $ $Date: 2010-11-01 13:03:14 -0700 (Mon, 01 Nov 2010) $</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="V1.76.1">
|
|||
|
|
<title>Release Notes: 1.76.1</title>
|
|||
|
|
<para>The following is a list of changes that have been made
|
|||
|
|
since the 1.76.0 release.</para>
|
|||
|
|
|
|||
|
|
<sect2 xml:id="rnV1.76.1_FO">
|
|||
|
|
<title>FO</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>fo</filename> code
|
|||
|
|
since the 1.76.0 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para><literal>Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl</literal></para><screen><phrase role="commit-message">Apply patch to support named destination in fop1.xsl, per Sourceforge
|
|||
|
|
bug report #3029845.</phrase></screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2><!--end of FO changes for 1.76.1-->
|
|||
|
|
|
|||
|
|
<sect2 xml:id="rnV1.76.1_HTML">
|
|||
|
|
<title>HTML</title>
|
|||
|
|
<para>The following changes have been made to the <filename>html</filename> code since the 1.76.0 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para><literal>Keith Fahlgren: highlight.xsl</literal></para><screen><phrase role="commit-message">Implementing handling for <b> and <i>: transform to <strong> and <em> for XHTML outputs and do not use in the highliting output (per Mauritz Jeanson)</phrase></screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2><!--end of HTML changes for 1.76.1-->
|
|||
|
|
|
|||
|
|
<sect2 xml:id="rnV1.76.1_Params">
|
|||
|
|
<title>Params</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>params</filename> code
|
|||
|
|
since the 1.76.0 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para><literal>Robert Stayton: draft.mode.xml</literal></para><screen><phrase role="commit-message">Change default for <parameter>draft.mode</parameter> to 'no'.</phrase></screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2><!--end of Params changes for 1.76.1-->
|
|||
|
|
|
|||
|
|
|
|||
|
|
</sect1>
|
|||
|
|
<sect1 xml:id="V1.76.0">
|
|||
|
|
<title>Release Notes: 1.76.0</title>
|
|||
|
|
<para>This release includes important bug fixes and adds the following
|
|||
|
|
significant feature changes:</para>
|
|||
|
|
<variablelist>
|
|||
|
|
<varlistentry>
|
|||
|
|
<term>Webhelp</term>
|
|||
|
|
<listitem><para>A new browser-based, cross-platform help format with full-text search and other features typically found in help systems. See <filename>webhelp/docs/content/ch01.html</filename> for more information and a demo. </para></listitem>
|
|||
|
|
|
|||
|
|
</varlistentry>
|
|||
|
|
|
|||
|
|
<varlistentry>
|
|||
|
|
<term>Gentext</term>
|
|||
|
|
<listitem><para>Many updates and additions to translation/locales thanks to Red Hat, the Fedora Project, and other contributors.</para></listitem>
|
|||
|
|
</varlistentry>
|
|||
|
|
<varlistentry>
|
|||
|
|
<term>Common</term>
|
|||
|
|
<listitem><para>Faster localization support, as language files are loaded on demand.</para></listitem>
|
|||
|
|
|
|||
|
|
</varlistentry>
|
|||
|
|
<varlistentry>
|
|||
|
|
<term>FO</term>
|
|||
|
|
<listitem><para>Support for SVG content in <tag>imagedata</tag> added.</para></listitem>
|
|||
|
|
</varlistentry>
|
|||
|
|
<varlistentry>
|
|||
|
|
<term>HTML</term>
|
|||
|
|
<listitem><para>Output improved when using '<parameter>make.clean.html</parameter>' and a stock CSS file is now provided.</para></listitem>
|
|||
|
|
</varlistentry>
|
|||
|
|
<varlistentry>
|
|||
|
|
<term>EPUB</term>
|
|||
|
|
<listitem><para>A number of improvements to NCX, cover and image selection, and XHTML 1.1 element choices</para></listitem>
|
|||
|
|
</varlistentry>
|
|||
|
|
|
|||
|
|
</variablelist>
|
|||
|
|
|
|||
|
|
<para>The following is a list of changes that have been made since the 1.75.2 release.</para>
|
|||
|
|
<sect2 xml:id="rnV1.76.0_Gentext">
|
|||
|
|
<title>Gentext</title>
|
|||
|
|
<para>The following changes have been made to the <filename>gentext</filename> code since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/fa.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Update to Persian translation from the Fedora Project</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/nds.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Locale for Low German</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: locale/ka.xml; Makefile</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added support for Georgian based on patch #2917147.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/nl.xml; locale/ja.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Updated locales from Red Hat and the Fedora Project</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml; locale/nl.xml; loca⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml; locale/te.xml; ⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">New translations from Red Hat and the Fedora Project</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml; locale/ru.xml; loca⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of Gentext changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_Common">
|
|||
|
|
<title>Common</title>
|
|||
|
|
<para>The following changes have been made to the <filename>common</filename> code since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: common.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: gentext.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added fix to catch ID also of descendants of <tag>listitem</tag>. Closes bug #2955077.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: l10n.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Stripped down, faster version of gentext.template is used when there is no localization customization.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: stripns.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added fix that preserves <tag>link</tag>/@role (makes links in the <tag>reference</tag> documentation
|
|||
|
|
with @role="tcg" work).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: l10n.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fixed bugs related to manpages and L10n.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: entities.ent; autoidx-kosek.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Refactored localization support. Language files are loaded on demand. Speedup is about 30%.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: l10n.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: titles.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fixed bug #2912677 (error with <tag>xref</tag> in <tag>title</tag>).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: olink.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug in xrefstyle "<tag>title</tag>" handling introduced with
|
|||
|
|
the 'insert.targetdb.data' template.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: gentext.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug in <tag>xref</tag> to <tag>equation</tag> without <tag>title</tag> to use context="xref-number" instead
|
|||
|
|
of "xref-number-and-title".</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: labels.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Number all equations in one sequence, with or without <tag>title</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: entities.ent</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug #2896909 where duplicate @sortas on indexterms caused
|
|||
|
|
some indexterms to drop out of <tag>index</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: stripns.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Expand the "Stripping namespace ..." message to advise users to
|
|||
|
|
use the namespaced stylesheets.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: stripns.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">need a local version of $exsl.node.set.available variable because
|
|||
|
|
this module imported many places.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: olink.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added /node() to the select expression that is used to compute the <tag>title</tag> text
|
|||
|
|
so that no <ttl> elements end up in the output. Closes bug #2830119.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of Common changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_FO">
|
|||
|
|
<title>FO</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>fo</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: table.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: inline.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
|
|||
|
|
with many inline glossterms.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: titlepage.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2805530 <tag>author</tag>/<tag>orgname</tag> not appearing on <tag>title</tag> page.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: graphics.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added support for SVG content in <tag>imagedata</tag> (inspired by patch #2909154).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: table.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Removed superfluous test used when computing column-width. Closes bug #3000898.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: inline.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added missing <xsl:call-template name="<tag>anchor</tag>"/>. Closes bug #2998567.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: lists.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added table-layout="fixed" on <tag>segmentedlist</tag> <tag>table</tag> (required by XSL spec when proportional-column-width() is used).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: autoidx-kosek.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: index.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: xref.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug in <tag>olink</tag> template when an <tag>olink</tag> has an id.
|
|||
|
|
Add warning message with id value when trying to <tag>link</tag>
|
|||
|
|
to an element that has no generated text.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: refentry.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fixed bug #2930968 (<tag>indexterm</tag> in <tag>refmeta</tag> not handled correctly).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: block.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">fix bug 2949567 <tag>title</tag> in <tag>revhistory</tag> breaks FO transform.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: glossary.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Output id attributes on <tag>glossdiv</tag> blocks so they can be added to
|
|||
|
|
xrefs or <tag>TOC</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: xref.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Enabled hyphenation of URLs when ulink content is the same as <tag>link</tag> target</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: table.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Apply patch to turn off <tag>row</tag> recursion if no @morerows attributes present.
|
|||
|
|
This will enable very large tables without <tag>row</tag> spanning to
|
|||
|
|
process without running into recursion limits.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: formal.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Format <tag>equation</tag> without <tag>title</tag> using <tag>table</tag> layout with <tag>equation</tag> number
|
|||
|
|
next to the <tag>equation</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: param.xweb; param.ent</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Add <parameter>equation.number.properties</parameter>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of FO changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_HTML">
|
|||
|
|
<title>HTML</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>html</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: block.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Modified <tag>acknowledgements</tag> template to avoid invalid output (<p> in <p>).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: titlepage.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added default <tag>sidebar</tag> attribute-sets.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: table.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: footnote.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 3033191 footnotes in html tables.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: inline.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
|
|||
|
|
with many inline glossterms.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: docbook.css.xml; verbatim.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2844927 Validity error for <tag>callout</tag> bugs.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: formal.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Convert formal.object.heading to respect <parameter>make.clean.html</parameter> param.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: titlepage.templates.xml; block.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2840768 <tag>sidebar</tag> without <tag>title</tag> inserts empty b <tag>tag</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Moved the template that outputs <base> so that the base URI also applies to relative CSS paths that come later.
|
|||
|
|
See patch #2896121.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: autoidx-kosek.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: chunk-code.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">fix bug 2948363 generated <tag>filename</tag> for <tag>refentry</tag> not unique, when
|
|||
|
|
used in a set.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: component.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix missing "<tag>Chapter</tag> n" <tag>label</tag> when use <tag>chapter</tag>/<tag>info</tag>/<tag>title</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: table.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message"><tag>Row</tag> recursion turned off if no @morerows attributes in the <tag>table</tag>.
|
|||
|
|
This will prevent failure on long <tag>table</tag> (with no @morerows) due
|
|||
|
|
to excessive depth of recursion.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: autotoc.xsl; docbook.css.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Support <parameter>make.clean.html</parameter> in autotoc.xsl.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: docbook.css.xml; block.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Add support for <parameter>make.clean.html</parameter> setting in block elements.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: docbook.css.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Stock CSS styles for DocBook HTML output when '<parameter>make.clean.html</parameter>' is non-zero.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: html.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Add templates for generating CSS files and links to them.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: param.xweb</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bugs in new entity references.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: chunk-common.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">List of Equations now includes on equations with titles.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: table.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">If a <tag>colspec</tag> has a colname attribute, add it to the HTML <tag>col</tag>
|
|||
|
|
element as a class attribute so it can be styled.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: formal.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2825842 where <tag>table</tag> footnotes not appearing in HTML-coded <tag>table</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: chunktoc.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug #2834826 where <tag>appendix</tag> inside part was not chunked as it should be.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: chunktoc.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added missing namespace declarations. Closes bug #2890069.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: footnote.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Updated the template for <tag>footnote</tag> paras to use the 'paragraph' template. Closes bug #2803739.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: inline.xsl; lists.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Remove <b> and <i> elements "discouraged in favor of style sheets" from
|
|||
|
|
XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
|
|||
|
|
|
|||
|
|
Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
|
|||
|
|
|
|||
|
|
Added regression to EPUB specs:</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: inline.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fixed bug #2844916 (don't output @target if <parameter>ulink.target</parameter> is empty).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: autoidx.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix a bug when using <parameter>index.on.type</parameter>: an '<tag>index</tag> symbols' <tag>section</tag> was created
|
|||
|
|
even if that typed <tag>index</tag> didn't include any symbols (they were in the other types).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of HTML changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_Manpages">
|
|||
|
|
<title>Manpages</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>manpages</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: other.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Modified the write.stubs template so that the <tag>section</tag> directory name is not output twice. Should fix bug #2831602.
|
|||
|
|
Also ensured that $lang is added to the .so path (when <parameter>man.output.lang.in.name.enabled</parameter>=1).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: docbook.xsl; other.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Norman Walsh: block.xsl; endnotes.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug where <tag>simpara</tag> in <tag>footnote</tag> didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>dleidert: lists.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix two indentation issues: In the first case there is no corresponding .RS
|
|||
|
|
macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
|
|||
|
|
the probably intended .sp leads to an indentation bug (Debian #527309,
|
|||
|
|
sf.net #2642139).</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of Manpages changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_Epub">
|
|||
|
|
<title>Epub</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>epub</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec/epub_spec.rb</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Resolve some actual regressions in <tag>date</tag> output spotted by more recent versions of epubcheck</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Updated <tag>mediaobject</tag> selection code that better uses roles (when available); based on contributons by Glenn McDonald</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Ensure that NCX documents are always outputted with a default namespace
|
|||
|
|
to prevent problems with the kindlegen machinery</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/partintro.xml; docbook.x⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Adding support for partintros with sect2s, 3s, etc</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Adding param to workaround horrific ADE bug with the inability to process <br></phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Add support for <tag>authorgroup</tag>/<tag>author</tag> in OPF metadata (via Michael Wiedmann)</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Remove <b> and <i> elements "discouraged in favor of style sheets" from
|
|||
|
|
XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
|
|||
|
|
|
|||
|
|
Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
|
|||
|
|
|
|||
|
|
Added regression to EPUB specs:</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf; docbook.xsl; bi⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">This resolves bug #2873142, Please add support for multiple embedded fonts
|
|||
|
|
|
|||
|
|
|
|||
|
|
If you navigate to a checkout of DocBook-XSL and go to:
|
|||
|
|
xsl/epub/bin/spec/files
|
|||
|
|
You can now run the following <tag>command</tag>:
|
|||
|
|
|
|||
|
|
../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
|
|||
|
|
-s test_cust.xsl orm.book.001.xml
|
|||
|
|
|
|||
|
|
In dbtoepub, the following option can be used more than once:
|
|||
|
|
-f, --font [OTF FILE] Embed OTF FILE in .epub.
|
|||
|
|
|
|||
|
|
The underlying stylesheet now accepts a comma-separated list of font file
|
|||
|
|
names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
|
|||
|
|
|
|||
|
|
The runnable EPUB spec now includes:
|
|||
|
|
- should be valid .epub after including more than one embedded font</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Improve the selection of <tag>cover</tag> images when working in DocBook 4.x land (work in progress)</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Improve the quality of the OPF spine regression by ensuring that the spine
|
|||
|
|
elements for deeply nested refentries are in order and adjacent to their
|
|||
|
|
opening wrapper XHTML chunk.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/orm.book.00⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Add more careful handling of refentries to ensure that they always appear in the opf:spine.
|
|||
|
|
This was only a problem when refentries were pushed deep into the hierarchy (like inside
|
|||
|
|
a <tag>sect2</tag>), but presented navigational problems for many reading systems (despite the
|
|||
|
|
correct NCX references). This may *not* be the best solution, but attacking a better
|
|||
|
|
chunking strategy for refentries was too big a nut to crack at this time.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of Epub changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_Eclipse">
|
|||
|
|
<title>Eclipse</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>eclipse</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: eclipse3.xsl</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x
|
|||
|
|
architecture. The main difference to the older format is that metadata is stored in a separate
|
|||
|
|
<parameter>manifest</parameter> file. The module imports and extends the existing eclipse.xsl module. Based on code
|
|||
|
|
contributed in patch #2624668.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of Eclipse changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_Params">
|
|||
|
|
<title>Params</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>params</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: draft.watermark.image.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Fix bug 2922488 <parameter>draft.watermark.image</parameter> pointing to web resource.
|
|||
|
|
Now the value is images/draft.png, and may require customization
|
|||
|
|
for local resolution.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Mauritz Jeanson: equation.number.properties.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Corrected <tag>refpurpose</tag>.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Norman Walsh: paper.type.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added USlegal and USlegallandscape paper types.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Jirka Kosek: highlight.xslthl.config.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Added note about specifying location as URL</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: docbook.css.source.xml; generate.css.header.xml; custom.css.source.xml; ma⋯</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Params to support generated CSS files.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>Robert Stayton: equation.number.properties.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">New attribute set for numbers appearing next to equations.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of Params changes for 1.76.0-->
|
|||
|
|
<sect2 xml:id="rnV1.76.0_XSL-Xalan">
|
|||
|
|
<title>XSL-Xalan</title>
|
|||
|
|
<para>The following changes have been made to the
|
|||
|
|
<filename>xsl-xalan</filename> code
|
|||
|
|
since the 1.75.2 release.</para>
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem>
|
|||
|
|
<para>
|
|||
|
|
<literal>dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml</literal>
|
|||
|
|
</para>
|
|||
|
|
<screen>
|
|||
|
|
<phrase role="commit-message">Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.</phrase>
|
|||
|
|
</screen>
|
|||
|
|
</listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</sect2>
|
|||
|
|
<!--end of XSL-Xalan changes for 1.76.0-->
|
|||
|
|
</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: /tru
|
|||
|
|
</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>
|