Diff for DITA-OT Release 1.6

Fri, 2012-03-16 13:11 by robanderWed, 2012-06-27 14:47 by robander

Update for 1.6 final release

Changes to Body
Line 6Line 6
 
</p>
 
</p>
 
<p>
 
<p>
-
DITA-OT 1.6 will be a new major release based on version 1.2 of the DITA
+
DITA-OT 1.6 is a new major release based on version 1.2 of the DITA
-
Standard. The 1.6 release will take place as a series of 3 week iterations,
+
Standard. The 1.6 release will took place as a series of development iterations,
-
with each iteration ending in a Milestone build available for testing.
+
with each iteration ending in a Milestone build available for testing.The final 1.6 biuld was released June 27, 2012.
 
</p>
 
</p>
 
<p>
 
<p>
-
Test builds of DITA-OT 1.6 may be downloaded here: <a href="https://sourceforge.net/projects/dita-ot/files/DITA-OT%20Latest%20Test%20Build/" target="_blank">DITA-OT Latest Test Build</a>. Not sure which distribution package to download? See <a rel="nofollow" href="/freelinking/DITA-OT%2520Packages" class="freelinking">DITA-OT
+
The final build of DITA-OT 1.6 may be downloaded here: <a href="https://sourceforge.net/projects/dita-ot/files/DITA-OT%20Stable%20Release/DITA%20Open%20Toolkit%201.6/" target="_blank">DITA-OT Latest Stable Build</a>. Not sure which distribution package to download? See <a rel="nofollow" href="/freelinking/DITA-OT%2520Packages" class="freelinking">DITA-OT
 
Packages</a>.
 
Packages</a>.
 
</p>
 
</p>
Line 19Line 19
 
<li>Milestone 1 was released February 10, 2012.</li>
 
<li>Milestone 1 was released February 10, 2012.</li>
 
<li>Milestone 2 was released March 2, 2012.</li>
 
<li>Milestone 2 was released March 2, 2012.</li>
-
<li>Milestone 3 will be released on approximately March 23, 2012.</li>
+
<li>Milestone 3 was released on March 24, 2012.</li>
-
<li>Milestone 4 will be released on approximately April 20, 2012.</li>
+
<li>Milestone 4 was released on May 8, 2012.</li>
-
<li>Milestone 5 will be released on approximately May 11, 2012.</li>
+
<li>Milestone 5 was released on June 5, 2012.</li>
-
<li>Milestone 6 will be released on approximately June 1, 2012.</li>
+
<li>The final build of DITA-OT 1.6 was released on June 27, 2012.</li>
-
<li>The final build of DITA-OT 1.6 will be released on approximately June 22, 2012.</li>
+
 
</ul>
 
</ul>
-
<br />
+
<h2>Release highlights</h2>
-
<h2>Fixes, patches, and enhancements in 1.6</h2>
+
<h3>Performance improvements</h3>
 
<p>
 
<p>
-
The sections below contain a cumulative list of fixes, patches, and
+
DITA-OT 1.6 contains
-
enhancements in the 1.6 release. In order to prevent this page from
+
several updates that combine for significant performance improvements
-
being flagged as spam, individual items do not link directly to
+
for large documents. For example, building the DITA 1.2 Language Specification
-
SourceForge reports. Each item is followed by a note to indicate which
+
to XHTML takes just over 1/3 of the time as with the previous release
-
test build first contained the update.
+
(tests show an improvement of 288%).
  +
</p>
  +
<h3>Error message overhaul</h3>
  +
<p>
  +
In the recent DITA-OT
  +
usage survey, we asked for specific problems encountered when running
  +
the DITA-OT. The most frequent response was difficulty understanding
  +
and responding to error messages. The latest release addresses this
  +
in two ways:
  +
</p>
  +
<ol class="ol">
  +
<li class="li">Every message has been reviewed, and nearly every message has
  +
been revised for clarification.</li>
  +
