Skip to content

Commit 070c86b

Browse files
committed
Add entries for recently resolved issues in 4.4
Signed-off-by: Roger Sheen <roger@infotexture.net>
1 parent b39fa9b commit 070c86b

3 files changed

Lines changed: 61 additions & 9 deletions

File tree

reference/dita-v2-0-support.dita

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -268,6 +268,27 @@
268268
these new elements.
269269
<xref href="https://github.com/dita-ot/dita-ot/issues/4734" format="html" scope="external">#4734</xref>
270270
</p></li>
271+
<li>
272+
<p id="4744">DITA 2.0 grammar files have been updated to the latest draft versions from OASIS (as of <keyword
273+
keyref="draft-dita-grammar-state"
274+
/>). This update removes the <xmlelement>state</xmlelement> and
275+
<xmlelement>unknown</xmlelement> elements from the base grammar, changes the new
276+
<xmlatt>outputclass</xmlatt> attribute in DITAVAL to <xmlatt>add-outputclass</xmlatt>, and modifies how
277+
default values are set for <xmlatt>title-role</xmlatt> in the Alternative Titles RNG module, for improved
278+
editing experience.
279+
<xref href="https://github.com/dita-ot/dita-ot/issues/4744" format="html" scope="external">#4744</xref>
280+
</p>
281+
<p>In the technical content grammar, several elements have been removed from the Glossary Entry module:
282+
<ul>
283+
<li><xmlelement>glossAbbreviation</xmlelement></li>
284+
<li><xmlelement>glossAlternateFor</xmlelement></li>
285+
<li><xmlelement>glossPartOfSpeech</xmlelement></li>
286+
<li><xmlelement>glossProperty</xmlelement></li>
287+
<li><xmlelement>glossScopeNote</xmlelement></li>
288+
<li><xmlelement>glossShortForm</xmlelement></li>
289+
<li><xmlelement>glossStatus</xmlelement></li>
290+
</ul>
291+
</p></li>
271292
</ul>
272293
</section>
273294
<section>

release-notes/index.dita

Lines changed: 39 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
</titlealts>
99

1010
<abstract>
11-
<shortdesc>DITA Open Toolkit <keyword keyref="release"/> includes <ph conref="#v4.4/summary"/>.</shortdesc>
11+
<shortdesc>DITA Open Toolkit <keyword keyref="release"/> provides <ph conref="#v4.4/summary"/>.</shortdesc>
1212
<p conkeyref="conref-task/semver-info"/>
1313
<note type="tip"><ph conkeyref="conref-task/download-ot"/></note>
1414
</abstract>
@@ -38,10 +38,10 @@
3838
</prolog>
3939
<refbody>
4040
<section>
41-
<p>DITA Open Toolkit Release <keyword keyref="release"/> includes <ph id="summary">support for additional
42-
features in the upcoming DITA 2.0 standard, including the <xmlelement>keytext</xmlelement> and
43-
<xmlelement>linktitle</xmlelement> elements, new class attributes for <xmlelement>navtitle</xmlelement>,
44-
and new chunking code</ph>.</p>
41+
<p>DITA Open Toolkit Release <keyword keyref="release"/> provides
42+
<ph id="summary">a new JSON log option and support for additional features in the upcoming DITA 2.0 standard,
43+
including the <xmlelement>keytext</xmlelement> and <xmlelement>linktitle</xmlelement> elements, new class
44+
attributes for <xmlelement>navtitle</xmlelement>, and new chunking code</ph>.</p>
4545
</section>
4646

4747
<!-- https://github.com/dita-ot/dita-ot/issues?q=milestone%3ANext%20is%3Aclosed%20label%3Afeature%20sort%3Acreated-asc -->
@@ -50,16 +50,25 @@
5050
<title><b outputclass="badge badge-primary">Preview</b> DITA 2.0 updates</title>
5151
<p>In addition to the
5252
<xref keyref="dita-v2-0-support"/> provided in DITA-OT 3.5 – 4.3, this release includes updated processing for
53-
the latest draft versions of the DITA 2.0 grammar files from OASIS (as of <keyword
54-
keyref="draft-dita-grammar-state"
55-
/>).</p>
53+
the latest draft versions of the DITA 2.0 grammar files from OASIS.</p>
5654
<ul conkeyref="dita-v2-0-support/added-in-4.4">
5755
<li/>
5856
</ul>
5957
<p conkeyref="dita-v2-0-support/grammar-files"/>
6058
<note conkeyref="dita-v2-0-support/more-to-come"/>
6159
</section>
6260

