mirror of
https://github.com/keymanapp/keyman.git
synced 2026-09-05 23:27:40 +00:00
* Keyman for Windows 10.0 Open Source * Squashed 'windows/src/ext/jedi/jedi/' content from commit f444ad2 git-subtree-dir: windows/src/ext/jedi/jedi git-subtree-split: f444ad2da4693851e523f1ea6bd541f701904c24 * Squashed 'windows/src/ext/jedi/jcl/' content from commit d63d3c9fd git-subtree-dir: windows/src/ext/jedi/jcl git-subtree-split: d63d3c9fd9ff84efdd8159084ec6a60313644243 * Squashed 'windows/src/ext/jedi/jvcl/' content from commit bee19f3b4 git-subtree-dir: windows/src/ext/jedi/jvcl git-subtree-split: bee19f3b46909fde2fa92c06cd2706f41d99f6c3 * Add required .res files * Add required .res files * Add docbook files (forced) * Add required libxslt * Add required jedi files * Add installation files * Tweak .gitignore for open * CI * Remove KMW from Developer source (#122) * Remove KMW from Developer source (copies during build) * Remove KMW from Developer source (copies during build) * Remove KMW from Developer source (copies during build) * Fixup release build and copy license, readme from kmw during build * Remove obsolete build help documentation * Keyman Engine 10 on Windows regression for shift states (#129) * Improve #128 -- cleaner debug messages * Fixes #127, shift state now resets correctly; and more work for #128 * Fixes #130 (#131)
637 lines
132 KiB
HTML
637 lines
132 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Changes since the 1.73.2 release</title><meta name="generator" content="DocBook XSL Stylesheets V1.74.0-pre"><meta name="description" content="Note: This document lists changes only since the 1.73.2 release. If you instead want a record of the complete list of changes for the codebase over its entire history, you can obtain one by running the following commands: svn checkout https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/xsl svn log --xml --verbose xsl > ChangeHistory.xml"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2652329"></a>Changes since the 1.73.2 release</h2></div><div><div class="abstract"><p><span class="strong"><strong>Note:</strong></span> This
|
||
document lists changes only since the 1.73.2 release.
|
||
If you instead want a record of the complete list of
|
||
changes for the codebase over its entire history, you
|
||
can obtain one by running the following commands:
|
||
|
||
</p><pre class="screen"> <code class="code">svn checkout https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/xsl</code>
|
||
<code class="code">svn log --xml --verbose xsl > ChangeHistory.xml</code></pre></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#V1.74.0">Release Notes: 1.74.0</a></span></dt><dd><dl><dt><span class="sect2"><a href="#V1.74.0_Gentext">Gentext</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Common">Common</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_FO">FO</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_HTML">HTML</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Manpages">Manpages</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Epub">Epub</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_HTMLHelp">HTMLHelp</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Eclipse">Eclipse</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_JavaHelp">JavaHelp</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Roundtrip">Roundtrip</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Slides">Slides</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Website">Website</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Params">Params</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Profiling">Profiling</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Lib">Lib</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Tools">Tools</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Template">Template</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_Extensions">Extensions</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_XSL-Saxon">XSL-Saxon</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_XSL-Xalan">XSL-Xalan</a></span></dt><dt><span class="sect2"><a href="#V1.74.0_XSL-libxslt">XSL-libxslt</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1.74.0"></a>Release Notes: 1.74.0</h2></div></div></div><p>The following is a list of changes that have been made
|
||
since the 1.73.2 release.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Gentext"></a>Gentext</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">gentext</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Michael(tm) Smith: locale/id.xml</code></p><pre class="screen"><span class="commit-message">Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/lt.xml</code></p><pre class="screen"><span class="commit-message">Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/hu.xml</code></p><pre class="screen"><span class="commit-message">fixed error in lowercase.alpha definition in Hungarian locale</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/nb.xml</code></p><pre class="screen"><span class="commit-message">Corrected language code for nb locale, and restored missing
|
||
"startquote" key.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/ja.xml</code></p><pre class="screen"><span class="commit-message">Committed changes to ja locale file, from Akagi Kobayashi. Adds
|
||
bracket quotes around many <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> instances that did not have them
|
||
before.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: Makefile</code></p><pre class="screen"><span class="commit-message">"no" locale is now "nb"</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/nb.xml</code></p><pre class="screen"><span class="commit-message">Update Norwegian Bokm<6B>l translation. Thanks to Hans F. Nordhaug.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/no.xml; locale/nb.xml</code></p><pre class="screen"><span class="commit-message">per message from Hans F. Nordhaug, correct identifier for
|
||
Norwegian Bokm<6B>l is "nb" (not "no") and has been for quite some
|
||
time now...</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/ja.xml</code></p><pre class="screen"><span class="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 <a href="http://docbook.org/tdg/en/html/editor.html"><code class="sgmltag-element">editor</code></a>
|
||
(instead of the character references).</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/ja.xml</code></p><pre class="screen"><span class="commit-message">Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: xsl/xsl.xsl</code></p><pre class="screen"><span class="commit-message">Corrected repository URL.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: locale/it.xml</code></p><pre class="screen"><span class="commit-message">Changes from Federico Zenith</span></pre></li><li><p><code class="literal">Dongsheng Song: locale/zh_cn.xml</code></p><pre class="screen"><span class="commit-message">Added missing translations.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Common"></a>Common</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">common</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Jirka Kosek: common.xsl</code></p><pre class="screen"><span class="commit-message"></span></pre></li><li><p><code class="literal">Keith Fahlgren: l10n.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a>
|
||
- should be valid .epub after rendering an <a href="http://docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a> without sections
|
||
- should be valid .epub after rendering a <a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a>
|
||
- should be valid .epub after rendering a <a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a> even if it has one graphic
|
||
- should be valid .epub after rendering a <a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a> even if it has many graphics
|
||
- should be valid .epub after rendering a <a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a> 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 <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a> <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> in rendered epub files for <<a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a>>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
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/calloutlist.003.epub: could not parse OEBPS/index.html: duplicate id: dos
|
||
|
||
2)
|
||
'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
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/cmdsynopsis.001.epub/OEBPS/re01.html(5): element "p" from namespace "http://www.w3.org/1999/xhtml" not allowed in this context
|
||
|
||
3)
|
||
'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.002.xml [36]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/cmdsynopsis.002.epub/OEBPS/index.html(4): element "div" from namespace "http://www.w3.org/1999/xhtml" not allowed in this context
|
||
|
||
4)
|
||
'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/extensions.002.xml [50]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/extensions.002.epub/OEBPS/index.html(3): attribute "type" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/extensions.002.epub/OEBPS/index.html(3): attribute "show" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/extensions.002.epub/OEBPS/index.html(3): attribute "actuate" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
|
||
5)
|
||
'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/extensions.004.xml [52]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/extensions.004.epub/OEBPS/index.html(5): attribute "type" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/extensions.004.epub/OEBPS/index.html(5): attribute "show" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/extensions.004.epub/OEBPS/index.html(5): attribute "actuate" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
|
||
6)
|
||
'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/funcsynopsis.001.xml [65]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/funcsynopsis.001.epub/OEBPS/index.html(5): element "code" from namespace "http://www.w3.org/1999/xhtml" not allowed in this context
|
||
|
||
7)
|
||
'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/imageobjectco.001.xml [70]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/imageobjectco.001.epub/OEBPS/index.html(3): attribute "border" not allowed at this point; ignored
|
||
|
||
8)
|
||
'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/olink.001.xml [118]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/olink.001.epub/OEBPS/index.html(3): 'OEBPS/file:///sourceforge/projects/docbook/testdocs/tests/olink.001.html': referenced resource missing in the package
|
||
|
||
9)
|
||
'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/programlisting.002.xml [129]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/programlisting.002.epub/OEBPS/index.html(3): attribute "type" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/programlisting.002.epub/OEBPS/index.html(3): attribute "show" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/programlisting.002.epub/OEBPS/index.html(3): attribute "actuate" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
|
||
10)
|
||
RuntimeError in '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/programlisting.006.xml [133]'
|
||
Could not render as .epub to /tmp/epubspecsmoke/programlisting.006.epub (xsltproc --xinclude --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a> 1 --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/callout.graphics.path.html"><em class="parameter"><code>callout.graphics.path</code></em></a> images/callouts/ --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/callout.graphics.number.limit.html"><em class="parameter"><code>callout.graphics.number.limit</code></em></a> 15 --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/callout.graphics.extension.html"><em class="parameter"><code>callout.graphics.extension</code></em></a> .png --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> /tmp/epubspecsmoke/OEBPS/ --stringparam epub.metainf.dir /tmp/epubspecsmoke/META-INF/ --stringparam epub.oebps.dir /tmp/epubspecsmoke/OEBPS/ /Users/keith/work/docbook-dev/trunk/xsl/epub/docbook.xsl /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/programlisting.006.xml)
|
||
|
||
11)
|
||
RuntimeError in '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/programlistingco.002.xml [135]'
|
||
Could not render as .epub to /tmp/epubspecsmoke/programlistingco.002.epub (xsltproc --xinclude --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a> 1 --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/callout.graphics.path.html"><em class="parameter"><code>callout.graphics.path</code></em></a> images/callouts/ --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/callout.graphics.number.limit.html"><em class="parameter"><code>callout.graphics.number.limit</code></em></a> 15 --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/callout.graphics.extension.html"><em class="parameter"><code>callout.graphics.extension</code></em></a> .png --stringparam <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> /tmp/epubspecsmoke/OEBPS/ --stringparam epub.metainf.dir /tmp/epubspecsmoke/META-INF/ --stringparam epub.oebps.dir /tmp/epubspecsmoke/OEBPS/ /Users/keith/work/docbook-dev/trunk/xsl/epub/docbook.xsl /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/programlistingco.002.xml)
|
||
|
||
12)
|
||
'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/refentry.007.xml [148]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/refentry.007.epub/OEBPS/rn01re01.html(5): element "code" from namespace "http://www.w3.org/1999/xhtml" not allowed in this context
|
||
|
||
13)
|
||
'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/table.003.xml [191]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/table.003.epub/OEBPS/index.html(4): 'ftn.id964170': fragment identifier is not defined in 'OEBPS/index.html'
|
||
|
||
14)
|
||
'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/textobject.001.xml [207]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/textobject.001.epub/OEBPS/index.html(3): attribute "type" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/textobject.001.epub/OEBPS/index.html(3): attribute "show" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/textobject.001.epub/OEBPS/index.html(3): attribute "actuate" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
|
||
15)
|
||
'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/textobject.002.xml [208]' FAILED
|
||
expected .epub file to be valid, but validation produced these errors:
|
||
/tmp/epubspecsmoke/textobject.002.epub/OEBPS/index.html(3): attribute "type" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/textobject.002.epub/OEBPS/index.html(3): attribute "show" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
/tmp/epubspecsmoke/textobject.002.epub/OEBPS/index.html(3): attribute "actuate" from namespace "http://www.w3.org/1999/xlink" not allowed at this point; ignored
|
||
|
||
|
||
Finished in 629.89194 seconds
|
||
|
||
224 examples, 15 failures
|
||
|
||
224 examples, 15 failures yields 6% failure rate</span></pre></li><li><p><code class="literal">Michael(tm) Smith: l10n.xsl</code></p><pre class="screen"><span class="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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">fixed syntax error</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">fixed a couple of typos</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">refined handling of cases where <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> "source" or "manual"
|
||
metadata is missing or when we use fallback content instead. We
|
||
now report a Warning if we use fallback content.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">revert part of previous commit that SF stupidity caused me to fuck up</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">don't use refmiscinfo@class=<a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> value as fallback for <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>
|
||
"source" or "manual" metadata fields</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">Made reporting of missing <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> 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 <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>
|
||
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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">When generating manpages output, we no longer report anything if
|
||
the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> source is missing <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> or <a href="http://docbook.org/tdg/en/html/pubdate.html"><code class="sgmltag-element">pubdate</code></a> content. In
|
||
practice, many users intentionally omit the <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> from the source
|
||
because they explicitly want it to be generated.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: l10n.xml; .cvsignore; Makefile</code></p><pre class="screen"><span class="commit-message">Added in support for building the Galician locale.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: l10n.xml</code></p><pre class="screen"><span class="commit-message">further change needed for switch from no locale to nb.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .cvsignore</code></p><pre class="screen"><span class="commit-message">ignore nb.xml</span></pre></li><li><p><code class="literal">Michael(tm) Smith: common.xsl</code></p><pre class="screen"><span class="commit-message">Added support for <a href="http://docbook.org/tdg/en/html/orgname.html"><code class="sgmltag-element">orgname</code></a> in <a href="http://docbook.org/tdg/en/html/authorgroup.html"><code class="sgmltag-element">authorgroup</code></a>. Thanks to Camille
|
||
B<EFBFBD>gnis.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: Makefile</code></p><pre class="screen"><span class="commit-message">"no" locale is now "nb"</span></pre></li><li><p><code class="literal">Mauritz Jeanson: stripns.xsl</code></p><pre class="screen"><span class="commit-message">Removed the template matching "ng:link|db:<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>" (in order to make @xlink:show
|
||
work with <<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>> elements). As far as I can tell, this template is no longer needed.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: entities.ent</code></p><pre class="screen"><span class="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titles.xsl</code></p><pre class="screen"><span class="commit-message">Added an update the fix made in <a href="http://docbook.org/tdg/en/html/revision.html"><code class="sgmltag-element">revision</code></a> 7528 (handling of <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a>/<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> in no.anchor.mode mode).
|
||
Having <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> in <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> is not a problem as long as the target is not an ancestor element.
|
||
Closes bug #1838136.
|
||
|
||
Note that an <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> that is in a <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> and whose target is an ancestor element is still not
|
||
rendered in the <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a>. This could be considered a bug, but on the other hand I cannot really
|
||
see the point in having such an <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> in a document.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titles.xsl</code></p><pre class="screen"><span class="commit-message">Added a "not(ancestor::<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>)" 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.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titles.xsl</code></p><pre class="screen"><span class="commit-message">Removed old template matching "<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>" in no.anchor.mode mode.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titles.xsl</code></p><pre class="screen"><span class="commit-message">Process <<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>> in no.anchor.mode mode with the same template as <<a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a>>.
|
||
Closes bug #1759205 (Empty <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> in no.anchor.mode mode).</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titles.xsl</code></p><pre class="screen"><span class="commit-message">In no.anchor.mode mode, do not output anchors for elements that are descendants
|
||
of <<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>>. Previously, having inline elements with @id/@xml:id in <<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>>s
|
||
resulted in anchors both in the <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a> and in the main flow. Closes bug #1797492.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_FO"></a>FO</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">fo</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Mauritz Jeanson: pi.xsl</code></p><pre class="screen"><span class="commit-message">Updated documentation for keep-together.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: task.xsl</code></p><pre class="screen"><span class="commit-message">Enabled use of the keep-together PI on <a href="http://docbook.org/tdg/en/html/task.html"><code class="sgmltag-element">task</code></a> elements.</span></pre></li><li><p><code class="literal">Jirka Kosek: lists.xsl</code></p><pre class="screen"><span class="commit-message"></span></pre></li><li><p><code class="literal">Robert Stayton: index.xsl</code></p><pre class="screen"><span class="commit-message">FOP1 requires fo:wrapper for inline <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> entries, not fo:inline.</span></pre></li><li><p><code class="literal">Robert Stayton: index.xsl</code></p><pre class="screen"><span class="commit-message">Fixed non-working inline.or.block template for <a href="http://docbook.org/tdg/en/html/indexterm.html"><code class="sgmltag-element">indexterm</code></a> wrappers.
|
||
Add fop1 to list of processors using inline.or.block.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Mauritz Jeanson: table.xsl</code></p><pre class="screen"><span class="commit-message">Fixed bug #1891965 (colsep in entytbl not working).</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titlepage.xsl</code></p><pre class="screen"><span class="commit-message">Added support for <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> in <a href="http://docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a>. Closes bug #1842847.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: pi.xsl</code></p><pre class="screen"><span class="commit-message">Small doc cleanup (dbfo float-type).</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titlepage.xsl</code></p><pre class="screen"><span class="commit-message">Insert commas between multiple <a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a> holders.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: autotoc.xsl; division.xsl</code></p><pre class="screen"><span class="commit-message">Added modifications to support nested set elements. See bug #1853172.</span></pre></li><li><p><code class="literal">David Cramer: glossary.xsl</code></p><pre class="screen"><span class="commit-message">Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.</span></pre></li><li><p><code class="literal">David Cramer: glossary.xsl</code></p><pre class="screen"><span class="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on <a href="http://docbook.org/tdg/en/html/glossentry.html"><code class="sgmltag-element">glossentry</code></a></span></pre></li><li><p><code class="literal">Mauritz Jeanson: inline.xsl</code></p><pre class="screen"><span class="commit-message">Added a template for <a href="http://docbook.org/tdg/en/html/citebiblioid.html"><code class="sgmltag-element">citebiblioid</code></a>. The hyperlink target is the parent of the referenced <a href="http://docbook.org/tdg/en/html/biblioid.html"><code class="sgmltag-element">biblioid</code></a>,
|
||
and the "hot text" is the <a href="http://docbook.org/tdg/en/html/biblioid.html"><code class="sgmltag-element">biblioid</code></a> itself enclosed in brackets.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: inline.xsl</code></p><pre class="screen"><span class="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: docbook.xsl</code></p><pre class="screen"><span class="commit-message">Updated message about unmatched element.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: param.xweb</code></p><pre class="screen"><span class="commit-message">Added <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> to profiling <a href="http://docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a> of TCG.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: refentry.xsl</code></p><pre class="screen"><span class="commit-message">Fixed typo (refsynopsysdiv -> <a href="http://docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a>).</span></pre></li><li><p><code class="literal">David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl</code></p><pre class="screen"><span class="commit-message">Added test to check <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.index.html"><em class="parameter"><code>generate.index</code></em></a> param when generating pdf bookmarks</span></pre></li><li><p><code class="literal">Mauritz Jeanson: graphics.xsl</code></p><pre class="screen"><span class="commit-message">Added support for MathML in <a href="http://docbook.org/tdg/en/html/imagedata.html"><code class="sgmltag-element">imagedata</code></a>.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: math.xsl</code></p><pre class="screen"><span class="commit-message">Removed unnecessary extra test condition in test express that
|
||
checks for passivetex.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: math.xsl</code></p><pre class="screen"><span class="commit-message">Don't use fo:instream-foreign-object if we are processing with
|
||
passivetex. Closes #1806899. Thanks to Justus Piater.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: component.xsl</code></p><pre class="screen"><span class="commit-message">Added code to output a <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a> for an <a href="http://docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> in an <a href="http://docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a> when
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.toc.html"><em class="parameter"><code>generate.toc</code></em></a>='<a href="http://docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a>/<a href="http://docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a>'. Closes bug #1669658.</span></pre></li><li><p><code class="literal">Dongsheng Song: biblio-iso690.xsl</code></p><pre class="screen"><span class="commit-message">Change encoding from "windows-1250" to "UTF-8".</span></pre></li><li><p><code class="literal">Mauritz Jeanson: pi.xsl</code></p><pre class="screen"><span class="commit-message">Updated documentation for dbfo_label-width.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: lists.xsl</code></p><pre class="screen"><span class="commit-message">Added support for the dbfo_label-width PI in calloutlists.</span></pre></li><li><p><code class="literal">Robert Stayton: biblio.xsl</code></p><pre class="screen"><span class="commit-message">Support finding <a href="http://docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a> <a href="http://docbook.org/tdg/en/html/database.html"><code class="sgmltag-element">database</code></a> entries inside bibliodivs.</span></pre></li><li><p><code class="literal">Robert Stayton: formal.xsl</code></p><pre class="screen"><span class="commit-message">Complete support for <?dbfo pgwide="1"?> for informal
|
||
elements too.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: table.xsl</code></p><pre class="screen"><span class="commit-message">In the table.block template, added a check for the dbfo_keep-together PI, so that
|
||
a <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> may break (depending on the PI value) at a page break. This was needed
|
||
since the outer fo:block that surrounds fo:<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> has keep-together.within-column="always"
|
||
by default, which prevents the <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> from breaking. Closes bug #1740964 (Titled
|
||
<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> does not respect dbfo PI).</span></pre></li><li><p><code class="literal">Mauritz Jeanson: pi.xsl</code></p><pre class="screen"><span class="commit-message">Added a few missing @role="tcg".</span></pre></li><li><p><code class="literal">Michael(tm) Smith: xref.xsl</code></p><pre class="screen"><span class="commit-message">Corrected dumb error I made in r7435 change.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: inline.xsl</code></p><pre class="screen"><span class="commit-message">Use normalize-space() in <a href="http://docbook.org/tdg/en/html/glossterm.html"><code class="sgmltag-element">glossterm</code></a> comparisons (as in html/inline.xsl).</span></pre></li><li><p><code class="literal">Mauritz Jeanson: autoidx.xsl</code></p><pre class="screen"><span class="commit-message">Removed the [&scope;] predicate from the target variable in the template with name="<a href="http://docbook.org/tdg/en/html/reference.html"><code class="sgmltag-element">reference</code></a>".
|
||
This filter was the cause of missing <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> backlinks when @zone and @type were used on indexterms,
|
||
with <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.on.type.html"><em class="parameter"><code>index.on.type</code></em></a>=1. Closes bug #1680836.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> 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 <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> to be displayed either
|
||
inline or as numbered footnotes (depending on what values the user
|
||
has the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/ulink.show.html"><em class="parameter"><code>ulink.show</code></em></a> and <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/ulink.footnotes.html"><em class="parameter"><code>ulink.footnotes</code></em></a> 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 <a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>
|
||
number to assign to each <a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a> 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.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_HTML"></a>HTML</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">html</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: inline.xsl; synop.xsl</code></p><pre class="screen"><span class="commit-message">Work to make HTML and XHTML targets more valid</span></pre></li><li><p><code class="literal">Keith Fahlgren: table.xsl</code></p><pre class="screen"><span class="commit-message">Add better handling for tables that have footnotes in the titles</span></pre></li><li><p><code class="literal">Keith Fahlgren: biblio.xsl</code></p><pre class="screen"><span class="commit-message">Add anchors to bibliodivs</span></pre></li><li><p><code class="literal">Jirka Kosek: lists.xsl</code></p><pre class="screen"><span class="commit-message"></span></pre></li><li><p><code class="literal">Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl</code></p><pre class="screen"><span class="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
|
||
and Keith Fahlgren of O'Reilly.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: biblio.xsl</code></p><pre class="screen"><span class="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) <a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">Figure</code></a> out how @class="doi" should be handled
|
||
for <a href="http://docbook.org/tdg/en/html/bibliorelation.html"><code class="sgmltag-element">bibliorelation</code></a>, <a href="http://docbook.org/tdg/en/html/bibliosource.html"><code class="sgmltag-element">bibliosource</code></a> and <a href="http://docbook.org/tdg/en/html/citebiblioid.html"><code class="sgmltag-element">citebiblioid</code></a>.</span></pre></li><li><p><code class="literal">Norman Walsh: formal.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a> result elements, so use one of them.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: Makefile</code></p><pre class="screen"><span class="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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: docbook.xsl</code></p><pre class="screen"><span class="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</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .cvsignore; .gitignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Norman Walsh: chunk-common.xsl</code></p><pre class="screen"><span class="commit-message">Rename <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a></span></pre></li><li><p><code class="literal">Mauritz Jeanson: table.xsl</code></p><pre class="screen"><span class="commit-message">Added a fix to make rowsep apply to the last <a href="http://docbook.org/tdg/en/html/row.html"><code class="sgmltag-element">row</code></a> of <a href="http://docbook.org/tdg/en/html/thead.html"><code class="sgmltag-element">thead</code></a> in <a href="http://docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a>.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl</code></p><pre class="screen"><span class="commit-message">Simplified and streamlined handling of output for ANSI-style
|
||
<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> 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:
|
||
<<a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>><a href="http://docbook.org/tdg/en/html/void.html"><code class="sgmltag-element">void</code></a> *<parameter>dataptr</parameter>[]</<a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>>
|
||
... the brackets (indicating an array type) were being dropped.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl</code></p><pre class="screen"><span class="commit-message">Changed HTML handling of K&R-style <a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a> output. The parameter
|
||
definitions are no longer output in a <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> (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:
|
||
<<a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>><a href="http://docbook.org/tdg/en/html/void.html"><code class="sgmltag-element">void</code></a> *<parameter>dataptr</parameter>[]</<a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>>
|
||
... 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 <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> 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...</span></pre></li><li><p><code class="literal">Michael(tm) Smith: pi.xsl</code></p><pre class="screen"><span class="commit-message">updated wording of doc for funcsynopsis-style PI</span></pre></li><li><p><code class="literal">Michael(tm) Smith: param.xweb; param.ent; synop.xsl</code></p><pre class="screen"><span class="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
|
||
being used in the code and hasn't been since mid 2006.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: graphics.xsl</code></p><pre class="screen"><span class="commit-message">Added support for the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a> parameter for SVG graphics. Closes bug #1888169.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: chunk-common.xsl</code></p><pre class="screen"><span class="commit-message">Added missing space.</span></pre></li><li><p><code class="literal">Norman Walsh: component.xsl</code></p><pre class="screen"><span class="commit-message">Fix bug where component titles inside <a href="http://docbook.org/tdg/en/html/info.html"><code class="sgmltag-element">info</code></a> elements were not handled properly</span></pre></li><li><p><code class="literal">Michael(tm) Smith: pi.xsl</code></p><pre class="screen"><span class="commit-message">Moved dbhtml_stop-chunking embedded doc into alphabetical order,
|
||
fixed text of TCG <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> it see-also'ed.</span></pre></li><li><p><code class="literal">David Cramer: pi.xsl</code></p><pre class="screen"><span class="commit-message">Added support for <?dbhtml stop-chunking?> processing instruction</span></pre></li><li><p><code class="literal">David Cramer: chunk-common.xsl; pi.xsl</code></p><pre class="screen"><span class="commit-message">Added support for <?dbhtml stop-chunking?> processing instruction</span></pre></li><li><p><code class="literal">David Cramer: glossary.xsl</code></p><pre class="screen"><span class="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on <a href="http://docbook.org/tdg/en/html/glossentry.html"><code class="sgmltag-element">glossentry</code></a>. Also added normalize-space to avoid missorting due to stray leading spaces.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: inline.xsl</code></p><pre class="screen"><span class="commit-message">Added a template for <a href="http://docbook.org/tdg/en/html/citebiblioid.html"><code class="sgmltag-element">citebiblioid</code></a>. The hyperlink target is the parent of the referenced <a href="http://docbook.org/tdg/en/html/biblioid.html"><code class="sgmltag-element">biblioid</code></a>,
|
||
and the "hot text" is the <a href="http://docbook.org/tdg/en/html/biblioid.html"><code class="sgmltag-element">biblioid</code></a> itself enclosed in brackets.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: inline.xsl</code></p><pre class="screen"><span class="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
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ulink.target.html"><em class="parameter"><code>ulink.target</code></em></a> parameter). I have assumed that @xlink:show should override <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ulink.target.html"><em class="parameter"><code>ulink.target</code></em></a>
|
||
for external URI links. This closes bugs #1762023 and #1727498.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: inline.xsl</code></p><pre class="screen"><span class="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: param.xweb</code></p><pre class="screen"><span class="commit-message">Added <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> to profiling <a href="http://docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a> of TCG.</span></pre></li><li><p><code class="literal">Dongsheng Song: biblio-iso690.xsl</code></p><pre class="screen"><span class="commit-message">Change encoding from "windows-1250" to "UTF-8".</span></pre></li><li><p><code class="literal">Robert Stayton: biblio.xsl</code></p><pre class="screen"><span class="commit-message">Add support in biblio collection to entries in bibliodivs.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: pi.xsl</code></p><pre class="screen"><span class="commit-message">Added missing @role="tcg".</span></pre></li><li><p><code class="literal">Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</code></p><pre class="screen"><span class="commit-message">Refactored <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>/<a href="http://docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a> chunking, so that the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/use.id.as.filename.html"><em class="parameter"><code>use.id.as.filename</code></em></a>
|
||
parameter as well as the dbhtml_filename PI are taken into account. A new named
|
||
template in titlepage.xsl is used to compute the <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a>.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</code></p><pre class="screen"><span class="commit-message">An update to the fix for bug #1790495 (r7433):
|
||
The "ln-" prefix is output only when the <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> doesn't have an
|
||
@id/@xml:id, in which case the stylesheets generate an ID value,
|
||
resulting in a <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> like "ln-7e0fwgj.html". This is useful because
|
||
without the prefix, you wouldn't know that the file contained a <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.
|
||
The same logic is also applied to <a href="http://docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a>, using an "rh-" prefix.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: autoidx.xsl</code></p><pre class="screen"><span class="commit-message">Removed the [&scope;] predicate from the target variable in the template with name="<a href="http://docbook.org/tdg/en/html/reference.html"><code class="sgmltag-element">reference</code></a>".
|
||
This filter was the cause of missing <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> backlinks when @zone and @type were used on indexterms,
|
||
with <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.on.type.html"><em class="parameter"><code>index.on.type</code></em></a>=1. Closes bug #1680836.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: titlepage.xsl</code></p><pre class="screen"><span class="commit-message">Added 'ln-' prefix to the name of the <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> chunk, in order to match the
|
||
<<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).
|
||
Modified the href attribute on the <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.
|
||
Closes bug #1790495.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Manpages"></a>Manpages</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">manpages</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">slightly adjusted spacing around admonition markers</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl; utility.xsl</code></p><pre class="screen"><span class="commit-message">make sure <a href="http://docbook.org/tdg/en/html/refsect3.html"><code class="sgmltag-element">refsect3</code></a> titles are preceded by a line of space, and
|
||
make the indenting of their child content less severe</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">only indent verbatim environments in TTY output, not in non-TTY/PS</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">made another adjustment to correct vertical <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/alignment.html"><em class="parameter"><code>alignment</code></em></a> of admonition marker</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl; other.xsl</code></p><pre class="screen"><span class="commit-message">Adjusted/corrected <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/alignment.html"><em class="parameter"><code>alignment</code></em></a> of adominition marker in PS/non-TTY output.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: endnotes.xsl</code></p><pre class="screen"><span class="commit-message">For PS/non-TTY output, display <a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>/endnote numbers in
|
||
<a href="http://docbook.org/tdg/en/html/superscript.html"><code class="sgmltag-element">superscript</code></a>.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</code></p><pre class="screen"><span class="commit-message">Changed handling of hanging indents for <a href="http://docbook.org/tdg/en/html/cmdsynopsis.html"><code class="sgmltag-element">cmdsynopsis</code></a>, <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a>,
|
||
and <a href="http://docbook.org/tdg/en/html/synopfragment.html"><code class="sgmltag-element">synopfragment</code></a> 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 <a href="http://docbook.org/tdg/en/html/command.html"><code class="sgmltag-element">command</code></a>, <a href="http://docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a>, or
|
||
<a href="http://docbook.org/tdg/en/html/synopfragment.html"><code class="sgmltag-element">synopfragment</code></a> 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 <a href="http://docbook.org/tdg/en/html/cmdsynopsis.html"><code class="sgmltag-element">cmdsynopsis</code></a> and <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> instead of the
|
||
corresponding verbatim-* templates.
|
||
|
||
Along with those changes, also corrected a problem that caused the
|
||
content of <a href="http://docbook.org/tdg/en/html/synopfragment.html"><code class="sgmltag-element">synopfragment</code></a> to be dropped, and made a
|
||
vertical-spacing change to adjust spacing around <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> titles and
|
||
among sibling <a href="http://docbook.org/tdg/en/html/synopfragment.html"><code class="sgmltag-element">synopfragment</code></a> instances.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">use common l10.language.name template to retrieve English-language name</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl; inline.xsl</code></p><pre class="screen"><span class="commit-message">added comment in code explaining why we don't put <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> output
|
||
in italic (despite the fact that man guidelines say we should)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: inline.xsl</code></p><pre class="screen"><span class="commit-message">put <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> output in monospace instead of italic</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl</code></p><pre class="screen"><span class="commit-message">put <a href="http://docbook.org/tdg/en/html/cmdsynopsis.html"><code class="sgmltag-element">cmdsynopsis</code></a> in monospace</span></pre></li><li><p><code class="literal">Michael(tm) Smith: inline.xsl</code></p><pre class="screen"><span class="commit-message">removed template match for <a href="http://docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a>. template matches for monospace
|
||
inlines are all imported from the HTML stylesheet</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">don't indent verbatim environments that are descendants of
|
||
<a href="http://docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a>, not put backgrounds behind them</span></pre></li><li><p><code class="literal">Michael(tm) Smith: inline.xsl</code></p><pre class="screen"><span class="commit-message">set output of the <a href="http://docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a> 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 <<a href="http://docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a>> for
|
||
inline monospace (not <<a href="http://docbook.org/tdg/en/html/command.html"><code class="sgmltag-element">command</code></a>> or <code> or anything else).
|
||
Of course this only affects non-TTY output...</span></pre></li><li><p><code class="literal">Michael(tm) Smith: utility.xsl</code></p><pre class="screen"><span class="commit-message">Added inline.monoseq named template.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: utility.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.org/tdg/en/html/arg.html"><code class="sgmltag-element">arg</code></a> to switch back</span></pre></li><li><p><code class="literal">Michael(tm) Smith: endnotes.xsl</code></p><pre class="screen"><span class="commit-message">put links in blue in PS output (note that this matches how groff
|
||
renders content marked up with the .URL macro)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</code></p><pre class="screen"><span class="commit-message">removed <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.are.underlined.html"><em class="parameter"><code>man.links.are.underlined</code></em></a> and added man.font.links. Also,
|
||
changed the default font formatting for links to bold.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">fixed typo</span></pre></li><li><p><code class="literal">Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</code></p><pre class="screen"><span class="commit-message">Added new param man.base.url.for.relative.links .. specifies a
|
||
base URL for relative links (for ulink, @xlink:href, <a href="http://docbook.org/tdg/en/html/imagedata.html"><code class="sgmltag-element">imagedata</code></a>,
|
||
<a href="http://docbook.org/tdg/en/html/audiodata.html"><code class="sgmltag-element">audiodata</code></a>, <a href="http://docbook.org/tdg/en/html/videodata.html"><code class="sgmltag-element">videodata</code></a>) shown in the generated NOTES <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> 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 <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> sources in your DocBook <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>
|
||
source, and you leave man.base.url.for.relative.links unset, the
|
||
relative links will appear "as is" in the NOTES <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> 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
|
||
<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> source. For example:
|
||
|
||
<xsl:param name="man.base.url.for.relative.links"
|
||
>http://www.kernel.org/pub/software/scm/git/docs/</xsl:param></span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">If a source <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> contains a Documentation or DOCUMENTATION
|
||
<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>, don't report it as having missing <a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">AUTHOR</code></a> information.
|
||
Also, if missing a <a href="http://docbook.org/tdg/en/html/contrib.html"><code class="sgmltag-element">contrib</code></a>/<a href="http://docbook.org/tdg/en/html/personblurb.html"><code class="sgmltag-element">personblurb</code></a> for a <a href="http://docbook.org/tdg/en/html/person.html"><code class="sgmltag-element">person</code></a> or org, report
|
||
pointers to http://docbook.sf.net/el/<a href="http://docbook.org/tdg/en/html/personblurb.html"><code class="sgmltag-element">personblurb</code></a> and to
|
||
http://docbook.sf.net/el/<a href="http://docbook.org/tdg/en/html/contrib.html"><code class="sgmltag-element">contrib</code></a></span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">If we encounter an author|editor|othercredit instance that lacks a
|
||
<a href="http://docbook.org/tdg/en/html/personblurb.html"><code class="sgmltag-element">personblurb</code></a> or <a href="http://docbook.org/tdg/en/html/contrib.html"><code class="sgmltag-element">contrib</code></a>, 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...)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl</code></p><pre class="screen"><span class="commit-message">if we can't find any usable <a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">author</code></a> data, emit a warning and insert
|
||
a fixme in the output</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">fixed bug in indenting of output for <a href="http://docbook.org/tdg/en/html/contrib.html"><code class="sgmltag-element">contrib</code></a> instances in AUTHORS
|
||
<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>. Thanks to Daniel Leidert and the fglrx docs for exposing
|
||
the bug.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">for a <a href="http://docbook.org/tdg/en/html/para.html"><code class="sgmltag-element">para</code></a> or <a href="http://docbook.org/tdg/en/html/simpara.html"><code class="sgmltag-element">simpara</code></a> that is the first child of a <a href="http://docbook.org/tdg/en/html/callout.html"><code class="sgmltag-element">callout</code></a>,
|
||
suppress the .sp or .PP that would normally be output (because in
|
||
those cases, the output goes into a <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> cell, and the .sp or .PP
|
||
markup causes a spurious linebreak before it when displayed</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">fixed typos in comments</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">Added support for rendering <a href="http://docbook.org/tdg/en/html/co.html"><code class="sgmltag-element">co</code></a> callouts and <a href="http://docbook.org/tdg/en/html/calloutlist.html"><code class="sgmltag-element">calloutlist</code></a> instances.
|
||
So you can now use simple callouts -- marking up <a href="http://docbook.org/tdg/en/html/programlisting.html"><code class="sgmltag-element">programlisting</code></a>
|
||
and such with <a href="http://docbook.org/tdg/en/html/co.html"><code class="sgmltag-element">co</code></a> 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 <a href="http://docbook.org/tdg/en/html/areaset.html"><code class="sgmltag-element">areaset</code></a> and <a href="http://docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a>)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">only put a line of space after a verbatim if it's followed by a
|
||
text node or a paragraph</span></pre></li><li><p><code class="literal">Michael(tm) Smith: utility.xsl</code></p><pre class="screen"><span class="commit-message">put verbatim environments in slightly smaller font in non-TTY
|
||
output</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">minor whitespace-only reformatting of lists.xsl source</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">Made refinements/fixes to output of <a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a> and <a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a>
|
||
-- in part, to get mysql man pages to display correctly. This
|
||
change causes a "\c" continuation marker to be added between
|
||
<a href="http://docbook.org/tdg/en/html/listitem.html"><code class="sgmltag-element">listitem</code></a> markers and contents (to ensure that the content remains
|
||
on the same line as the marker when displayed)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="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)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">refined spacing around titles for admonitions</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl; other.xsl</code></p><pre class="screen"><span class="commit-message">Deal with case of verbatim environments that have a linebreak
|
||
after the opening <a href="http://docbook.org/tdg/en/html/tag.html"><code class="sgmltag-element">tag</code></a>. 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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: inline.xsl</code></p><pre class="screen"><span class="commit-message"><a href="http://docbook.org/tdg/en/html/indexterm.html"><code class="sgmltag-element">indexterm</code></a> instances now produce groff comments like this:
|
||
|
||
.\" <a href="http://docbook.org/tdg/en/html/primary.html"><code class="sgmltag-element">primary</code></a>: <a href="http://docbook.org/tdg/en/html/secondary.html"><code class="sgmltag-element">secondary</code></a>: <a href="http://docbook.org/tdg/en/html/tertiary.html"><code class="sgmltag-element">tertiary</code></a>
|
||
|
||
<a href="http://docbook.org/tdg/en/html/remark.html"><code class="sgmltag-element">remark</code></a> instances, if non-empty, now produce groff comments</span></pre></li><li><p><code class="literal">Michael(tm) Smith: charmap.groff.xsl; other.xsl</code></p><pre class="screen"><span class="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</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">output "sp" before <a href="http://docbook.org/tdg/en/html/simpara.html"><code class="sgmltag-element">simpara</code></a> output, not after it (outputting it
|
||
after results in undesirable whitespace in particular cases; for
|
||
example, in the hg/mercurial docs</span></pre></li><li><p><code class="literal">Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</code></p><pre class="screen"><span class="commit-message">renamed from title-preamble to pinch.together and replaced "sp -1"
|
||
between <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">synopsis</code></a> fragments with call to pinch.together instead</span></pre></li><li><p><code class="literal">Michael(tm) Smith: table.xsl</code></p><pre class="screen"><span class="commit-message">use title-preamble template for <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> titles (instead of "sp -1"
|
||
hack), and "sp 1" after all tables (instead of just "sp"</span></pre></li><li><p><code class="literal">Michael(tm) Smith: utility.xsl</code></p><pre class="screen"><span class="commit-message">created title-preamble template for suppressing line spacing after
|
||
headings</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl</code></p><pre class="screen"><span class="commit-message">fixed typo</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">further refinement of indenting in AUTHORS <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a></span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl; other.xsl</code></p><pre class="screen"><span class="commit-message">refined handling of admonitions</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">Use RS/RE in another place where we had IP ""</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">Replace (ab)use of IP with "sp -1" in AUTHORS <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> with RS/RE
|
||
instead.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: table.xsl; synop.xsl; info.xsl</code></p><pre class="screen"><span class="commit-message">changed all instances of ".sp -1n" to ".sp -1"</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">add extra line before SH heads only in non-TTY output</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">Reworked output for admonitions (<a href="http://docbook.org/tdg/en/html/caution.html"><code class="sgmltag-element">caution</code></a>, <a href="http://docbook.org/tdg/en/html/important.html"><code class="sgmltag-element">important</code></a>, note, <a href="http://docbook.org/tdg/en/html/tip.html"><code class="sgmltag-element">tip</code></a>,
|
||
warning). In TTY output, admonitions now get indented. In non-TTY
|
||
output, a colored marker (yellow) is displayed next to them.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">Added BM/EM macros for putting a colored marker in margin next to
|
||
a block of text.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: utility.xsl</code></p><pre class="screen"><span class="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</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">put .br before <a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a> contents to prevent them from getting run in</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl</code></p><pre class="screen"><span class="commit-message">made point size of output for <a href="http://docbook.org/tdg/en/html/refsect2.html"><code class="sgmltag-element">Refsect2</code></a> and <a href="http://docbook.org/tdg/en/html/refsect3.html"><code class="sgmltag-element">Refsect3</code></a> heads bigger</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">put slightly more space between SH head and underline in non-TTY
|
||
output</span></pre></li><li><p><code class="literal">Michael(tm) Smith: param.xweb; param.ent; other.xsl</code></p><pre class="screen"><span class="commit-message">Added the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.english.html"><em class="parameter"><code>man.charmap.subset.profile.english</code></em></a> 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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.use.subset.html"><em class="parameter"><code>man.charmap.use.subset</code></em></a> 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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a>
|
||
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 <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> 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
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.english.html"><em class="parameter"><code>man.charmap.subset.profile.english</code></em></a> parameter is used instead of
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a>.
|
||
|
||
The difference between the two subsets is that
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a> provides mappings for characters in
|
||
Western European languages that are not part of the Roman
|
||
(English) alphabet (ASCII character set).</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">Various updates, mainly related to uppercasing SH titles:
|
||
|
||
- added a "Language: " metadata line to the top comment <a href="http://docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a> 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
|
||
<a href="http://docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a> 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 <a href="http://docbook.org/tdg/en/html/tr.html"><code class="sgmltag-element">tr</code></a> 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</span></pre></li><li><p><code class="literal">Michael(tm) Smith: utility.xsl</code></p><pre class="screen"><span class="commit-message">removed some leftover kruft</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">To create the name(s) for each man page, we now replace any spaces
|
||
in the <a href="http://docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a>(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).</span></pre></li><li><p><code class="literal">Michael(tm) Smith: docbook.xsl</code></p><pre class="screen"><span class="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.)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">refined mechanism for generating SH titles</span></pre></li><li><p><code class="literal">Michael(tm) Smith: charmap.groff.xsl</code></p><pre class="screen"><span class="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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl; utility.xsl</code></p><pre class="screen"><span class="commit-message">corrected a regression I introduced about a <a href="http://docbook.org/tdg/en/html/year.html"><code class="sgmltag-element">year</code></a> ago that caused
|
||
dots to be output just as "\." -- instead needs to be "\&." (which
|
||
is what it will be now, after this change)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: info.xsl</code></p><pre class="screen"><span class="commit-message">use make.subheading template to make subheadings for AUTHORS and
|
||
<a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">COPYRIGHT</code></a> sections (instead of harcoding roff markup)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: block.xsl</code></p><pre class="screen"><span class="commit-message">put code font around <a href="http://docbook.org/tdg/en/html/programlisting.html"><code class="sgmltag-element">programlisting</code></a> etc.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl; docbook.xsl</code></p><pre class="screen"><span class="commit-message">embed custom macro definitions in man pages, plus wrap <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">synopsis</code></a> in
|
||
code font</span></pre></li><li><p><code class="literal">Michael(tm) Smith: endnotes.xsl</code></p><pre class="screen"><span class="commit-message">use the make.subheading template to generated SH subheading for
|
||
endnotes <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="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...</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl; utility.xsl</code></p><pre class="screen"><span class="commit-message">Initial checkin of some changes related to making PS/PDF output
|
||
from "man -l -Tps" look better. The current changes:
|
||
|
||
- render <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">synopsis</code></a> and verbatim sections in a monospace/code font
|
||
|
||
- put a light-grey background behind all <a href="http://docbook.org/tdg/en/html/programlisting.html"><code class="sgmltag-element">programlisting</code></a>, <a href="http://docbook.org/tdg/en/html/screen.html"><code class="sgmltag-element">screen</code></a>,
|
||
and <a href="http://docbook.org/tdg/en/html/literallayout.html"><code class="sgmltag-element">literallayout</code></a> 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/<a href="http://docbook.org/tdg/en/html/screen.html"><code class="sgmltag-element">screen</code></a> (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</span></pre></li><li><p><code class="literal">Robert Stayton: refentry.xsl</code></p><pre class="screen"><span class="commit-message"><a href="http://docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a> nodes now get apply-templates instead of just normalize-space().</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">Fixed <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/alignment.html"><em class="parameter"><code>alignment</code></em></a> of first lined of text for each <a href="http://docbook.org/tdg/en/html/listitem.html"><code class="sgmltag-element">listitem</code></a> in
|
||
<a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a> output for TTY. Existing code seemed to have been
|
||
causing an extra undesirable space to appear.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: lists.xsl</code></p><pre class="screen"><span class="commit-message">Wrapped some roff conditionals around roff markup for <a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>
|
||
and <a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a> output, so that the lists look acceptable in PS
|
||
output as well as TTY.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent</code></p><pre class="screen"><span class="commit-message">Added the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.funcsynopsis.style.html"><em class="parameter"><code>man.funcsynopsis.style</code></em></a> parameter. Has the same effect in
|
||
manpages output as the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/funcsynopsis.style.html"><em class="parameter"><code>funcsynopsis.style</code></em></a> parameter has in HTML
|
||
output -- except that its default value is 'ansi' instead of 'kr'.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl</code></p><pre class="screen"><span class="commit-message">Reworked handling of K&R <a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> 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 <a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>
|
||
output in an indented list following the prototype.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: synop.xsl</code></p><pre class="screen"><span class="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) <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/funcsynopsis.style.html"><em class="parameter"><code>funcsynopsis.style</code></em></a>
|
||
parameter. Note that because the mechanism does currently rely on
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/funcsynopsis.style.html"><em class="parameter"><code>funcsynopsis.style</code></em></a>, 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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.funcsynopsis.style.html"><em class="parameter"><code>man.funcsynopsis.style</code></em></a> and make the default for that
|
||
ANSI (to preserve the existing default behavior).</span></pre></li><li><p><code class="literal">Michael(tm) Smith: docbook.xsl</code></p><pre class="screen"><span class="commit-message">added manpages/pi.xsl file</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .cvsignore; pi.xsl</code></p><pre class="screen"><span class="commit-message">Added "dbman funcsynopsis-style" PI and incorporated it into the
|
||
doc build.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.xsl</code></p><pre class="screen"><span class="commit-message">Fixed regression that caused an unescaped dash to be output
|
||
between <a href="http://docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> and <a href="http://docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a> content. Closes bug #1894244.
|
||
Thanks to Daniel Leidert.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: other.xsl</code></p><pre class="screen"><span class="commit-message">Fixed problem with dots being escaped in filenames of generated
|
||
man files. Closes #1827195. Thanks to Daniel Leidert.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: inline.xsl</code></p><pre class="screen"><span class="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.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Epub"></a>Epub</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">epub</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb</code></p><pre class="screen"><span class="commit-message">'Realbook' spec now passes</span></pre></li><li><p><code class="literal">Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb; bin/spec/epub_r⋯</code></p><pre class="screen"><span class="commit-message">Very primitive Windows support for dbtoepub <a href="http://docbook.org/tdg/en/html/reference.html"><code class="sgmltag-element">reference</code></a> implementation; README for running tests and for the .epub target in general; shorter realbook test document (still fails for now)</span></pre></li><li><p><code class="literal">Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯</code></p><pre class="screen"><span class="commit-message">Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same</span></pre></li><li><p><code class="literal">Keith Fahlgren: docbook.xsl</code></p><pre class="screen"><span class="commit-message">Fixing linking to <a href="http://docbook.org/tdg/en/html/cover.html"><code class="sgmltag-element">cover</code></a> @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)</span></pre></li><li><p><code class="literal">Keith Fahlgren: docbook.xsl</code></p><pre class="screen"><span class="commit-message">Updating the <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> of the <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> element in the guide to be more explicit (thanks to Martin Goerner)</span></pre></li><li><p><code class="literal">Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/examples/amasque_⋯</code></p><pre class="screen"><span class="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
|
||
and Keith Fahlgren of O'Reilly.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_HTMLHelp"></a>HTMLHelp</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">htmlhelp</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Mauritz Jeanson: htmlhelp-common.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a>=1 suppress chunk <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> messages also for help
|
||
support files (which seems to be what one would expect). See bug #1648360.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Eclipse"></a>Eclipse</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">eclipse</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .cvsignore; .gitignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">David Cramer: eclipse.xsl</code></p><pre class="screen"><span class="commit-message">Use sortas attributes (if they exist) when sorting indexterms</span></pre></li><li><p><code class="literal">David Cramer: eclipse.xsl</code></p><pre class="screen"><span class="commit-message">Added support for <a href="http://docbook.org/tdg/en/html/indexterm.html"><code class="sgmltag-element">indexterm</code></a>/see in eclipse index.xml</span></pre></li><li><p><code class="literal">Mauritz Jeanson: eclipse.xsl</code></p><pre class="screen"><span class="commit-message">Added <xsl:with-param name="quiet" select="$chunk.quietly"/>
|
||
to helpidx template.</span></pre></li><li><p><code class="literal">David Cramer: eclipse.xsl</code></p><pre class="screen"><span class="commit-message">Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and <a href="http://docbook.org/tdg/en/html/seealso.html"><code class="sgmltag-element">seealso</code></a>.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: eclipse.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a>=1 suppress chunk <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> messages also for help
|
||
support files (which seems to be what one would expect). See bug #1648360.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_JavaHelp"></a>JavaHelp</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">javahelp</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Mauritz Jeanson: javahelp.xsl</code></p><pre class="screen"><span class="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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a>=1 suppress chunk <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> messages also for help
|
||
support files (which seems to be what one would expect). See bug #1648360.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Roundtrip"></a>Roundtrip</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">roundtrip</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</code></p><pre class="screen"><span class="commit-message">fix <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>/cell borders for wordml, fix formal <a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>, add emphasis-strong</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Mauritz Jeanson: supported.xml</code></p><pre class="screen"><span class="commit-message">Changed @cols to 5.</span></pre></li><li><p><code class="literal">Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</code></p><pre class="screen"><span class="commit-message">added <a href="http://docbook.org/tdg/en/html/pubdate.html"><code class="sgmltag-element">pubdate</code></a>, fixed metadata handling in <a href="http://docbook.org/tdg/en/html/biblioentry.html"><code class="sgmltag-element">biblioentry</code></a></span></pre></li><li><p><code class="literal">Steve Ball: supported.xml</code></p><pre class="screen"><span class="commit-message">Added support for <a href="http://docbook.org/tdg/en/html/edition.html"><code class="sgmltag-element">edition</code></a>.</span></pre></li><li><p><code class="literal">Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl; pages-normalise⋯</code></p><pre class="screen"><span class="commit-message">Removed stylesheets for old, deprecated conversion method.</span></pre></li><li><p><code class="literal">Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl; blocks2dbk.dtd⋯</code></p><pre class="screen"><span class="commit-message">Added support for Open Office, added <a href="http://docbook.org/tdg/en/html/edition.html"><code class="sgmltag-element">edition</code></a> element, improved list and <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> support in Word and Pages</span></pre></li><li><p><code class="literal">Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl; template-pages.xml; templ⋯</code></p><pre class="screen"><span class="commit-message">Fixed bug in WordML <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> handling, improved table handling for Pages 08, synchronised WordML and Pages templates.</span></pre></li><li><p><code class="literal">Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl; dbk2wp.xsl</code></p><pre class="screen"><span class="commit-message">fix <a href="http://docbook.org/tdg/en/html/caption.html"><code class="sgmltag-element">caption</code></a>, attributes</span></pre></li><li><p><code class="literal">Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl; blocks2dbk.dtd; temp⋯</code></p><pre class="screen"><span class="commit-message">Fixes to <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> and list handling</span></pre></li><li><p><code class="literal">Steve Ball: blocks2dbk.xsl</code></p><pre class="screen"><span class="commit-message">added support for explicit <a href="http://docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">emphasis</code></a> character styles</span></pre></li><li><p><code class="literal">Steve Ball: wordml2normalise.xsl</code></p><pre class="screen"><span class="commit-message">added support for customisation in image handling</span></pre></li><li><p><code class="literal">Steve Ball: blocks2dbk.xsl</code></p><pre class="screen"><span class="commit-message">Added <a href="http://docbook.org/tdg/en/html/inlinemediaobject.html"><code class="sgmltag-element">inlinemediaobject</code></a> support for metadata.</span></pre></li><li><p><code class="literal">Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml; dbk2wordml.xsl; dbk2wp.xsl</code></p><pre class="screen"><span class="commit-message">Added support file. Added style locking. Conversion bug fixes.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Slides"></a>Slides</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">slides</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: xhtml/Makefile; fo/Makefile; html/Makefile</code></p><pre class="screen"><span class="commit-message">More stupid makefile changes for slides</span></pre></li><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Michael(tm) Smith: fo/Makefile; html/Makefile</code></p><pre class="screen"><span class="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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: demo/default/.gitignore; demo/frames1/.gitignore; demo/.gitignore; demo⋯</code></p><pre class="screen"><span class="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: graphics/.gitignore; svg/.cvsignore; keynote/.gitignore; htmlhelp/.cvsi⋯</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Jirka Kosek: html/plain.xsl</code></p><pre class="screen"><span class="commit-message">Added support for showing foil number</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Website"></a>Website</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">website</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/xalan2/.classes/com/⋯</code></p><pre class="screen"><span class="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Params"></a>Params</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">params</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: epub.autolabel.xml</code></p><pre class="screen"><span class="commit-message">New parameter for epub, epub.autolabel</span></pre></li><li><p><code class="literal">Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml; table.cell.border.t⋯</code></p><pre class="screen"><span class="commit-message">Added missing refpurposes and descriptions.</span></pre></li><li><p><code class="literal">Keith Fahlgren: ade.extensions.xml</code></p><pre class="screen"><span class="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
|
||
and Keith Fahlgren of O'Reilly.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml</code></p><pre class="screen"><span class="commit-message">Clarified that <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop1.extensions.html"><em class="parameter"><code>fop1.extensions</code></em></a> is for FOP 0.90 and later. Version 1 is not here yet...</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.links.are.underlined.xml; man.endnotes.list.enabled.xml; man.font.l⋯</code></p><pre class="screen"><span class="commit-message">removed <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.are.underlined.html"><em class="parameter"><code>man.links.are.underlined</code></em></a> and added man.font.links. Also,
|
||
changed the default font formatting for links to bold.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.base.url.for.relative.links.xml</code></p><pre class="screen"><span class="commit-message">Added new param man.base.url.for.relative.links .. specifies a
|
||
base URL for relative links (for ulink, @xlink:href, <a href="http://docbook.org/tdg/en/html/imagedata.html"><code class="sgmltag-element">imagedata</code></a>,
|
||
<a href="http://docbook.org/tdg/en/html/audiodata.html"><code class="sgmltag-element">audiodata</code></a>, <a href="http://docbook.org/tdg/en/html/videodata.html"><code class="sgmltag-element">videodata</code></a>) shown in the generated NOTES <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> 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 <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> sources in your DocBook <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>
|
||
source, and you leave man.base.url.for.relative.links unset, the
|
||
relative links will appear "as is" in the NOTES <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> 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
|
||
<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> source. For example:
|
||
|
||
<xsl:param name="man.base.url.for.relative.links"
|
||
>http://www.kernel.org/pub/software/scm/git/docs/</xsl:param></span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.endnotes.list.enabled.xml</code></p><pre class="screen"><span class="commit-message">fixed typo</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.string.subst.map.xml</code></p><pre class="screen"><span class="commit-message">squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
|
||
line of whitespace from being inserted after <a href="http://docbook.org/tdg/en/html/programlisting.html"><code class="sgmltag-element">programlisting</code></a> etc.
|
||
in certain cases)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: refentry.manual.fallback.profile.xml; refentry.source.fallback.profile.⋯</code></p><pre class="screen"><span class="commit-message">don't use refmiscinfo@class=<a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> value as fallback for <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>
|
||
"source" or "manual" metadata fields</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su⋯</code></p><pre class="screen"><span class="commit-message">made some further doc tweaks related to the
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.english.html"><em class="parameter"><code>man.charmap.subset.profile.english</code></em></a> param</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.subset.profile.english.xml</code></p><pre class="screen"><span class="commit-message">Fixed some typos.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su⋯</code></p><pre class="screen"><span class="commit-message">Added the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.english.html"><em class="parameter"><code>man.charmap.subset.profile.english</code></em></a> 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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.use.subset.html"><em class="parameter"><code>man.charmap.use.subset</code></em></a> 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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a>
|
||
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 <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> 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
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.english.html"><em class="parameter"><code>man.charmap.subset.profile.english</code></em></a> parameter is used instead of
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a>.
|
||
|
||
The difference between the two subsets is that
|
||
<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a> provides mappings for characters in
|
||
Western European languages that are not part of the Roman
|
||
(English) alphabet (ASCII character set).</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.charmap.subset.profile.xml</code></p><pre class="screen"><span class="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.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: generate.legalnotice.link.xml; generate.revhistory.link.xml</code></p><pre class="screen"><span class="commit-message">Added information on how the <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> is computed.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: default.table.width.xml</code></p><pre class="screen"><span class="commit-message">Clarified PI usage.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: man.funcsynopsis.style.xml</code></p><pre class="screen"><span class="commit-message">Added the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.funcsynopsis.style.html"><em class="parameter"><code>man.funcsynopsis.style</code></em></a> parameter. Has the same effect in
|
||
manpages output as the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/funcsynopsis.style.html"><em class="parameter"><code>funcsynopsis.style</code></em></a> parameter has in HTML
|
||
output -- except that its default value is 'ansi' instead of 'kr'.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: table.table.properties.xml; nominal.table.width.xml</code></p><pre class="screen"><span class="commit-message">Fixed typo.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: funcsynopsis.tabular.threshold.xml</code></p><pre class="screen"><span class="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
|
||
being used in the code and hasn't been since mid 2006.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: table.properties.xml</code></p><pre class="screen"><span class="commit-message">Set keep-together.within-column to "auto". This seems to be the most sensible
|
||
default value for tables.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: informal.object.properties.xml; admon.graphics.extension.xml; informalequ⋯</code></p><pre class="screen"><span class="commit-message">Several small documentation fixes.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: manifest.in.base.dir.xml</code></p><pre class="screen"><span class="commit-message">Wording fixes.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: header.content.properties.xml; footer.content.properties.xml</code></p><pre class="screen"><span class="commit-message">Added <a href="http://docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a>.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml</code></p><pre class="screen"><span class="commit-message">Updated for DocBook 5.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml</code></p><pre class="screen"><span class="commit-message">Spelling and wording fixes.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: callout.graphics.extension.xml</code></p><pre class="screen"><span class="commit-message">Clarifed available graphics formats and extensions.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: footnote.sep.leader.properties.xml</code></p><pre class="screen"><span class="commit-message">Corrected <a href="http://docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a>.</span></pre></li><li><p><code class="literal">Jirka Kosek: footnote.properties.xml</code></p><pre class="screen"><span class="commit-message">Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: img.src.path.xml</code></p><pre class="screen"><span class="commit-message"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a> works with inlinegraphic too.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: saxon.character.representation.xml</code></p><pre class="screen"><span class="commit-message">Added TCG <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: img.src.path.xml</code></p><pre class="screen"><span class="commit-message">Updated description of <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a>. Bug #1785224 revealed that
|
||
there was a risk of misunderstanding how it works.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Profiling"></a>Profiling</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">profiling</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Jirka Kosek: xsl2profile.xsl</code></p><pre class="screen"><span class="commit-message">Added new rules to profile all content generated by HTML Help (including alias files)</span></pre></li><li><p><code class="literal">Robert Stayton: profile-mode.xsl</code></p><pre class="screen"><span class="commit-message">use mode="profile" instead of xsl:copy-of for attributes so
|
||
they can be more easily customized.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Lib"></a>Lib</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">lib</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Tools"></a>Tools</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">tools</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Michael(tm) Smith: xsl/build/.gitignore; xsl/build/.cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Michael(tm) Smith: make/Makefile.DocBook</code></p><pre class="screen"><span class="commit-message">various changes and additions to support making with asciidoc as
|
||
an input format</span></pre></li><li><p><code class="literal">Michael(tm) Smith: make/Makefile.DocBook</code></p><pre class="screen"><span class="commit-message">make dblatex the default PDF maker for the example makefile</span></pre></li><li><p><code class="literal">Michael(tm) Smith: xsl/build/html2roff.xsl</code></p><pre class="screen"><span class="commit-message">Reworked handling of K&R <a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> 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 <a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>
|
||
output in an indented list following the prototype.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: xsl/build/make-xsl-params.xsl</code></p><pre class="screen"><span class="commit-message">Made attribute-sets members of the param list. This enables links to attribute-sets in the
|
||
<a href="http://docbook.org/tdg/en/html/reference.html"><code class="sgmltag-element">reference</code></a> documentation.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: xsl/build/html2roff.xsl</code></p><pre class="screen"><span class="commit-message">use .BI handling in K&R funsynopsis output for manpages, just as
|
||
we do already of ANSI output</span></pre></li><li><p><code class="literal">Michael(tm) Smith: xsl/build/html2roff.xsl</code></p><pre class="screen"><span class="commit-message">Implemented initial support for handling tabular K&R output of
|
||
<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> 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.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: xsl/build/doc-link-docbook.xsl</code></p><pre class="screen"><span class="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.</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Template"></a>Template</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">template</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_Extensions"></a>Extensions</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">extensions</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN</span></pre></li><li><p><code class="literal">Keith Fahlgren: Makefile</code></p><pre class="screen"><span class="commit-message">Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed all .cvsignore files to .gitignore, to facilitate use of git-svn</span></pre></li><li><p><code class="literal">Michael(tm) Smith: Makefile</code></p><pre class="screen"><span class="commit-message">moved extensions build targets from master xsl/Makefile to
|
||
xsl/extensions/Makefile</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .cvsignore</code></p><pre class="screen"><span class="commit-message">ignore stuff</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .cvsignore</code></p><pre class="screen"><span class="commit-message">re-adding empty extensions subdir</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_XSL-Saxon"></a>XSL-Saxon</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">xsl-saxon</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Michael(tm) Smith: VERSION</code></p><pre class="screen"><span class="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
|
||
recent change to snapshot build infrastructure</span></pre></li><li><p><code class="literal">Michael(tm) Smith: .gitignore; .cvsignore</code></p><pre class="screen"><span class="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties</code></p><pre class="screen"><span class="commit-message">Changed hard-coded file references in "clean" target to variable
|
||
references. Closes #1792043. Thanks to Daniel Leidert.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: VERSION; Makefile</code></p><pre class="screen"><span class="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</span></pre></li><li><p><code class="literal">Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test</code></p><pre class="screen"><span class="commit-message">More tweaks to get release-ready</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_XSL-Xalan"></a>XSL-Xalan</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">xsl-xalan</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Michael(tm) Smith: VERSION</code></p><pre class="screen"><span class="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
|
||
recent change to snapshot build infrastructure</span></pre></li><li><p><code class="literal">Michael(tm) Smith: nbproject/.gitignore; .cvsignore; .gitignore; nbproject/.cvsignore</code></p><pre class="screen"><span class="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: nbproject/build-impl.xml</code></p><pre class="screen"><span class="commit-message">Changed hard-coded file references in "clean" target to variable
|
||
references. Closes #1792043. Thanks to Daniel Leidert.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: Makefile; VERSION</code></p><pre class="screen"><span class="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</span></pre></li><li><p><code class="literal">Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION</code></p><pre class="screen"><span class="commit-message">More tweaks to get release-ready</span></pre></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1.74.0_XSL-libxslt"></a>XSL-libxslt</h3></div></div></div><p>The following changes have been made to the
|
||
<code class="filename">xsl-libxslt</code> code
|
||
since the 1.73.2 release.</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">Mauritz Jeanson: python/xslt.py</code></p><pre class="screen"><span class="commit-message">Print the result to stdout if no outfile has been given.
|
||
Some unnecessary semicolons removed.</span></pre></li><li><p><code class="literal">Mauritz Jeanson: python/xslt.py</code></p><pre class="screen"><span class="commit-message">Added a <a href="http://docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a> that quotes parameter values (to ensure that they are interpreted as strings).
|
||
Replaced deprecated functions from the string module with string methods.</span></pre></li><li><p><code class="literal">Michael(tm) Smith: python/.gitignore; python/.cvsignore</code></p><pre class="screen"><span class="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</span></pre></li><li><p><code class="literal">Michael(tm) Smith: python/README; python/README.LIBXSLT</code></p><pre class="screen"><span class="commit-message">renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT</span></pre></li><li><p><code class="literal">Mauritz Jeanson: python/README</code></p><pre class="screen"><span class="commit-message">Tweaked the text a little.</span></pre></li></ul></div></div></div></div></body></html>
|
||
|