DITA Open Toolkit release notes

This document contains the release notes for the 1.5 series of DITA Open Toolkit releases.

DITA Open Toolkit Release 1.5.2

Release 1.5.2 is a maintenance release based on the final version of the DITA 1.2 standard. In addition to tweaks to match late changes in the standard, version 1.5.2 contains many enhancements, user patches, bug fixes, and significant updates to the documentation.

Release 1.5.2 was developed using a series of test builds released to the community every three weeks. Each item in the list below indicates which test build first contained the update. The eighth build was the final build, released as the DITA-OT 1.5.2 final stable build.

[General Enhancements]

  1. Include final version of DITA 1.2 schemas and DTDs
  2. Minor updates to DITA 1.2 support added in earlier releases, to ensure compliance with the final standard
  3. Overhaul of documentation to remove outdated material
  4. Reorganization of doc directory to highlight new and important info

[SourceForge Enhancements Added]

  1. 2797337 Support for ODF output transform (Prototype added in version 1.5.1, updates in each 1.5.2 Milestone, transform complete in Milestone 7)
  2. 3021544 Preserve DITA elements in XHTML class by default (Milestone 1)
  3. 3019853 Create new "textonly" output method for use by any transform (Milestone 1)
  4. 3012392 PDF transformation should allow args.xsl style override (Milestone 1)
  5. 2882123 Add Ant Quick Start Guide to DITA-OT (Updated in each Milestone after 3)
  6. 3086936 Add extension points for TOC output (Eclipse TOC, HTML Help TOC and Project, HTML TOC) (Milestone 6)
  7. 3079610 Add current OT version to log (Milestone 6)
  8. 1520909 HTML Help requires appropriate codepage (Milestone 6)

[SourceForge Patches Added]

  1. 3058008 Refactor chunk module for cleaner code (Milestone 4)
  2. 3067681 Add class to ordered child links (Milestone 5)
  3. 3064412 Integrator fails to escape XML correctly (Milestone 5)
  4. 3062765 Fix unit test file paths to be platform dependent (Milestone 5)
  5. 2949860 PDF build.xml with args for JVM memory and architecture (Milestone 6)
  6. 3077935 Plug-in ignore in Integrator (Milestone 6)
  7. 3065050 Common logging interface (Milestone 6)
  8. 3063318 ChunkModule refactoring (Milestone 6)
  9. 3061100 Define AbstractPipelineInput's function (Milestone 6)