61+
<section id="4581">
62+
<title>JSON logging</title>
63+
<p>A new <parmname>--logger=json</parmname> option enables structured JSON log output for easier log processing
64+
and analysis.
65+
<xref href="https://github.com/dita-ot/dita-ot/issues/4581" format="html" scope="external">#4581</xref>
66+
</p>
67+
<p>When logging to standard output, each line is a separate JSON object. When logging to a file, the output is
68+
formatted as a JSON array. This structured format simplifies integration with log aggregation tools and
69+
automated build pipelines that need to parse DITA-OT output programmatically.</p>
70+
</section>
71+
6372
<section id="4716">
6473
<title>URI dependency tracking</title>
6574
<p>A new directed graph data structure has been added to track dependencies between resources identified by URI.
@@ -69,6 +78,9 @@
6978
tracking between files and topics. The new <codeph>Graph</codeph> and <codeph>UriGraph</codeph> classes enable
7079
DITA-OT to model and traverse relationships between resources, which will support future enhancements to
7180
content processing and validation.</p>
81+
<p id="4685">A generic rose tree data structure has also been added to replace earlier ad hoc implementations.
82+
<xref href="https://github.com/dita-ot/dita-ot/issues/4685" format="html" scope="external">#4685</xref>
83+
</p>
7284
</section>
7385

7486
<section id="enhancements">
@@ -120,6 +132,16 @@
120132
</li>
121133
<li>Several bundled dependencies have been upgraded to the latest versions:
122134
<ul>
135+
<li>Gradle has been updated to version 9.3.
136+
<xref href="https://github.com/dita-ot/dita-ot/issues/4727" format="html" scope="external">#4727</xref>,
137+
<xref href="https://github.com/dita-ot/dita-ot/issues/4740" format="html" scope="external">#4740</xref>
138+
</li>
139+
<li>JUnit has been updated to version 6.0.2.
140+
<xref href="https://github.com/dita-ot/dita-ot/issues/4740" format="html" scope="external">#4740</xref>
141+
</li>
142+
<li>Logback core has been updated to 1.5.19 to address a security vulnerability.
143+
<xref href="https://github.com/dita-ot/dita-ot/issues/4743" format="html" scope="external">#4743</xref>
144+
</li>
123145
<li>Saxon has been updated to version 12.9, which includes minor bug fixes.
124146
<xref href="https://github.com/dita-ot/dita-ot/issues/4712" format="html" scope="external">#4712</xref>,
125147
<xref href="https://github.com/dita-ot/dita-ot/issues/4739" format="html" scope="external">#4739</xref>
@@ -235,6 +257,15 @@
235257
modify section title color along with other headings and text.
236258
<xref href="https://github.com/dita-ot/dita-ot/issues/4731" format="html" scope="external">#4731</xref>
237259
</li>
260+
<li id="4732">The PDF2 parameter <parmname>outputFile.base</parmname> has been marked as deprecated. (Use
261+
<parmname>args.output.base</parmname> instead.)
262+
<xref href="https://github.com/dita-ot/dita-ot/issues/4732" format="html" scope="external">#4732</xref>,
263+
<xref
264+
href="https://github.com/dita-ot/docs/issues/648"
265+
format="html"
266+
scope="external"
267+
>dita-ot/docs#648</xref>
268+
</li>
238269
<li id="4733">A stale reference to the deprecated <parmname>args.logdir</parmname> parameter has been removed
239270
from test code. This parameter was deprecated in DITA-OT 2.5 and removed in 3.4.
240271
<xref href="https://github.com/dita-ot/dita-ot/issues/4733" format="html" scope="external">#4733</xref>

resources/key-definitions.ditamap

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@
3535
<keydef keys="draft-dita-grammar-state">
3636
<topicmeta>
3737
<keywords>
38-
<keyword>January 22, 2024</keyword>
38+
<keyword>January 25, 2026</keyword>
3939
</keywords>
4040
</topicmeta>
4141
</keydef>

0 commit comments

Comments
 (0)