Merge tag '4.3.1' into develop

infotexture · infotexture · commit 1c306773e6a2 · 2025-03-23T15:30:02.000+01:00
DITA-OT 4.3.1

# -----BEGIN PGP SIGNATURE-----
#
# iQIzBAABCAAdFiEE4dwAszXsmTZ/8urXv5ed07nfjisFAmfgGuoACgkQv5ed07nf
# jiuvPQ//YzzkO/NEDqp6Ka2eFOlba2NDTFaH9+GjrYBYyMyX6hRTcVvE6AcE8gUm
# ENC13j+yB1mVLRMHWwef/BwHphDvEOHLrQMyMVQVkNlcwCI7BBRZKhdMTvbJGV3l
# ZR805hiln9j018UT5c0w39XUK/Wxkt/tjSJUk+c78Q7b1H0FO9ehyno3nqm4kGtc
# E54AliiW/XC4ojFdf7rd8BzauxSC2zWFuCbHqI11UbOzHOQQJV0m+m+q9TIZV0EW
# mGqe9w9SWtvehWjQzzvNkqkJZP69RFZiHV9Hg1QjETUKRn70tuBD1yWNt5EwRVsO
# 3ocMy3aglet4ZXtLxaujMOMS1W3Nmu7uM+AQdA2q+Ic6Lf3sgpT9C07v6OzbEgh+
# Qcb20T3aPv5QByb2mUyhPHB6cOQuUTH6lN8KXKANPrX6ClUy0bMqZzulYfUtrVVW
# jaX7506bmsfr6MHilEly3owqljNMmOLiYawFwk9pLaOJs8MaDQ4crPJLT7RYNZIe
# 9Nnm/EPF4/nGqu2XyYH85d6C/2XCM7w1OY7Os907y6wHwa7z7aO161/euAhL4PS2
# ZAOe51EObAHk3Zdq3KcXc2erDADBsVwzDwCynpelhGzVzcxtVCLayOeVZjqNaoyS
# OVTbnFLqQfXTLmIg/XRvjO6husv/mI6qU7Yrarew8pAr0S4G3Ro=
# =U9NX
# -----END PGP SIGNATURE-----
# gpg: Signature made Sun Mar 23 15:30:02 2025 CET
# gpg:                using RSA key E1DC00B335EC99367FF2EAD7BF979DD3B9DF8E2B
# gpg: Good signature from "Roger Sheen &lt;roger@infotexture.net&gt;" [ultimate]

* tag '4.3.1':
  Implement review feedback
  Fix outdated info on default output directory
  Add details on issues resolved in 4.3.1
  Add details on updated dependency versions
  Prepare 4.3.1 Release Notes stub
  Bump Docker image version to ”4.3.1“
  Bump 'maintenance-version' key to “4.3.1”
diff --git a/parameters/ant-parameters-details.dita b/parameters/ant-parameters-details.dita
@@ -304,8 +304,8 @@
             <pd conaction="pushafter">
               <p>This parameter corresponds to the command-line option
                 <xref keyref="dita-command-arguments/output">--output</xref>.</p>
-              <p>By default, the output is written to
-                <filepath><varname>DITA-dir</varname>/out</filepath>.</p></pd>
+              <p>By default, the output is written to the <filepath>out</filepath> subdirectory of the current
+                directory.</p></pd>
           </plentry>
           <plentry id="result.rewrite-rule.class">
             <pt>
diff --git a/release-notes/index.dita b/release-notes/index.dita
@@ -8,7 +8,8 @@
   </titlealts>
 
   <abstract>
-    <shortdesc>DITA Open Toolkit <keyword keyref="release"/> includes <ph conref="#v4.3/summary"/>.</shortdesc>
+    <shortdesc>DITA Open Toolkit <keyword keyref="maintenance-version"/> is a maintenance release that fixes issues
+      reported in DITA-OT <keyword keyref="release"/>, which includes <ph conref="#v4.3/summary"/>.</shortdesc>
     <p conkeyref="conref-task/semver-info"/>
     <note type="tip"><ph conkeyref="conref-task/download-ot"/></note>
   </abstract>
@@ -25,6 +26,82 @@
     </refbody>
   </reference>
 