[SourceForge Bugs Fixed]

  1. 2928582 commonTopicProcessing template prolog processing out of order (Milestone 1)
  2. 2823221 version of Xalan-J inconsistent (Milestone 1)
  3. 3023642 Invalid @colname generated in nested table (Milestone 1)
  4. 3016739 Chunking mixes up <link> to topic in reltable (Milestone 1)
  5. 3020314 Chunk output includes index terms in navtitles (Milestone 1)
  6. 3020313 Chunk processor adds <topicref> before <topicmeta> (Milestone 1)
  7. 3031513 Nested table processing in pdf2 (Milestone 2)
  8. 3030317 Filtering doesn't work on @rev or @props attributes (Milestone 2)
  9. 3028650 Replace xs:float with xs:double in Plus plugins (Milestone 2)
  10. 3022847 PDF transform gives Java exceptions for spaces in dir name (Milestone 2)
  11. 3032950 Scale is not correctly computed in XHTML transforms (Milestone 2)
  12. 3033141 dita.xml.properties file not closed after generating (Milestone 2)
  13. 3034445 "CURRENDIR" typo in plus-plugins ( Checked in to CVS during Milestone 3)
  14. 3034489 Remove all occurrences of <xmlcatalog> from plus-plugins ( Checked in to CVS during Milestone 3)
  15. 3035816 When creating .chm, .hhp-file is missing a line-break (Milestone 3)
  16. 3036222 RTF transform not editable with Word 2007 (Milestone 3)
  17. 3036985 Infinite recursivity in replaceString template (Milestone 3)
  18. 3038941 Link with &amp; breaks in abstract (Milestone 3)
  19. 3039017 Comments in PDF plugin files are confusing (Milestone 3)
  20. 3058124 Toolkit Allows Unescaped URLs, doesn't handle escaped ones (Milestone 4)
  21. 3056939 Conref of keyref-based xref results in xref with no href (Milestone 4)
  22. 3052913 Multiple levels of keyref in map not resolved (Milestone 4)
  23. 3052904 Keydef with no href causes hard failure (Milestone 4)
  24. 3052156 Object with data that starts with slash breaks image copying (Milestone 4)
  25. 3044861 Inappropriate warning for resource-only topic to graphic (Milestone 4)
  26. 3042978 @copy-to and @chunk on topichead gives file not found (Milestone 4)
  27. 3016994 The included-domains entity cannot be used in document (Milestone 4)
  28. 2994593 Transformation breaks when DITA Topics contain entity refs (Milestone 4)
  29. 3028894 no support for title in plugin.xml file (Milestone 4)
  30. 3065853 Indent from <title> gets displayed in TOC (PDF) (Milestone 5)
  31. 3065486 CURRENTFILE not aware of DITAEXT (Milestone 5)
  32. 3065422 Wrong filename and filedir parameters for eclipse xsl (Milestone 5)
  33. 3063533 Adjacent words get glued together using DITA to RTF (Milestone 5)
  34. 3062912 Messages extension damages custom message formatting (Milestone 5)
  35. 3059256 Peer links break with missing format or wrong extension (Milestone 5)
  36. 2972393 Need to parameterize maxmemory and VM args for forked JVMs (Milestone 6)
  37. 3060269 Problem displaying French content TOC in CHM output (Milestone 6)
  38. 3038412 zh-CN file for PDF puts English strings in output (partial fix) (Milestone 6)
  39. 3079676 <navtitle> contents included in PDF output (Updated so that <navtitle> in a topic will only appear when the draft parameter is set to 'yes') (Milestone 6)
  40. 3004895 XHTML output for <draft-comment> should use class attribute (Milestone 6)
  41. 2794487 No Easy Way to Override/Extend HTML TOC Navtitle Generation (Milestone 6)
  42. 3088314 Need to clarify many error messages (Milestone 6)
  43. 3095233 Shortdesc metadata missing when using abstract (Milestone 6)
  44. 3081597 conkeyref accepts values in conref style (Milestone 6)
  45. 3081459 fragment generation without plugin fails (Milestone 6)
  46. 3073262 missing terminating quote in bundle version (Milestone 6)
  47. 2832863 <group> elements in catalogs don't work for all editors (Milestone 6)
  48. 3038933 Troff output drops prereq links (Milestone 7)
  49. 3098975 Disable Output Escaping Should Not Be Used (Milestone 7)
  50. 3102827 Allow a way to specify recognized image extensions (Milestone 7)
  51. 3102219 Unexpected character code in Japanese string definition (Milestone 7)
  52. 3101964 Unnecessary XML declaration in HHP and HHC (Milestone 7)
  53. 3095233 Shortdesc metadata missing when using abstract (Milestone 7)
  54. 3097409 PDF should skip empty columns in property tables (Milestone 7)
  55. 3090803 PDF fails when chunk specified and topic appears twice (Milestone 7)
  56. 3102845 Japanese character-set definition (Milestone 7)
  57. 3103488 Update Saxon command line args for IDIOM PDF build.xml (Milestone 7)
  58. 3086552 XMLReader.parse does not correctly receive the XML system ID (Milestone 8)
Note: SourceForge bugs, patches, and RFEs listed above can be found in SourceForge Bugs, Patches, and RFE tracker pages:
  • Bugs tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725074
    
  • Patches tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725076
    
  • RFE tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725077
    

DITA OT Release 1.5.1

Release 1.5.1 is a maintenance release based on Committee Draft 01 of the DITA 1.2 standard. This is the same version of the standard used for the DITA 1.2 Public Review. Release 1.5.1 contains many fixes and minor enhancements. It also includes a preview of a new output transform to the Open Document Format; this transform will be completed in a later release.

Release 1.5.1 was developed using a series of test builds released to the community every three weeks. Each item in the list below indicates which test build first contained the update. There were seven total test builds.

[General Enhancements]

  1. Update to latest copy of DITA 1.2 Draft DTDs and Schemas (last update in Milestone 5)

[14 SourceForge Enhancements Added]

  1. 2797337 Support for ODF output transform (first prototype available in Milestone 2, further updates in each milestone)
  2. 2703335 Reduce duplicated code in XHTML <note> processing (Milestone 3)
  3. 2976463 Provide finer grained control of links in PDF (include reltable and in-topic links, without parent/child links) (Milestone 4)
  4. 2971536 New Java options for existing Ant parameters (Milestone 4)
  5. 2979084 Obey the "args.draft" parameter (Milestone 5)
  6. 2990783 allow caller-provided IndexTermCollection (Milestone 6 contains the core code updates; M7 contains the full enhancement)
  7. 3001750 Shortdesc from map should override link description in PDF (Milestone 7)
  8. 3004305 Notes with type="warning" need styling / localization in XHTML (Milestone 7)
  9. 3004859 "eclipsecontent" transform should drop debug info (Milestone 7)
  10. 2892706 Don't delete the FO file (new option to preserve topic.fo) (Milestone 7)
  11. 2928584 Add general model for end-of-topic processing in PDF (Milestone 7)
  12. 3006675 Support new DITA 1.2 <stepsection> element in PDF (Milestone 7)
  13. 3006847 Add generated task headers to PDF (using the option that works for XHTML in DITA-OT 1.5) (Milestone 7)
  14. 2987769 Add support for Eclipse Help index redirects (Milestone 7)

