NEWS.html #1

  • //
  • guest/
  • paul_allen/
  • p4convert-maven/
  • docs/
  • docbook-xsl-ns-1.78.1/
  • NEWS.html
  • View
  • Commits
  • Open Download .zip Download (13 KB)
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Changes since the 1.78.0 release</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="description" content="Note: This document lists changes only since the 1.78.0 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 &gt; ChangeHistory.xml"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article"><div class="titlepage"><div><div><h2 class="title"><a name="idp12912"></a>Changes since the 1.78.0 release</h2></div><div><div class="abstract"><p><span class="strong"><strong>Note:</strong></span> This
            document lists changes only since the 1.78.0 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 &gt; ChangeHistory.xml</code></pre></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="#V1.78.1">Release Notes: 1.78.1</a></span></dt><dd><dl><dt><span class="sect2"><a href="#V1.78.1_Common">Common</a></span></dt><dt><span class="sect2"><a href="#V1.78.1_FO">FO</a></span></dt><dt><span class="sect2"><a href="#V1.78.1_HTML">HTML</a></span></dt><dt><span class="sect2"><a href="#V1.78.1_Manpages">Manpages</a></span></dt><dt><span class="sect2"><a href="#V1.78.1_Webhelp">Webhelp</a></span></dt><dt><span class="sect2"><a href="#V1.78.1_Params">Params</a></span></dt><dt><span class="sect2"><a href="#V1.78.1_Highlighting">Highlighting</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1.78.1"></a>Release Notes: 1.78.1</h2></div></div></div><p>The following is a list of changes that have been made
        since the 1.78.0 release.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_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.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">Robert Stayton: titles.xsl</code></p><pre class="screen"><span class="commit-message">Make sure part and set <a href="http://docbook.org/tdg5/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> are used in mode="titleabbrev.markup"</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: titles.xsl</code></p><pre class="screen"><span class="commit-message">Add empty default template for <a href="http://docbook.org/tdg5/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> since it is always processed in a mode.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: gentext.xsl</code></p><pre class="screen"><span class="commit-message">Make consistent handling of <a href="http://docbook.org/tdg5/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> in xrefs.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: titles.xsl</code></p><pre class="screen"><span class="commit-message">for missing <a href="http://docbook.org/tdg5/en/html/title.html"><code class="sgmltag-element">title</code></a> in <a href="http://docbook.org/tdg5/en/html/xref.html"><code class="sgmltag-element">xref</code></a>, provide parent information of target to help locate problem element.