+  <reference id="v4.3.1" outputclass="mark">
+    <title>DITA-OT <keyword keyref="maintenance-version"/>
+      <!--<ph outputclass="small text-muted">released mmmm D, yyyy</ph>-->
+    </title>
+    <refbody>
+      <section>
+        <p>DITA Open Toolkit <keyword keyref="maintenance-version"/> is a maintenance release that includes the
+          following bug fixes.</p>
+        <ul>
+          <!-- https://github.com/dita-ot/dita-ot/issues?q=milestone%3A4.3.1%20sort%3Acreated-asc -->
+          <li id="4564">DITA-OT 4.2 and later versions produced broken links in the navigation ToC when the
+              <xmlatt>copy-to</xmlatt> attribute was defined on topic references, or the
+              <parmname>force-unique</parmname> option was used. Generated temporary file names were used instead of
+            the <xmlatt>copy-to</xmlatt> attribute value. The <xmlatt>copy-to</xmlatt> attribute value is now respected
+            to ensure the correct links are written to the ToC.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4564" format="html" scope="external">#4564</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4569" format="html" scope="external">#4569</xref>
+          </li>
+          <li id="4589">DITA-OT 4.3 included a regression bug that generated output in the <filepath>out</filepath>
+            subdirectory of the DITA-OT installation directory if the output location was not explicitly specified. In
+            this case, output is now generated in the <filepath>out</filepath> subdirectory of the current directory as
+            in DITA-OT 4.2.4 and earlier versions.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4589" format="html" scope="external">#4589</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4594" format="html" scope="external">#4594</xref>
+          </li>
+          <li id="4590">The new <cmdname>validate</cmdname> subcommand introduced in DITA-OT 4.3 can now also be run by
+            setting the <parmname>-f</parmname> or <parmname>--format</parmname> options to <codeph>validate</codeph>.
+            The <cmdname>dita</cmdname> command line interface has also been updated to prevent conflicts between the
+              <cmdname>validate</cmdname> subcommand and the existing <parmname>validate</parmname> parameter.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4590" format="html" scope="external">#4590</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4592" format="html" scope="external">#4592</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4602" format="html" scope="external">#4602</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4603" format="html" scope="external">#4603</xref>
+          </li>
+          <li id="4593">DITA-OT Docker images can now be built for both 64-bit Linux AMD and ARM architectures. No
+            changes are required to benefit from this enhancement. Docker should automatically select the image that
+            corresponds to the current machine architecture.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4593" format="html" scope="external">#4593</xref>
+          </li>
+          <li id="4596">Earlier versions of DITA-OT generated invalid nested paragraphs in HTML output when the
+            <xmlelement>lines</xmlelement> element was used in a paragraph. Processing has been updated to ensure that
+            lines content is treated as a block element and rendered in separate paragraphs.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4596" format="html" scope="external">#4596</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4599" format="html" scope="external">#4599</xref>
+          </li>
+          <li id="4606">Earlier versions of DITA-OT miscalculated the base directory when publications included
+            resource-only topics that were outside of the root map directory. Resource-only topics are now ignored in
+            this process to ensure that relative paths between resources are generated correctly.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4606" format="html" scope="external">#4606</xref>
+          </li>
+          <li>Several dependencies have been upgraded to include the latest utility versions and fix security issues:
+            <ul>
+              <li id="4595">Ant 1.10.15
+                <xref href="https://github.com/dita-ot/dita-ot/issues/4595" format="html" scope="external">#4595</xref>
+              </li>
+              <li id="4588">Logback 1.5.17
+                <xref href="https://github.com/dita-ot/dita-ot/issues/4588" format="html" scope="external">#4588</xref>
+              </li>
+              <li>Saxon 12.5
+                <xref href="https://github.com/dita-ot/dita-ot/issues/4595" format="html" scope="external">#4595</xref>
+              </li>
+            </ul>
+          </li>
+        </ul>
+        <p>For additional information on the issues resolved since the previous release, see the
+          <xref
+            href="https://github.com/dita-ot/dita-ot/issues?q=milestone%3A4.3.1+is%3Aclosed"
+            format="html"
+            scope="external"
+          >4.3.1 milestone</xref> and
+          <xref href="https://github.com/dita-ot/dita-ot/compare/4.3...4.3.1" format="html" scope="external">
+            changelog</xref> on GitHub.</p>
+      </section>
+    </refbody>
+  </reference>
+
   <reference id="v4.3">
     <title>DITA-OT <keyword keyref="release"/>
       <ph outputclass="small text-muted"> released February 15, 2025</ph>
diff --git a/resources/key-definitions.ditamap b/resources/key-definitions.ditamap
@@ -26,7 +26,7 @@
   <keydef keys="maintenance-version">
     <topicmeta>
       <keywords>
-        <keyword>4.3</keyword>
+        <keyword>4.3.1</keyword>
       </keywords>
     </topicmeta>
   </keydef>
@@ -61,7 +61,7 @@
   <keydef keys="tool.ant.version">
     <topicmeta>
       <keywords>
-        <keyword>1.10.14</keyword>
+        <keyword>1.10.15</keyword>
       </keywords>
     </topicmeta>
   </keydef>
@@ -117,7 +117,7 @@
   <keydef keys="tool.logback.version">
     <topicmeta>
       <keywords>
-        <keyword>1.4.14</keyword>
+        <keyword>1.5.17</keyword>
       </keywords>
     </topicmeta>
   </keydef>
@@ -206,7 +206,7 @@
   <keydef keys="tool.saxon.version">
     <topicmeta>
       <keywords>
-        <keyword>12.4</keyword>
+        <keyword>12.5</keyword>
       </keywords>
     </topicmeta>
   </keydef>
diff --git a/samples/docker/Dockerfile b/samples/docker/Dockerfile
@@ -1,5 +1,5 @@
 # Use the latest DITA-OT image ↓ as parent:
-FROM ghcr.io/dita-ot/dita-ot:4.3
+FROM ghcr.io/dita-ot/dita-ot:4.3.1
 
 # Install a custom plug-in from a remote location:
 RUN dita --install https://github.com/infotexture/dita-bootstrap/archive/master.zip
