From a42d789dcde5f44f371cd63242de51524b490e9b Mon Sep 17 00:00:00 2001
From: Matt Benson <mbenson@apache.org>
Date: Fri, 11 Mar 2022 09:46:17 -0600
Subject: [PATCH] @since

---
 manual/Tasks/local.html                                      | 2 +-
 manual/Tasks/pathconvert.html                                | 2 +-
 manual/Tasks/scriptdef.html                                  | 5 +++--
 src/main/org/apache/tools/ant/BuildException.java            | 1 +
 src/main/org/apache/tools/ant/taskdefs/Local.java            | 3 ++-
 src/main/org/apache/tools/ant/taskdefs/PathConvert.java      | 1 +
 .../apache/tools/ant/taskdefs/optional/script/ScriptDef.java | 2 ++
 src/main/org/apache/tools/ant/util/ScriptManager.java        | 1 +
 8 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/manual/Tasks/local.html b/manual/Tasks/local.html
index 2e64ec631..940622a32 100644
--- a/manual/Tasks/local.html
+++ b/manual/Tasks/local.html
@@ -57,7 +57,7 @@ examples section.</p>
 <h4>Name</h4>
 <p>As an alternative to (or in conjunction with) the <code>name</code> attribute, the nested text of
 each of one or more nested <code>&lt;name&gt;</code> elements specifies a property name to declare in
-the local scope.
+the local scope. <em>Since Ant 1.10.13</em></p>
 
 <h3>Examples</h3>
 
diff --git a/manual/Tasks/pathconvert.html b/manual/Tasks/pathconvert.html
index 3be11a6f3..8503ddf4c 100644
--- a/manual/Tasks/pathconvert.html
+++ b/manual/Tasks/pathconvert.html
@@ -71,7 +71,7 @@ nested <a href="../Types/mapper.html"><code>&lt;mapper&gt;</code></a> (<em>since
   <tr>
     <td>dest</td>
     <td>A destination resource into which to write the converted path (Ant interprets this as a
-        <code>File</code> by default).
+        <code>File</code> by default). <em>Since Ant 1.10.13</em>
     </td>
     <td>No, result will be logged if neither <code>@property</code> nor <code>@dest</code> is set</td>
   </tr>
diff --git a/manual/Tasks/scriptdef.html b/manual/Tasks/scriptdef.html
index ba88bd1df..542702096 100644
--- a/manual/Tasks/scriptdef.html
+++ b/manual/Tasks/scriptdef.html
@@ -137,7 +137,8 @@ the <a href="script.html"><code>&lt;script&gt;</code></a> task.</p>
     <td>This attribute controls whether to set variables for all properties, references and targets
       in the running script. If this attribute is <q>false</q>, only the <code>project</code> and
       <code>self</code> variables are set. If this attribute is <q>true</q> all the variables are
-      set.
+      set. <em>Since Ant 1.10.13</em>
+    </td>
     <td>No; default <q>false</q> for backward compatibility</td>
   </tr>
 </table>
@@ -157,7 +158,7 @@ the <a href="script.html"><code>&lt;script&gt;</code></a> task.</p>
   </tr>
   <tr>
     <td>default</td>
-    <td>the default value of the attribute</td>
+    <td>the default value of the attribute <em>Since Ant 1.10.13</em></td>
     <td>No</td>
   </tr>
 </table>
diff --git a/src/main/org/apache/tools/ant/BuildException.java b/src/main/org/apache/tools/ant/BuildException.java
index 996043a63..9104fad54 100644
--- a/src/main/org/apache/tools/ant/BuildException.java
+++ b/src/main/org/apache/tools/ant/BuildException.java
@@ -28,6 +28,7 @@ public class BuildException extends RuntimeException {
      * Get a {@link BuildException} for the specified {@link Throwable}.
      * @param t
      * @return {@link BuildException}
+     * @since Ant 1.10.13
      */
     public static BuildException of(Throwable t) {
         if (t instanceof BuildException) {
diff --git a/src/main/org/apache/tools/ant/taskdefs/Local.java b/src/main/org/apache/tools/ant/taskdefs/Local.java
index 834b3e844..1b6179e5b 100644
--- a/src/main/org/apache/tools/ant/taskdefs/Local.java
+++ b/src/main/org/apache/tools/ant/taskdefs/Local.java
@@ -24,7 +24,6 @@ import java.util.function.Consumer;
 import org.apache.tools.ant.BuildException;
 import org.apache.tools.ant.Task;
 import org.apache.tools.ant.property.LocalProperties;
-import org.apache.tools.ant.util.StringUtils;
 
 /**
  * Task to create local properties in the current scope.
@@ -32,6 +31,7 @@ import org.apache.tools.ant.util.StringUtils;
 public class Local extends Task {
     /**
      * Nested {@code name} element.
+     * @since Ant 1.10.13
      */
     public static class Name implements Consumer<LocalProperties> {
         private String text;
@@ -71,6 +71,7 @@ public class Local extends Task {
     /**
      * Create a nested {@code name} element.
      * @return {@link Name}
+     * @since Ant 1.10.13
      */
     public Name createName() {
         final Name result = new Name();
diff --git a/src/main/org/apache/tools/ant/taskdefs/PathConvert.java b/src/main/org/apache/tools/ant/taskdefs/PathConvert.java
index 81d6b0b74..45b2a6e5b 100644
--- a/src/main/org/apache/tools/ant/taskdefs/PathConvert.java
+++ b/src/main/org/apache/tools/ant/taskdefs/PathConvert.java
@@ -359,6 +359,7 @@ public class PathConvert extends Task {
     /**
      * Set destination resource.
      * @param dest
+     * @since Ant 1.10.13
      */
     public void setDest(Resource dest) {
         if (dest != null) {
diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java b/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java
index da8ea1045..1c21cf206 100644
--- a/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java
+++ b/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java
@@ -137,6 +137,7 @@ public class ScriptDef extends DefBase {
          * Set the default value of this {@link Attribute}.
          *
          * @param defaultValue {@link String}
+         * @since Ant 1.10.13
          */
         public void setDefault(String defaultValue) {
             this.defaultValue = defaultValue;
@@ -147,6 +148,7 @@ public class ScriptDef extends DefBase {
          * unset.
          * 
          * @return {@link String}
+         * @since Ant 1.10.13
          */
         String getDefault() {
             return defaultValue;
diff --git a/src/main/org/apache/tools/ant/util/ScriptManager.java b/src/main/org/apache/tools/ant/util/ScriptManager.java
index be5de8e13..fa3fc0fcd 100644
--- a/src/main/org/apache/tools/ant/util/ScriptManager.java
+++ b/src/main/org/apache/tools/ant/util/ScriptManager.java
@@ -19,6 +19,7 @@ package org.apache.tools.ant.util;
 
 /**
  * Script manager {@code enum}.
+ * @since Ant 1.10.13
  */
 public enum ScriptManager {
     auto, bsf, javax;