Process <a href="http://docbook.org/tdg5/en/html/bridgehead.html"><code class="sgmltag-element">bridgehead</code></a> in mode="title.markup", not normal mode.</span></pre></li><li class="listitem"><p><code class="literal">Jirka Kosek: l10n.xsl</code></p><pre class="screen"><span class="commit-message">Fixed bug #3598963</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: gentext.xsl; labels.xsl</code></p><pre class="screen"><span class="commit-message">Make sure bridgeheads are not numbered in all contexts, including html <a href="http://docbook.org/tdg5/en/html/title.html"><code class="sgmltag-element">title</code></a> attributes.</span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_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.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">Robert Stayton: division.xsl</code></p><pre class="screen"><span class="commit-message">Fix bug where part <a href="http://docbook.org/tdg5/en/html/toc.html"><code class="sgmltag-element">TOC</code></a> not generated when <a href="http://docbook.org/tdg5/en/html/partintro.html"><code class="sgmltag-element">partintro</code></a> is present.</span></pre></li><li class="listitem"><p><code class="literal">Jirka Kosek: xref.xsl</code></p><pre class="screen"><span class="commit-message">Footnotes can't be placed into fo:float</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: titlepage.templates.xml</code></p><pre class="screen"><span class="commit-message">Remove margin-left when start-indent is used because they interfere
with each other.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: fo.xsl; pagesetup.xsl</code></p><pre class="screen"><span class="commit-message">Use dingbat.fontset rather than <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/dingbat.font.family.html"><em class="parameter"><code>dingbat.font.family</code></em></a> so it falls
back to <a href="http://docbook.org/tdg5/en/html/symbol.html"><code class="sgmltag-element">symbol</code></a> font if glyph not found, like other font properties.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: inline.xsl</code></p><pre class="screen"><span class="commit-message">Change last instance of inline.charseq in inline <a href="http://docbook.org/tdg5/en/html/glossterm.html"><code class="sgmltag-element">glossterm</code></a> to 
inline.italicseq so it is consistent with the others.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: xref.xsl</code></p><pre class="screen"><span class="commit-message">Make consistent handling of <a href="http://docbook.org/tdg5/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> in xrefs.</span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_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.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">Robert Stayton: admon.xsl</code></p><pre class="screen"><span class="commit-message">Turn off $admon.style if $make.clean.html is set to non-zero.</span></pre></li><li class="listitem"><p><code class="literal">Jirka Kosek: highlight.xsl</code></p><pre class="screen"><span class="commit-message">Added new definitions for syntax highlighting</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: chunk-common.xsl</code></p><pre class="screen"><span class="commit-message">Make active.olink.hrefs param work for chunked output too.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: xref.xsl</code></p><pre class="screen"><span class="commit-message">Make consistent handling of <a href="http://docbook.org/tdg5/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> in xrefs.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: graphics.xsl</code></p><pre class="screen"><span class="commit-message">Add round() <a href="http://docbook.org/tdg5/en/html/function.html"><code class="sgmltag-element">function</code></a> when pixel counts are used for image width and height.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: glossary.xsl</code></p><pre class="screen"><span class="commit-message">fix missing class and id attributes on <a href="http://docbook.org/tdg5/en/html/glossterm.html"><code class="sgmltag-element">glossterm</code></a> and <a href="http://docbook.org/tdg5/en/html/glossdef.html"><code class="sgmltag-element">glossdef</code></a>.</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: autoidx.xsl</code></p><pre class="screen"><span class="commit-message">Fix bug where prefer.index.titleabbrev ignored <a href="http://docbook.org/tdg5/en/html/info.html"><code class="sgmltag-element">info</code></a>/<a href="http://docbook.org/tdg5/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a>.</span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_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.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">Robert Stayton: utility.xsl</code></p><pre class="screen"><span class="commit-message">Fix bug 3599520: spurious newline in <a href="http://docbook.org/tdg5/en/html/para.html"><code class="sgmltag-element">para</code></a> when starts with
whitespace and inline element.</span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_Webhelp"></a>Webhelp</h3></div></div></div><p>The following changes have been made to the
            <code class="filename">webhelp</code> code
            since the 1.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">David Cramer: xsl/webhelp-common.xsl</code></p><pre class="screen"><span class="commit-message">Webhelp: Fix test for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/webhelp.include.search.tab.html"><em class="parameter"><code>webhelp.include.search.tab</code></em></a> param</span></pre></li><li class="listitem"><p><code class="literal">David Cramer: Makefile.sample</code></p><pre class="screen"><span class="commit-message">Webhelp: Fix order of args to xsltproc</span></pre></li><li class="listitem"><p><code class="literal">David Cramer: docsrc/readme.xml</code></p><pre class="screen"><span class="commit-message">Webhelp: Turn on xinclude-test.xml in readme to demo xinclude functionality</span></pre></li><li class="listitem"><p><code class="literal">David Cramer: Makefile; Makefile.sample</code></p><pre class="screen"><span class="commit-message">Webhelp: In Makefiles, do xinclude in first pass at document</span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_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.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">David Cramer: webhelp.include.search.tab.xml</code></p><pre class="screen"><span class="commit-message">Webhelp: Fix test for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/webhelp.include.search.tab.html"><em class="parameter"><code>webhelp.include.search.tab</code></em></a> param</span></pre></li><li class="listitem"><p><code class="literal">Robert Stayton: article.appendix.title.properties.xml</code></p><pre class="screen"><span class="commit-message">Remove unneeded margin-left property from <a href="http://docbook.org/tdg5/en/html/article.html"><code class="sgmltag-element">article</code></a> <a href="http://docbook.org/tdg5/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> <a href="http://docbook.org/tdg5/en/html/title.html"><code class="sgmltag-element">title</code></a>.
It interferes with the start-indent property.</span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="V1.78.1_Highlighting"></a>Highlighting</h3></div></div></div><p>The following changes have been made to the
            <code class="filename">highlighting</code> code
            since the 1.78.0 release.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="literal">Jirka Kosek: c-hl.xml; cpp-hl.xml; sql2003-hl.xml; php-hl.xml; upc-hl.xml; bourne-hl.xml; &#8943;</code></p><pre class="screen"><span class="commit-message">Added new definitions for syntax highlighting</span></pre></li></ul></div></div></div></div></body></html>

# Change User Description Committed
#1 13895 Paul Allen Copying using p4convert-docbook
//guest/perforce_software/doc_build/main/docbook-xsl-ns-1.78.1/NEWS.html
#1 12728 eedwards Upgrade ANT doc build infrastructure to assemble PDFs:

- remove non-namespaced DocBook source and add
  namespaced DocBook source.

- add Apache FOP 1.1

- copy fonts, images, XSL into _build, establishing new
  asset structure. The original structure remains until
  all guides using it can be upgraded, and several other
  issues can be resolved.

- updated build.xml to allow for per-target build properties.

- upgraded the P4SAG to use the new infrastructure.

- tweaked admonition presentation in PDFs to remove
  admonition graphics, and resemble closely the
  presentation used in the new HTML layout, including
  the same colors.

With these changes, building PDFs involves using a
shell, navigating into the guide's directory (just P4SAG
for now), and executing "ant pdf".

Issues still to be resolved:

- PDF generation encounters several warnings about
  missing fonts (bold versions of Symbol and ZapfDingbats),
  and a couple of locations where the page content
  exceeds the defined content area.

- Due to issues within Apache FOP, PDF generation emits
  a substantial amount of output that is not easily suppressed
  without losing important warning information.

- Apache FOP's interface to ANT does not expose a way
  to set the font base directory. The current configuration does
  work under Mac OSX, but further testing on Windows will
  need to be done to determine if the relative paths defined
  continue to work. The workaround is for Windows users to
  customize the fop-config.xml to provide absolute system
  paths to the required fonts.

- HTML generation needs further browser testing, and
  exhibits broken navigation on iOS browsers within the
  TOC sidebar.

- A number of PDF and HTML presentation tweaks still
  need to be made, for example: sidebars, gui* DocBook
  tags, whitespace, section separation, etc.