<li class="li">Messages are now documented in the DITA-OT User Guide. The new
  +
documentation contains additional details about nearly every message,
  +
including potential remedies and links to helpful information.</li>
  +
</ol>
  +
<h3>Code cleanup</h3>
  +
<p>
  +
Of particular interest to developers,
  +
much of the deprecated code in the toolkit (some of it unused for
  +
5+ years) has been removed. As a result, much of the code is cleaner,
  +
faster, and easier to customize. For example, the cleanup of PDF code
  +
allowed us to remove the alternate *_1.0.xsl stylesheets.
  +
</p>
  +
<h2>All fixes, patches, and enhancements in 1.6 <br />
  +
</h2>
  +
<p>
  +
A complete list of fixes, patches, and new features in the 1.6 release can be found at the GitHub issues page used to track development: <a href="https://github.com/dita-ot/dita-ot/issues?milestone=1&amp;state=closed" target="_blank">Details of each update in release 1.6</a>
  +
</p>
  +
<p>
  +
To jump directly to the release notes, which contains a list of updates and additional information on backwards compatibility with previous releases, check the documentation under <a href="http://dita-ot.sourceforge.net/1.6/userguide.html" target="_blank">User Guide &gt; Release notes</a>.
 
</p>
 
</p>
-
<h3>Major Enhancements from the RFE tracker <a rel="nofollow" href="http://sourceforge.net/tracker/?group_id=132728&amp;atid=725077" target="_blank">http://sourceforge.net/tracker/?group_id=132728&amp;atid=725077</a></h3>
  
-
<ul>
  
-
<li class="li">3453816 Deprecate logException and add logError(String, Throwable) (milestone 1)</li>
  
-
<li class="li">3458065 PDF2 should fully support core default language (milestone 1)</li>
  
-
<li class="li">3455512 Add switch to ignore links in XHTML (milestone 1)</li>
  
-
<li class="li">3468355 Refactor log messages and tasks (milestone 1)</li>
  
-
<li class="li">3466533 Reduce topic merge memory consumption (milestone 1)</li>
  
-
<li class="li">3483326 Remove IBM (beta) DITA and BookMap demo support from PDF2 (milestone 1)</li>
  
-
<li class="li">3486110 Move OT version number to configuration (milestone 2)</li>
  
-
<li class="li">3475296 Remove obsolete dita-preprocess target (milestone 2)</li>
  
-
</ul>
  
-
<h3>Patches <a href="http://sourceforge.net/tracker/?group_id=132728&amp;atid=725076" title="http://sourceforge.net/tracker/?group_id=132728&amp;atid=725076">http://sourceforge.net/tracker/?group_id=132728&amp;atid=725076</a></h3>
  
-
<ul>
  
-
<li>3470331 Map references with root fragment are not processed (milestone 1)</li>
  
-
<li>3475092 Key-based mapref results in preprocessing error (milestone 1)</li>
  
-
</ul>
  
-
<h3>Bug fixes <a href="http://sourceforge.net/tracker/?group_id=132728&amp;atid=725074" title="http://sourceforge.net/tracker/?group_id=132728&amp;atid=725074">http://sourceforge.net/tracker/?group_id=132728&amp;atid=725074</a></h3>
  
-
<ul>
  
-
<li class="li">3463319 Temp dir with non-ASCII character crashes (milestone 1)</li>
  
-
<li class="li">3462389 v 1.5.4 fails to create PDF with external topic ref (milestone 1)</li>
  
-
<li class="li">3477641 [1.5.4]Glosslist no longer visible in Bookmarks (PDF output) (milestone 1)</li>
  
-
<li class="li">3465136 Incorrect image reference does not checked (milestone 1)</li>
  
-
<li class="li">3455589 Deprecated property breaks Plus plugins (milestone 1)</li>
  
-
<li class="li">3471937 Info message about inline flagging not displayed (milestone 1)</li>
  