[2 SourceForge Patches Added]

  1. 2914475 Use Xerces Grammar Pool to Improve Performance (Milestone 1)
  2. 2991688 Refine package build Ant (Milestone 6)

[46 SourceForge Bugs Fixed]

  1. 2916469 @locktitle not respected by preprocessor (Milestone 1)
  2. 2917809 need empty lib/saxon directory for minimum and standard pkg. (Milestone 1)
  3. 2925636 Build fails when excluded section contains a table (Milestone 1)
  4. 2926417 Absolute file: URLs are not resolved. (Milestone 1)
  5. 2930109 Move meta module pushes content into peer topic. (Milestone 1)
  6. 1852808 args.css requires dummy file. (Milestone 1)
  7. 2952956 Imagemap processing drops outputclass from image (Milestone 3)
  8. 2953706 Minor improvements to "garage" samples (Milestone 3)
  9. 2961909 /onlytopicinmap does not respect conref (Milestone 3)
  10. 2957456 conkeyref breaks when topic is in subdir (Milestone 3)
  11. 2962813 stepsection throws off numbering in links to steps (Milestone 3)
  12. 2959588 Template Processor Doesn't handle XSLT atts that require ' (Milestone 3)
  13. 2914574 plus-htmlhelp-alias-map: using same extension point twice (Milestone 3)
  14. 2957938 coderef not working everytime (Milestone 3)
  15. 2962781 html documentation out of date (Milestone 3)
  16. 2952956 refactored XSL code in ut-d.xsl (Milestone 3)
  17. 2954819 NullPointer while processing simple BookMap (Milestone 3)
  18. 2954154 Updated default version from 1.0 to 1.0.0 (Milestone 3)
  19. 2970471 XSLFO test for @compact wrong (Milestone 4 for PDF, Milestone 5 for LegacyPDF)
  20. 2972043 Setting onlytopicinmap causes a blank imagelist (Milestone 4)
  21. 2974667 Integrator adds spaces into XML Catalog entries (Milestone 4)
  22. 2986492 Duplicate parameter in XHTML code (Milestone 5)
  23. 2982485 Cannot read a document that was written during the same transform (Milestone 5)
  24. 2981216 <tm> @tmclass requires IBM-specific values (Milestone 5)
  25. 2979361 Java stack traces in OT log (Milestone 5)
  26. 2979328 Output parameters info at INFO level (Milestone 5)
  27. 2978858 keyref processing doesn't respect basedir (Milestone 5)
  28. 2990162 Conref to elements in same DITA file throw parsing errors (Milestone 6)
  29. 3000677 msgph and systemoutput should use <samp> instead of <tt> (Milestone 7)
  30. 3004220 <tm> elements dropped when keyref text resolved (Milestone 7)
  31. 2987322 Navtitle attribute of glossarylist breaks PDF (Milestone 7)
  32. 2916474 Inappropriate match on mapgroup/topichead in PDF code (Milestone 7)
  33. 2916408 Topichead with <navtitle> not processed same as @navtitle in PDF (Milestone 7)
  34. 3006443 CSS for prereq links indents prereq element (Milestone 7)
  35. 2607892 (Plus Plug-in) plus-allhtml-encoding: map x-windows-950 to Big5 (Milestone 7)
  36. 2385466 Handle @font-family="inherit" (Milestone 7)
  37. 2928540 Shortdesc should align with body in PDF (use topic__shortdesc) (Milestone 7)
  38. 1839827 PDF does not properly process <xref> to <li> elements (Milestone 7)
  39. 2521819 PDF topic title widowed due to fo:marker placed in separate block (Milestone 7)
  40. 1385654 docbook/topic2db.xsl - better linking support (Milestone 7)
  41. 3004550 Conkeyref does not work if key referenced is not in same folder (Milestone 7)
  42. 3004060 keyref/id not producing link in PDF output (Milestone 7)
  43. 3001705 conkeyref doesn't work across ditamaps (Milestone 7)
  44. 3000604 Legacy PDF: empty @column-number causes errors (Milestone 7)
  45. 3013079 Keyref handling does not respect scope="external" (Final build)
  46. 3005748 XHTML: Topics w/ @print set to "printonly" are included (Final build)
