From 1285f06a7baac9a55ec481924517e1b4ec65b573 Mon Sep 17 00:00:00 2001
From: Roger Sheen <roger@infotexture.net>
Date: Sat, 13 Dec 2025 23:11:57 +0100
Subject: [PATCH 1/4] Add passthrough action for importance attribute

This will allow us to mark deprecated parameters and extension points
per https://github.com/dita-ot/docs/issues/648#issuecomment-3649715352

Signed-off-by: Roger Sheen <roger@infotexture.net>
---
 resources/html.ditaval | 1 +
 resources/pdf.ditaval  | 1 +
 resources/site.ditaval | 1 +
 3 files changed, 3 insertions(+)

diff --git a/resources/html.ditaval b/resources/html.ditaval
index d6c511351..834cc486f 100644
--- a/resources/html.ditaval
+++ b/resources/html.ditaval
@@ -3,4 +3,5 @@
 <val>
   <prop action="include" att="deliveryTarget" val="html"/>
   <prop action="exclude" att="deliveryTarget" val="pdf"/>
+  <prop action="passthrough" att="importance"/>
 </val>
diff --git a/resources/pdf.ditaval b/resources/pdf.ditaval
index 82a036248..372b0a019 100644
--- a/resources/pdf.ditaval
+++ b/resources/pdf.ditaval
@@ -3,4 +3,5 @@
 <val>
   <prop action="exclude" att="deliveryTarget" val="html"/>
   <prop action="include" att="deliveryTarget" val="pdf"/>
+  <prop action="passthrough" att="importance"/>
 </val>
diff --git a/resources/site.ditaval b/resources/site.ditaval
index b620aa17d..5a0db8256 100644
--- a/resources/site.ditaval
+++ b/resources/site.ditaval
@@ -3,5 +3,6 @@
 <val>
   <prop action="include" att="deliveryTarget" val="html"/>
   <prop action="exclude" att="deliveryTarget" val="pdf"/>
+  <prop action="passthrough" att="importance"/>
   <prop action="passthrough" att="platform"/>
 </val>

From 2ce12b9da38f50eaf5dc8193a532fb17e2eebad4 Mon Sep 17 00:00:00 2001
From: Roger Sheen <roger@infotexture.net>
Date: Thu, 1 Jan 2026 14:17:03 +0100
Subject: [PATCH 2/4] Mark deprecated elements in HTML output

Signed-off-by: Roger Sheen <roger@infotexture.net>
---
 resources/dita-ot-doc.css | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/resources/dita-ot-doc.css b/resources/dita-ot-doc.css
index 6e1ae32e8..c2d91668b 100644
--- a/resources/dita-ot-doc.css
+++ b/resources/dita-ot-doc.css
@@ -789,6 +789,24 @@ pre code {
   font-size: 0.8125rem;
 }
 
+/* Mark deprecated elements */
+
+[data-importance='deprecated'],
+[data-importance='deprecated'] + dd,
+[data-importance='deprecated'] .parmname {
+  color: var(--code-color);
+}
+
+dt[data-importance='deprecated'] .parmname::after {
+  border-radius: 0.25rem;
+  content: 'DEPRECATED';
+  font-size: 75%;
+  margin-left: 0.5em;
+  padding: 0.25em 0.4em;
+  background-color: var(--code-color);
+  color: var(--secondary-bg);
+}
+
 /****************************************
 Headings
 ****************************************/

From 6d16edacf1d2c0e44920f9d8684f0f5ba4beebb8 Mon Sep 17 00:00:00 2001
From: Roger Sheen <roger@infotexture.net>
Date: Thu, 1 Jan 2026 14:24:36 +0100
Subject: [PATCH 3/4] Simplify and align deprecation references

Signed-off-by: Roger Sheen <roger@infotexture.net>
---
 parameters/ant-parameters-details.dita | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/parameters/ant-parameters-details.dita b/parameters/ant-parameters-details.dita