-
<li class="li">3469425 NullPointerException when absolute path to image (milestone 1)</li>
  
-
<li class="li">3470580 PDF2 image references broken with uplevels (milestone 1)</li>
  
-
<li class="li">3468070 1.5.4 looks for lib dir at current dir instead a ${dita.dir} (milestone 1)</li>
  
-
<li class="li">3468073 Apache FOP: TOCs with uneven right margin (milestone 1)</li>
  
-
<li class="li">3476659 Possible collision in File Extension detection mechanism (milestone 1)</li>
  
-
<li class="li">3475092 Key-based mapref results in preprocessing error (milestone 1)</li>
  
-
<li class="li">3487705 Choicetable headings not localized in PDF (milestone 2)</li>
  
-
<li class="li">3487785 Check all places where output streams are used in dost.jar (milestone 2)</li>
  
-
<li class="li">3488458 Property noCoderef not declared (milestone 2)</li>
  
-
<li class="li">3477022 HTML handling of *div does not generate @outputclass (milestone 2)</li>
  
-
<li class="li">3484972 Stylesheet imported multiple times in the hierarchy (milestone 2)</li>
  
-
<li class="li">3485626 Warning when using @copy-to in reltable (milestone 2)</li>
  
-
<li class="li">3451621 Revisions on &amp;lt;plentry&gt; use wrong image for nested &amp;lt;pd&gt;<br />
  
-
(milestone 2)</li>
  
-
<li class="li">3447732 Bug in handling of longdescref (milestone 2)</li>
  
-
<li class="li">3426920 Image files not copied or referenced correctly for eclipse (milestone 2)</li>
  
-
</ul>
  
 
 
Current revision:

DITA-OT Release 1.6

DITA Open Toolkit Version 1.6

Note: while the DITA Standard itself is owned and developed by OASIS, the DITA Open Toolkit is an independent, open source implementation of the standard. 

DITA-OT 1.6 is a new major release based on version 1.2 of the DITA Standard. The 1.6 release will took place as a series of development iterations, with each iteration ending in a Milestone build available for testing.The final 1.6 biuld was released June 27, 2012.

The final build of DITA-OT 1.6 may be downloaded here: DITA-OT Latest Stable Build. Not sure which distribution package to download? See DITA-OT Packages.

Release dates

  • Milestone 1 was released February 10, 2012.
  • Milestone 2 was released March 2, 2012.
  • Milestone 3 was released on March 24, 2012.
  • Milestone 4 was released on May 8, 2012.
  • Milestone 5 was released on June 5, 2012.
  • The final build of DITA-OT 1.6 was released on June 27, 2012.

Release highlights

Performance improvements

DITA-OT 1.6 contains several updates that combine for significant performance improvements for large documents. For example, building the DITA 1.2 Language Specification to XHTML takes just over 1/3 of the time as with the previous release (tests show an improvement of 288%).

Error message overhaul

In the recent DITA-OT usage survey, we asked for specific problems encountered when running the DITA-OT. The most frequent response was difficulty understanding and responding to error messages. The latest release addresses this in two ways:

  1. Every message has been reviewed, and nearly every message has been revised for clarification.
  2. Messages are now documented in the DITA-OT User Guide. The new documentation contains additional details about nearly every message, including potential remedies and links to helpful information.

Code cleanup

Of particular interest to developers, much of the deprecated code in the toolkit (some of it unused for 5+ years) has been removed. As a result, much of the code is cleaner, faster, and easier to customize. For example, the cleanup of PDF code allowed us to remove the alternate *_1.0.xsl stylesheets.

All fixes, patches, and enhancements in 1.6

A complete list of fixes, patches, and new features in the 1.6 release can be found at the GitHub issues page used to track development: Details of each update in release 1.6

To jump directly to the release notes, which contains a list of updates and additional information on backwards compatibility with previous releases, check the documentation under User Guide > Release notes.

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I