Note: SourceForge bugs, patches, and RFEs listed above can be found in SourceForge Bugs, Patches, and RFE tracker pages:
  • Bugs tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725074
    
  • Patches tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725076
    
  • RFE tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725077
    

DITA OT release 1.5

Release 1.5 is a major release based on the new DITA 1.2 draft standard. It contains full support for DITA 1.2 draft as defined in the fall of 2009 (prior to public review).

In addition to DITA 1.2 support, release 1.5 contains the following updates, which are available in Milestone 21 or earlier of the DITA-OT test builds:

[General Enhancements]

  1. New parameter to generate output for only the topics referenced in a map
  2. Use fileparameter in Ant 1.7 to replace processing instruction in intermediate dita files
  3. Determine the version of DITA-OT via the class org.dita.dost.util.Version
  4. Remove duplicate ids in PDF topicmerge
  5. Move Notices before the TOC, suppress in the TOC and suppress the second copy after the TOC
  6. Include @scope="peer" condition when creating rel-links.

[SourceForge Enhancements Added]

  1. 2859612 Add support for Serbian (Latin)
  2. 2845278 Add Ant parameters for XSLT parameters
  3. 2824371 Support Hindi and Urdu for XHTML output
  4. 2790755 Process in unique temp directories (Designed to allow multiple builds to take place at once)
  5. 2780998 startcmd.sh: Run the user's shell, not sh
  6. 2698921 Add a way to set attributes on <body>
  7. 2120219 Add PDF to the supported image
  8. 2002857 homeID in javahelp .hs file is not set
  9. 1725284 add support for headings for sections within task (XHTML only)
  10. 1623246 Support RFC4646 language tags in Index modules
  11. 1367897 Xref content generation enforces formatting choices
  12. 2882109 Convert named PDF templates to mode template
  13. 2883406 Add extension point for modifying PDF link text
  14. 2882870 Add parameter to control PDF Chapter style
  15. 2882103 Provide hook for specializations to add custom headers
  16. 2882072 Add parameter to control PDF bookmarks (default collapsed)