index 1badd09de..a16395d70 100644
--- a/parameters/ant-parameters-details.dita
+++ b/parameters/ant-parameters-details.dita
@@ -223,8 +223,7 @@
             </pt>
             <pd conaction="mark" conref="parameters-base.dita#base/dita.input.valfile.desc"/>
             <pd conaction="pushafter">
-              <note type="notice">This parameter is deprecated in favor of the <parmname>args.filter</parmname>
-                parameter.</note>
+              <note type="notice">This parameter is deprecated; use <parmname>args.filter</parmname> instead.</note>
             </pd>
           </plentry>
           <plentry id="filter-stage">
@@ -522,8 +521,7 @@
             <pd conaction="pushafter">
               <div id="args.hide.parent.link.details">
                 <ph audience="xslt-customizer">Corresponds to the XSLT parameter <parmname>NOPARENTLINK</parmname>.</ph>
-                <note type="notice">This parameter is deprecated in favor of the <parmname>args.rellinks</parmname>
-                  parameter.</note>
+                <note type="notice">This parameter is deprecated; use <parmname>args.rellinks</parmname> instead.</note>
               </div></pd>
           </plentry>
           <plentry id="args.outext">
@@ -747,9 +745,10 @@
             </pt>
             <pd conaction="mark" conref="parameters-pdf.dita#pdf/publish.required.cleanup.desc"/>
             <pd conaction="pushafter">The default value is the value of the <parmname>args.draft</parmname> parameter.
-                <ph audience="xslt-customizer">Corresponds to the XSLT parameter
-                  <parmname>publishRequiredCleanup</parmname>.</ph><note type="notice">This parameter is deprecated in
-                favor of the <parmname>args.draft</parmname> parameter.</note></pd>
+              <ph audience="xslt-customizer">Corresponds to the XSLT parameter
+                  <parmname>publishRequiredCleanup</parmname>.</ph>
+              <note type="notice">This parameter is deprecated; use
+                  <parmname>args.draft</parmname> instead.</note></pd>
           </plentry>
         </parml>
       </section>

From 306e5defd2285fcfd1fe26f7682efd2f0d28be9b Mon Sep 17 00:00:00 2001
From: Roger Sheen <roger@infotexture.net>
Date: Thu, 1 Jan 2026 14:34:52 +0100
Subject: [PATCH 4/4] Push deprecation details to `outputFile.base` #648

Signed-off-by: Roger Sheen <roger@infotexture.net>
---
 parameters/ant-parameters-details.dita | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/parameters/ant-parameters-details.dita b/parameters/ant-parameters-details.dita
index a16395d70..271868ac0 100644
--- a/parameters/ant-parameters-details.dita
+++ b/parameters/ant-parameters-details.dita
@@ -711,15 +711,21 @@
                 <xref keyref="jelovirt-on-pdf2-i18n"/>.</note>
             </pd>
           </plentry>
-          <plentry id="outputFile.base">
+          <plentry id="outputFile.base" importance="deprecated">
             <pt>
               <parmname>outputFile.base</parmname>
+              <ph>
+                <indexterm>deprecated features
+                  <indexterm><parmname>outputFile.base</parmname></indexterm></indexterm></ph>
             </pt>
             <pd conaction="mark" conref="parameters-pdf.dita#pdf/outputFile.base.desc"/>
             <pd conaction="pushafter">By default, the PDF file uses the base filename of the input
                 <filepath>.ditamap</filepath> file.
               <indexterm>DITA maps
-                <indexterm>PDF file name</indexterm></indexterm></pd>
+                <indexterm>PDF file name</indexterm></indexterm>
+              <note type="notice">This parameter is deprecated since DITA-OT 3.0; use
+                <parmname>args.output.base</parmname> instead.</note>
+            </pd>
           </plentry>
           <plentry id="pdf.formatter">
             <pt>