[93 SourceForge Bugs Fixed]

  1. 2860433 Keyref on <image> fails to resolve
  2. 2860199 Chunk to-content in submap resulting in missing output
  3. 2860168 Suppress data and data-about in PDF output
  4. 2857167 conrefImpl.xsl 1.6.4.13 has duplicate variable decls
  5. 2856742 Problem of keys attribute in nested topicref elements
  6. 2854546 Peer xref leads to invalid destination error in PDF
  7. 2849200 Style on ditaval prop or revprop is ignored
  8. 2846111 Unnecessary text generated for external xref
  9. 2845598 1.5-M18-demo/fo/Customization pdf.formatter
  10. 2842753 catalog-dita.xml has invalid entries
  11. 2839035 Chunk code cannot parse xref with &
  12. 2832696 Move meta module pushes content into non-DITA file
  13. 2829350 Build_demo.xml places files in incorrect directory
  14. 2826143 Move meta module discards link text
  15. 2824907 1.5 M17 Bug - FileNotFoundException export.xml eclipsehelp
  16. 2819853 missing nested indexterm after 3rd
  17. 2815492 PDF: keep-with-next on shortdesc
  18. 2815485 Prolog indexterm not processed properly for PDF
  19. 2813082 Eclipse help MANIFEST.MF filename wrong case, needs CRLF
  20. 2811980 pdf2: japanese translate for generated page number of a ref
  21. 2811358 Incorrect entry@colname in middle file at PDF generation
  22. 2804442 Bad param name in prereq-fmt template's call to sect-heading
  23. 2799543 Child links in HTML Help output are wrong
  24. 2797030 Chunking fails with bookmap
  25. 2796614 Leading slash breaks PLUGINS_ROOT usage for Eclipse help
  26. 2791696 reltable DITA 1.2 (#12048)
  27. 2791345 Topicmeta searchtitles in map not used in topic
  28. 2791278 Keyref Resolution Fails for Non-Descendant Topics
  29. 2790807 Demo code should use new PDF output
  30. 2788069 Topicmerge does not handle copy-to properly
  31. 2788069 Topicmerge does not handle copy-to properly
  32. 2782503 Extra space before bullet list in xhtml output DITA-OT 1.4.3
  33. 2774128 startcmd.sh is encoded with DOS line endings in v1.5 M13
  34. 2759964 HTML outputs filters conditional topics poorly
  35. 2759964 HTML outputs filters conditional topics poorly
  36. 2748371 Revision + ID gives XSL error
  37. 2739236 plus-allhtml-svgobject handles <alt> badly
  38. 2724090 XHTML: conreffed by-reference footnotes break w/ chunking
  39. 2723928 gen-toc template not matching properly
  40. 2723715 Itemgroup sets @id when element is not open
  41. 2712074 XHTML: chunk=to-content on map breaks by-reference footnotes
  42. 2706725 Single quote inserted in empty table cells in FO
  43. 2696229 FO plugin code incompatible with Saxon 9 (OT1.4.3 default)
  44. 2696191 Java libraries missing from 1.4.3 distributions
  45. 2647292 HTML stylesheets should style <wintitle> and <filepath>
  46. 2629271 maplink: should not modify href if scope=external
  47. 2629256 mapref: should not modify href if scope=external
  48. 2573681 Move link module does extra processing
  49. 2547437 zh_TW.properties and zh_CN.properties contents are mixed up
  50. 2418932 toc attribute does not work for references to ditamaps
  51. 2317681 Extra files generated when many topics are chunked to one
  52. 2317581 inline formatting in shortdesc
  53. 1931457 Need to identify transtype during XHTML output step
  54. 1629094 docbook creates empty simplelists
  55. 1628936 transtype=docbook does not handle publisher and copyright element
  56. 2849078 Problems using keyrefs with DITA OT 1.5 M19 - ID: 2849078
  57. 2875373 tm in linktext is dropped
  58. 2870935 keyref within topics ignore @copy-to attributes
  59. 2873560 SWF flash not defined as resources to be copied
  60. 2872954 Conref push not working at map level
  61. 2871009 Temp directory leaves behind single directory and file
  62. 2866322 Generated links have bad URLs
  63. 2873654 PDF missing rules for new DITA 1.2 content elements
  64. 2872988 Bad relcolwidth crashes PDF output
  65. 2866204 Topicref with keyref fails to produce output
  66. 2878446 Issue with ampersand in xrefs in attributes
  67. 1629096 docbook creates invalid varlistentry
  68. 2871326 Cannot use different TOC titles for same topic in PDF
  69. 1880097 PDF2 ingnores contents of <xref> elements
  70. 1815571 Invalid property in fo:table-body
  71. 2879171 Shortdesc & Abstract formatting is incorrect for PDF
  72. 2882085 Obsolete code in PDF plug-in should be removed
  73. 2661418 make the TOC in pdf2 output link to topics in pdf
  74. 2871017 eclipsehelp plugin.xml invalid in 1.5M20
  75. 2887331 chunk="to-content" on a sub-map causes path error
  76. 2891736 indexterm in topicref level are copied into topic/prolog
  77. 2893316 This is a bug in the integrator.xml
  78. 2893493 ${clean.temp} is not set to true per documentation
  79. 2893664 ampersand entity with conref actions causes build to fail
  80. 2893924 htmlhelp transtype requires video plugin
  81. 1628937 Rename supportingboth.ditaand.xmlinaditamap.dita
  82. 1771123 Inappropriate Message 018 On type= value
  83. 1819660 Eclipse Help issue producing toc file.
  84. 1848313 ditaval file sent to XSLT not URL
  85. 1897542 Chunk to-content may need to rewrite topic IDs
  86. 2875946 PDF: table @pgwide semantics not implemented
  87. 2893745 missing fop's file/directory in standard package
  88. 2900047 map2htmtoc.xsl doesn't allow for extension of root template
  89. 2900417 html transform does not use image/@scale properly
  90. 2906957 Update Eclipse plugin DTDs and packaging
  91. 2796964 Use xml:lang for generated text in PDF
  92. 2860596 PullPrologIndexTerms selection too wide, Removed spurious pullPrologIndexTerms in section/title
  93. 1852733 Image "scale" attribute is ignored

[4 SourceForge Patches Added]

  1. 2790337 Add extension points to related-links code
  2. 2778178 Flagging code duplicates XSL
  3. 2715750 plus-transtype-htmlhelp: support alternate compilers
  4. 2804311 Feature value trim test bug
Note: SourceForge bugs, patches, and RFEs listed above can be found in SourceForge Bugs, Patches, and RFE tracker pages:
  • Bugs tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725074
            
  • Patches tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725076
            
  • RFE tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725077
            

Older releases

For a list of updates and changes in every release since version 1.0 of the DITA Open Toolkit, see DITA complete release history.