You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by jk...@apache.org on 2006/04/21 23:47:11 UTC

svn commit: r396012 - in /ant/core/trunk/src/main/org/apache/tools: ant/ ant/launch/ ant/loader/ ant/taskdefs/ ant/taskdefs/compilers/ ant/taskdefs/optional/ ant/taskdefs/optional/jdepend/ ant/taskdefs/optional/net/ ant/taskdefs/optional/script/ ant/ta...

Author: jkf
Date: Fri Apr 21 14:47:06 2006
New Revision: 396012

URL: http://svn.apache.org/viewcvs?rev=396012&view=rev
Log:
indicated when methods/classes became deprecated, as to give us the possibility to remove deprecated methods in the future.

Modified:
    ant/core/trunk/src/main/org/apache/tools/ant/AntClassLoader.java
    ant/core/trunk/src/main/org/apache/tools/ant/DirectoryScanner.java
    ant/core/trunk/src/main/org/apache/tools/ant/IntrospectionHelper.java
    ant/core/trunk/src/main/org/apache/tools/ant/Main.java
    ant/core/trunk/src/main/org/apache/tools/ant/Project.java
    ant/core/trunk/src/main/org/apache/tools/ant/ProjectComponent.java
    ant/core/trunk/src/main/org/apache/tools/ant/ProjectHelper.java
    ant/core/trunk/src/main/org/apache/tools/ant/RuntimeConfigurable.java
    ant/core/trunk/src/main/org/apache/tools/ant/Task.java
    ant/core/trunk/src/main/org/apache/tools/ant/launch/Launcher.java
    ant/core/trunk/src/main/org/apache/tools/ant/loader/AntClassLoader2.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Available.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Copy.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/DefBase.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Ear.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Exec.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteWatchdog.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/FixCRLF.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jar.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Javadoc.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jikes.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/MacroInstance.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/PathConvert.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Property.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SQLExec.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SendEmail.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tar.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/TaskOutputStream.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Touch.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tstamp.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Unpack.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/War.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Zip.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/compilers/DefaultCompilerAdapter.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/RenameExtensions.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/ReplaceRegExp.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/StyleBook.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/Test.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/TraXLiaison.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/jdepend/JDependTask.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/MimeMail.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java
    ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java
    ant/core/trunk/src/main/org/apache/tools/ant/types/CommandlineJava.java
    ant/core/trunk/src/main/org/apache/tools/ant/types/DataType.java
    ant/core/trunk/src/main/org/apache/tools/ant/types/Reference.java
    ant/core/trunk/src/main/org/apache/tools/ant/util/CollectionUtils.java
    ant/core/trunk/src/main/org/apache/tools/ant/util/FileUtils.java
    ant/core/trunk/src/main/org/apache/tools/ant/util/WeakishReference.java
    ant/core/trunk/src/main/org/apache/tools/ant/util/optional/WeakishReference12.java
    ant/core/trunk/src/main/org/apache/tools/zip/ZipEntry.java

Modified: ant/core/trunk/src/main/org/apache/tools/ant/AntClassLoader.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/AntClassLoader.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/AntClassLoader.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/AntClassLoader.java Fri Apr 21 14:47:06 2006
@@ -550,7 +550,8 @@
      * @param theClass The class to initialize.
      *                 Must not be <code>null</code>.
      *
-     * @deprecated use Class.forName with initialize=true instead.
+     * @deprecated since 1.6.x.
+     *             Use Class.forName with initialize=true instead.
      */
     public static void initializeClass(Class theClass) {
         // ***HACK*** We ask the VM to create an instance

Modified: ant/core/trunk/src/main/org/apache/tools/ant/DirectoryScanner.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/DirectoryScanner.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/DirectoryScanner.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/DirectoryScanner.java Fri Apr 21 14:47:06 2006
@@ -135,8 +135,9 @@
      * that has only been kept around for backwards compatibility
      * reasons.</p>
      *
-     * @deprecated use the {@link #getDefaultExcludes
-     * getDefaultExcludes} method instead.
+     * @deprecated since 1.6.x.
+     *             Use the {@link #getDefaultExcludes getDefaultExcludes} 
+     *             method instead.
      */
     protected static final String[] DEFAULTEXCLUDES = {
         // Miscellaneous typical temporary files

Modified: ant/core/trunk/src/main/org/apache/tools/ant/IntrospectionHelper.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/IntrospectionHelper.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/IntrospectionHelper.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/IntrospectionHelper.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -540,7 +540,8 @@
      *                    Must not be <code>null</code>.
      *
      * @return an instance of the specified element type
-     * @deprecated This is not a namespace aware method.
+     * @deprecated since 1.6.x.
+     *             This is not a namespace aware method.
      *
      * @exception BuildException if no method is available to create the
      *                           element instance, or if the creating method

Modified: ant/core/trunk/src/main/org/apache/tools/ant/Main.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/Main.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/Main.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/Main.java Fri Apr 21 14:47:06 2006
@@ -252,7 +252,7 @@
      * @exception BuildException if the specified build file doesn't exist
      *                           or is a directory.
      *
-     * @deprecated
+     * @deprecated since 1.6.x
      */
     protected Main(String[] args) throws BuildException {
         processArgs(args);
@@ -513,7 +513,7 @@
      * Helper to get the parent file for a given file.
      * <p>
      * Added to simulate File.getParentFile() from JDK 1.2.
-     * @deprecated
+     * @deprecated since 1.6.x
      *
      * @param file   File to find parent of. Must not be <code>null</code>.
      * @return       Parent file or null if none

Modified: ant/core/trunk/src/main/org/apache/tools/ant/Project.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/Project.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/Project.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/Project.java Fri Apr 21 14:47:06 2006
@@ -85,31 +85,36 @@
     /**
      * Version constant for Java 1.0 .
      *
-     * @deprecated Use {@link JavaEnvUtils#JAVA_1_0} instead.
+     * @deprecated since 1.5.x.
+     *             Use {@link JavaEnvUtils#JAVA_1_0} instead.
      */
     public static final String JAVA_1_0 = JavaEnvUtils.JAVA_1_0;
     /**
      * Version constant for Java 1.1 .
      *
-     * @deprecated Use {@link JavaEnvUtils#JAVA_1_1} instead.
+     * @deprecated since 1.5.x.
+     *             Use {@link JavaEnvUtils#JAVA_1_1} instead.
      */
     public static final String JAVA_1_1 = JavaEnvUtils.JAVA_1_1;
     /**
      * Version constant for Java 1.2 .
      *
-     * @deprecated Use {@link JavaEnvUtils#JAVA_1_2} instead.
+     * @deprecated since 1.5.x.
+     *             Use {@link JavaEnvUtils#JAVA_1_2} instead.
      */
     public static final String JAVA_1_2 = JavaEnvUtils.JAVA_1_2;
     /**
      * Version constant for Java 1.3 .
      *
-     * @deprecated Use {@link JavaEnvUtils#JAVA_1_3} instead.
+     * @deprecated since 1.5.x.
+     *             Use {@link JavaEnvUtils#JAVA_1_3} instead.
      */
     public static final String JAVA_1_3 = JavaEnvUtils.JAVA_1_3;
     /**
      * Version constant for Java 1.4 .
      *
-     * @deprecated Use {@link JavaEnvUtils#JAVA_1_4} instead.
+     * @deprecated since 1.5.x.
+     *             Use {@link JavaEnvUtils#JAVA_1_4} instead.
      */
     public static final String JAVA_1_4 = JavaEnvUtils.JAVA_1_4;
 
@@ -189,12 +194,6 @@
     private boolean loggingMessage = false;
 
     /**
-     * Property used to store the java version ant is running in.
-     * @deprecated
-     */
-    public static final String ANT_JAVA_VERSION = MagicNames.ANT_JAVA_VERSION;
-
-    /**
      * Set the input handler.
      *
      * @param handler the InputHandler instance to use for gathering input.
@@ -616,7 +615,8 @@
      *                      May be <code>null</code>, indicating that there is
      *                      no default target.
      *
-     * @deprecated use setDefault
+     * @deprecated since 1.5.x.
+     *             Use setDefault.
      * @see #setDefault(String)
      */
     public void setDefaultTarget(String defaultTarget) {
@@ -694,7 +694,8 @@
      *              Must not be <code>null</code>.
      * @param value The replacement value.
      *              Must not be <code>null</code>.
-     * @deprecated Use getGlobalFilterSet().addFilter(token,value)
+     * @deprecated since 1.4.x.
+     *             Use getGlobalFilterSet().addFilter(token,value)
      *
      * @see #getGlobalFilterSet()
      * @see FilterSet#addFilter(String,String)
@@ -712,7 +713,8 @@
      * @return a hashtable of global filters, mapping tokens to values
      *         (String to String).
      *
-     * @deprecated Use getGlobalFilterSet().getFilterHash()
+     * @deprecated since 1.4.x 
+     *             Use getGlobalFilterSet().getFilterHash().
      *
      * @see #getGlobalFilterSet()
      * @see FilterSet#getFilterHash()
@@ -805,7 +807,8 @@
      * Return the version of Java this class is running under.
      * @return the version of Java as a String, e.g. "1.1" .
      * @see org.apache.tools.ant.util.JavaEnvUtils#getJavaVersion
-     * @deprecated use org.apache.tools.ant.util.JavaEnvUtils instead
+     * @deprecated since 1.5.x.
+     *             Use org.apache.tools.ant.util.JavaEnvUtils instead.
      */
     public static String getJavaVersion() {
         return JavaEnvUtils.getJavaVersion();
@@ -1319,7 +1322,7 @@
      *
      * @return the resolved File.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public File resolveFile(String fileName, File rootDir) {
         return FILE_UTILS.resolveFile(rootDir, fileName);
@@ -1336,6 +1339,9 @@
      *
      * @return the resolved File.
      *
+     * @deprecated since 1.7 
+     *             Use @see {FileUtils#resolveFile FileUtils.resolveFile} 
+     *             instead.
      */
     public File resolveFile(String fileName) {
         return FILE_UTILS.resolveFile(baseDir, fileName);
@@ -1355,7 +1361,8 @@
      * @return the native version of the specified path or
      *         an empty string if the path is <code>null</code> or empty.
      *         
-     * @deprecated use FileUtils.translatePath instead.
+     * @deprecated since 1.7
+     *             Use FileUtils.translatePath instead.
      *
      * @see PathTokenizer
      */
@@ -1374,7 +1381,7 @@
      *
      * @exception IOException if the copying fails.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(String sourceFile, String destFile)
           throws IOException {
@@ -1394,7 +1401,7 @@
      *
      * @exception IOException if the copying fails.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(String sourceFile, String destFile, boolean filtering)
         throws IOException {
@@ -1418,7 +1425,7 @@
      *
      * @exception IOException if the copying fails.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(String sourceFile, String destFile, boolean filtering,
                          boolean overwrite) throws IOException {
@@ -1447,7 +1454,7 @@
      *
      * @exception IOException if the copying fails.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(String sourceFile, String destFile, boolean filtering,
                          boolean overwrite, boolean preserveLastModified)
@@ -1467,7 +1474,7 @@
      *
      * @exception IOException if the copying fails.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(File sourceFile, File destFile) throws IOException {
         FILE_UTILS.copyFile(sourceFile, destFile);
@@ -1486,7 +1493,7 @@
      *
      * @exception IOException if the copying fails.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(File sourceFile, File destFile, boolean filtering)
         throws IOException {
@@ -1510,7 +1517,7 @@
      *
      * @exception IOException if the file cannot be copied.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(File sourceFile, File destFile, boolean filtering,
                          boolean overwrite) throws IOException {
@@ -1539,7 +1546,7 @@
      *
      * @exception IOException if the file cannot be copied.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      */
     public void copyFile(File sourceFile, File destFile, boolean filtering,
                          boolean overwrite, boolean preserveLastModified)
@@ -1557,7 +1564,7 @@
      *
      * @param time the required modification time.
      *
-     * @deprecated
+     * @deprecated since 1.4.x
      *
      * @exception BuildException if the last modified time cannot be set
      *                           despite running on a platform with a version

Modified: ant/core/trunk/src/main/org/apache/tools/ant/ProjectComponent.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/ProjectComponent.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/ProjectComponent.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/ProjectComponent.java Fri Apr 21 14:47:06 2006
@@ -26,9 +26,10 @@
 
     /**
      * Project object of this component.
-     * @deprecated You should not be directly accessing this variable
-     *   directly. You should access project object via the getProject()
-     *   or setProject() accessor/mutators.
+     * @deprecated since 1.6.x. 
+     *             You should not be directly accessing this variable directly. 
+     *             You should access project object via the getProject()
+     *             or setProject() accessor/mutators.
      */
     protected Project project;
 

Modified: ant/core/trunk/src/main/org/apache/tools/ant/ProjectHelper.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/ProjectHelper.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/ProjectHelper.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/ProjectHelper.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -266,7 +266,9 @@
      * JDK1.1 compatible access to the context class loader.
      * Cut&paste from JAXP.
      *
-     * @deprecated Use LoaderUtils.getContextClassLoader()
+     * @deprecated since 1.6.x. 
+     *             Use LoaderUtils.getContextClassLoader()
+     *
      * @return the current context class loader, or <code>null</code>
      * if the context class loader is unavailable.
      */
@@ -290,7 +292,9 @@
      * @param project The project containing the target.
      *                Must not be <code>null</code>.
      *
-     * @deprecated Use IntrospectionHelper for each property
+     * @deprecated since 1.6.x. 
+     *             Use IntrospectionHelper for each property.
+     *
      * @exception BuildException if any of the attributes can't be handled by
      *                           the target
      */
@@ -403,7 +407,8 @@
      * @return the original string with the properties replaced, or
      *         <code>null</code> if the original string is <code>null</code>.
      *
-     * @deprecated Use project.replaceProperties()
+     * @deprecated since 1.6.x.
+     *             Use project.replaceProperties().
      * @since 1.5
      */
      public static String replaceProperties(Project project, String value)
@@ -429,7 +434,8 @@
      *                           <code>}</code>
      * @return the original string with the properties replaced, or
      *         <code>null</code> if the original string is <code>null</code>.
-     * @deprecated Use PropertyHelper
+     * @deprecated since 1.6.x. 
+     *             Use PropertyHelper.
      */
      public static String replaceProperties(Project project, String value,
          Hashtable keys) throws BuildException {
@@ -450,7 +456,8 @@
      * @param propertyRefs List to add property names to.
      *                     Must not be <code>null</code>.
      *
-     * @deprecated Use PropertyHelper
+     * @deprecated since 1.6.x.
+     *             Use PropertyHelper.
      * @exception BuildException if the string contains an opening
      *                           <code>${</code> without a closing
      *                           <code>}</code>

Modified: ant/core/trunk/src/main/org/apache/tools/ant/RuntimeConfigurable.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/RuntimeConfigurable.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/RuntimeConfigurable.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/RuntimeConfigurable.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -58,8 +58,8 @@
     private transient IntrospectionHelper.Creator creator;
 
     /**
-     * @deprecated
      * XML attributes for the element.
+     * @deprecated since 1.6.x
      */
     private transient AttributeList attributes;
 
@@ -148,7 +148,7 @@
     /**
      * Sets the attributes for the wrapped element.
      *
-     * @deprecated
+     * @deprecated since 1.6.x.
      * @param attributes List of attributes defined in the XML for this
      *                   element. May be <code>null</code>.
      */

Modified: ant/core/trunk/src/main/org/apache/tools/ant/Task.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/Task.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/Task.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/Task.java Fri Apr 21 14:47:06 2006
@@ -33,21 +33,24 @@
 public abstract class Task extends ProjectComponent {
     /**
      * Target this task belongs to, if any.
-     * @deprecated You should not be accessing this variable directly.
-     *   Please use the {@link #getOwningTarget()} method.
+     * @deprecated since 1.6.x.
+     *             You should not be accessing this variable directly.
+     *             Please use the {@link #getOwningTarget()} method.
      */
     protected Target target;
 
     /**
      * Description of this task, if any.
-     * @deprecated You should not be accessing this variable directly.
+     * @deprecated since 1.6.x. 
+     *             You should not be accessing this variable directly.
      */
     protected String description;
 
     /**
      * Location within the build file of this task definition.
-     * @deprecated You should not be accessing this variable directly.
-     *   Please use the {@link #getLocation()} method.
+     * @deprecated since 1.6.x. 
+     *             You should not be accessing this variable directly.
+     *             Please use the {@link #getLocation()} method.
      */
     protected Location location = Location.UNKNOWN_LOCATION;
 
@@ -58,24 +61,27 @@
      * isn't terribly descriptive for a task used within
      * another task - the outer task code can probably
      * provide a better one.
-     * @deprecated You should not be accessing this variable directly.
-     *   Please use the {@link #getTaskName()} method.
+     * @deprecated since 1.6.x. 
+     *             You should not be accessing this variable directly.
+     *             Please use the {@link #getTaskName()} method.
      */
     protected String taskName;
 
     /**
      * Type of this task.
      *
-     * @deprecated You should not be accessing this variable directly.
-     *   Please use the {@link #getTaskType()} method.
+     * @deprecated since 1.6.x. 
+     *             You should not be accessing this variable directly.
+     *             Please use the {@link #getTaskType()} method.
      */
     protected String taskType;
 
     /**
      * Wrapper for this object, used to configure it at runtime.
      *
-     * @deprecated You should not be accessing this variable directly.
-     *   Please use the {@link #getWrapper()} method.
+     * @deprecated since 1.6.x. 
+     *             You should not be accessing this variable directly.
+     *             Please use the {@link #getWrapper()} method.
      */
     protected RuntimeConfigurable wrapper;
 

Modified: ant/core/trunk/src/main/org/apache/tools/ant/launch/Launcher.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/launch/Launcher.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/launch/Launcher.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/launch/Launcher.java Fri Apr 21 14:47:06 2006
@@ -39,7 +39,7 @@
     /**
      * The Ant Home (installation) Directory property.
      * {@value}
-     * @deprecated
+     * @deprecated since 1.7
      */
     public static final String ANTHOME_PROPERTY = MagicNames.ANT_HOME;
 

Modified: ant/core/trunk/src/main/org/apache/tools/ant/loader/AntClassLoader2.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/loader/AntClassLoader2.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/loader/AntClassLoader2.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/loader/AntClassLoader2.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2003-2005 The Apache Software Foundation
+ * Copyright  2003-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -20,7 +20,8 @@
 import org.apache.tools.ant.AntClassLoader;
 
 /**
- * @deprecated Just use {@link AntClassLoader} itself.
+ * @deprecated since 1.7 
+ *             Just use {@link AntClassLoader} itself.
  */
 public class AntClassLoader2 extends AntClassLoader {
     public AntClassLoader2() {}

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Available.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Available.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Available.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Available.java Fri Apr 21 14:47:06 2006
@@ -159,7 +159,8 @@
     }
 
     /**
-     * @deprecated setType(String) is deprecated and is replaced with
+     * @deprecated since 1.5.x. 
+     *             setType(String) is deprecated and is replaced with
      *             setType(Available.FileDir) to make Ant's Introspection
      *             mechanism do the work and also to encapsulate operations on
      *             the type in its own class.

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Copy.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Copy.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Copy.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Copy.java Fri Apr 21 14:47:06 2006
@@ -155,7 +155,8 @@
     /**
      * Give the copied files the same last modified time as the original files.
      * @param preserve a boolean string.
-     * @deprecated setPreserveLastModified(String) has been deprecated and
+     * @deprecated since 1.5.x. 
+     *             setPreserveLastModified(String) has been deprecated and
      *             replaced with setPreserveLastModified(boolean) to
      *             consistently let the Introspection mechanism work.
      */

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/DefBase.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/DefBase.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/DefBase.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/DefBase.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2003-2005 The Apache Software Foundation
+ * Copyright  2003-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -37,7 +37,8 @@
     /**
      * @param reverseLoader if true a delegated loader will take precedence over
      *                      the parent
-     * @deprecated stop using this attribute
+     * @deprecated since 1.6.x. 
+     *             stop using this attribute
      * @ant.attribute ignore="true"
      */
     public void setReverseLoader(boolean reverseLoader) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Ear.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Ear.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Ear.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Ear.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2005 The Apache Software Foundation
+ * Copyright  2001-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -49,7 +49,8 @@
     /**
      * Set the destination file.
      * @param earFile the destination file
-     * @deprecated Use setDestFile(destfile) instead
+     * @deprecated since 1.5.x. 
+     *             Use setDestFile(destfile) instead.
      */
     public void setEarfile(File earFile) {
         setDestFile(earFile);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Exec.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Exec.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Exec.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Exec.java Fri Apr 21 14:47:06 2006
@@ -38,7 +38,8 @@
  * dead code by the Ant developers and is unmaintained.  Don't use
  * it.</strong></p>
  *
- * @deprecated delegate to {@link org.apache.tools.ant.taskdefs.Execute Execute}
+ * @deprecated since 1.2. 
+ *             delegate to {@link org.apache.tools.ant.taskdefs.Execute Execute}
  *             instead.
  */
 public class Exec extends Task {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -91,7 +91,8 @@
      * Set the stream to which all output (System.out as well as System.err)
      * will be written.
      * @param out the PrintStream where output should be sent.
-     * @deprecated manage output at the task level.
+     * @deprecated since 1.4.x. 
+     *             manage output at the task level.
      */
     public void setOutput(PrintStream out) {
     }

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteWatchdog.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteWatchdog.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteWatchdog.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/ExecuteWatchdog.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -68,7 +68,8 @@
 
     /**
      * @see #ExecuteWatchdog(long)
-     * @deprecated Use constructor with a long type instead.
+     * @deprecated since 1.5.x. 
+     *             Use constructor with a long type instead.
      * (1.4.x compatibility)
      */
     public ExecuteWatchdog(int timeout) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/FixCRLF.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/FixCRLF.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/FixCRLF.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/FixCRLF.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright 2000-2005 The Apache Software Foundation
+ * Copyright 2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -167,7 +167,8 @@
      * <li>remove: remove all CR characters
      * </ul>
      *
-     * @deprecated use {@link #setEol setEol} instead.
+     * @deprecated since 1.4.x. 
+     *             Use {@link #setEol setEol} instead.
      */
     public void setCr(AddAsisRemove attr) {
         log("DEPRECATED: The cr attribute has been deprecated,",

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jar.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jar.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jar.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jar.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -180,7 +180,8 @@
     /**
      * Set the destination file.
      * @param jarFile the destination file
-     * @deprecated Use setDestFile(File) instead
+     * @deprecated since 1.5.x.
+     *             Use setDestFile(File) instead.
      */
     public void setJarfile(File jarFile) {
         setDestFile(jarFile);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Javadoc.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Javadoc.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Javadoc.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Javadoc.java Fri Apr 21 14:47:06 2006
@@ -819,7 +819,8 @@
      * Set the location of the extensions directories.
      *
      * @param path the string version of the path.
-     * @deprecated Use the {@link #setExtdirs(Path)} version.
+     * @deprecated since 1.5.x.
+     *             Use the {@link #setExtdirs(Path)} version.
      */
     public void setExtdirs(String path) {
         cmd.createArgument().setValue("-extdirs");

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jikes.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jikes.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jikes.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Jikes.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000,2002-2005 The Apache Software Foundation
+ * Copyright  2000,2002-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -34,7 +34,8 @@
  * by the Ant developers and is unmaintained.  Don't use
  * it.</strong></p>
  *
- * @deprecated merged into the class Javac.
+ * @deprecated since 1.2.
+ *             Merged into the class Javac.
  */
 public class Jikes {
 

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000,2002-2005 The Apache Software Foundation
+ * Copyright  2000,2002-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -33,7 +33,8 @@
  * by the Ant developers and is unmaintained.  Don't use
  * it.</strong></p>
  *
- * @deprecated use Jikes' exit value to detect compilation failure.
+ * @deprecated since 1.2. 
+ *             Use Jikes' exit value to detect compilation failure.
  */
 public class JikesOutputParser implements ExecuteStreamHandler {
     protected Task task;

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/MacroInstance.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/MacroInstance.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/MacroInstance.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/MacroInstance.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2003-2005 The Apache Software Foundation
+ * Copyright  2003-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -84,7 +84,7 @@
      * Method present for BC purposes.
      * @param name not used
      * @return nothing
-     * @deprecated
+     * @deprecated since 1.6.x.
      * @throws BuildException always
      */
     public Object createDynamicElement(String name) throws BuildException {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/PathConvert.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/PathConvert.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/PathConvert.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/PathConvert.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2005 The Apache Software Foundation
+ * Copyright  2001-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -209,7 +209,8 @@
      * Set targetos to a platform to one of
      * "windows", "unix", "netware", or "os/2";
      * current platform settings are used by default.
-     * @deprecated use the method taking a TargetOs argument instead.
+     * @deprecated since 1.5.x.
+     *             Use the method taking a TargetOs argument instead.
      * @see #setTargetos(PathConvert.TargetOs)
      */
     public void setTargetos(String target) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Property.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Property.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Property.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Property.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -332,8 +332,9 @@
 
     /**
      * @param userProperty ignored
-     * @deprecated This was never a supported feature and has been
-     * deprecated without replacement
+     * @deprecated since 1.5.x.
+     *             This was never a supported feature and has been 
+     *             deprecated without replacement.
      * @ant.attribute ignore="true"
      */
     public void setUserProperty(boolean userProperty) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SQLExec.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SQLExec.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SQLExec.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SQLExec.java Fri Apr 21 14:47:06 2006
@@ -607,7 +607,8 @@
 
     /**
      * print any results in the statement
-     * @deprecated use {@link #printResults(java.sql.ResultSet, java.io.PrintStream)
+     * @deprecated since 1.6.x.
+     *             Use {@link #printResults(java.sql.ResultSet, java.io.PrintStream)
      *             the two arg version} instead.
      * @param out the place to print results
      * @throws SQLException on SQL problems.

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SendEmail.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SendEmail.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SendEmail.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/SendEmail.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2002,2004 The Apache Software Foundation
+ * Copyright  2000-2002,2004,2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -35,7 +35,8 @@
      * Sets the mailport parameter of this build task.
      * @param value mail port name.
      *
-     * @deprecated Use {@link #setMailport(int)} instead.
+     * @deprecated since 1.5.x.
+     *             Use {@link #setMailport(int)} instead.
      */
     public void setMailport(Integer value) {
         setMailport(value.intValue());

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tar.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tar.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tar.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tar.java Fri Apr 21 14:47:06 2006
@@ -59,27 +59,32 @@
 public class Tar extends MatchingTask {
 
     /**
-     * @deprecated Tar.WARN is deprecated and is replaced with
+     * @deprecated since 1.5.x.
+     *             Tar.WARN is deprecated and is replaced with
      *             Tar.TarLongFileMode.WARN
      */
     public static final String WARN = "warn";
     /**
-     * @deprecated Tar.FAIL is deprecated and is replaced with
+     * @deprecated since 1.5.x.
+     *             Tar.FAIL is deprecated and is replaced with
      *             Tar.TarLongFileMode.FAIL
      */
     public static final String FAIL = "fail";
     /**
-     * @deprecated Tar.TRUNCATE is deprecated and is replaced with
+     * @deprecated since 1.5.x.
+     *             Tar.TRUNCATE is deprecated and is replaced with
      *             Tar.TarLongFileMode.TRUNCATE
      */
     public static final String TRUNCATE = "truncate";
     /**
-     * @deprecated Tar.GNU is deprecated and is replaced with
+     * @deprecated since 1.5.x.
+     *             Tar.GNU is deprecated and is replaced with
      *             Tar.TarLongFileMode.GNU
      */
     public static final String GNU = "gnu";
     /**
-     * @deprecated Tar.OMIT is deprecated and is replaced with
+     * @deprecated since 1.5.x.
+     *             Tar.OMIT is deprecated and is replaced with
      *             Tar.TarLongFileMode.OMIT
      */
     public static final String OMIT = "omit";
@@ -127,7 +132,8 @@
     /**
      * Set is the name/location of where to create the tar file.
      * @param tarFile the location of the tar file.
-     * @deprecated for consistency with other tasks, please use setDestFile()
+     * @deprecated since 1.5.x. 
+     *             For consistency with other tasks, please use setDestFile().
      */
     public void setTarfile(File tarFile) {
         this.tarFile = tarFile;
@@ -163,7 +169,8 @@
      * <li>  omit - paths greater than the maximum are omitted from the archive
      * </ul>
      * @param mode the mode string to handle long files.
-     * @deprecated setLongFile(String) is deprecated and is replaced with
+     * @deprecated since 1.5.x.
+     *             setLongFile(String) is deprecated and is replaced with
      *             setLongFile(Tar.TarLongFileMode) to make Ant's Introspection
      *             mechanism do the work and also to encapsulate operations on
      *             the mode in its own class.
@@ -472,7 +479,8 @@
      * Is the archive up to date in relationship to a list of files.
      * @param files the files to check
      * @return true if the archive is up to date.
-     * @deprecated use the two-arg version instead.
+     * @deprecated since 1.5.x. 
+     *             use the two-arg version instead.
      */
     protected boolean archiveIsUpToDate(String[] files) {
         return archiveIsUpToDate(files, baseDir);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/TaskOutputStream.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/TaskOutputStream.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/TaskOutputStream.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/TaskOutputStream.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000,2002-2005 The Apache Software Foundation
+ * Copyright  2000,2002-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -33,7 +33,8 @@
  * by the Ant developers and is unmaintained.  Don't use
  * it.</strong></p>
  *
- * @deprecated use LogOutputStream instead.
+ * @deprecated since 1.2.x.
+ * Use LogOutputStream instead.
  */
 
 public class TaskOutputStream extends OutputStream {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Touch.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Touch.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Touch.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Touch.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -317,7 +317,7 @@
      * backwards-compatibility only.
      * @param file file to touch
      * @throws BuildException on error
-     * @deprecated
+     * @deprecated since 1.6.x.
      */
     protected void touch(File file) {
         touch(file, getTimestamp());

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tstamp.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tstamp.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tstamp.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Tstamp.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -201,7 +201,8 @@
         /**
          * Set the unit type (using String).
          * @param unit the unit to use.
-         * @deprecated setUnit(String) is deprecated and is replaced with
+         * @deprecated since 1.5.x.
+         *             setUnit(String) is deprecated and is replaced with
          *             setUnit(Tstamp.Unit) to make Ant's
          *             Introspection mechanism do the work and also to
          *             encapsulate operations on the unit in its own

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Unpack.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Unpack.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Unpack.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Unpack.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2002,2004-2005 The Apache Software Foundation
+ * Copyright  2001-2002,2004-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -38,7 +38,8 @@
     protected Resource srcResource;
 
     /**
-     * @deprecated setSrc(String) is deprecated and is replaced with
+     * @deprecated since 1.5.x. 
+     *             setSrc(String) is deprecated and is replaced with
      *             setSrc(File) to make Ant's Introspection
      *             mechanism do the work and also to encapsulate operations on
      *             the type in its own class.
@@ -52,7 +53,8 @@
     }
 
     /**
-     * @deprecated setDest(String) is deprecated and is replaced with
+     * @deprecated since 1.5.x. 
+     *             setDest(String) is deprecated and is replaced with
      *             setDest(File) to make Ant's Introspection
      *             mechanism do the work and also to encapsulate operations on
      *             the type in its own class.

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/War.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/War.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/War.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/War.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -68,7 +68,8 @@
      * <i>Deprecated<i> name of the file to create
      * -use <tt>destfile</tt> instead.
      * @param warFile the destination file
-     * @deprecated Use setDestFile(File) instead
+     * @deprecated since 1.5.x.
+     *             Use setDestFile(File) instead
      * @ant.attribute ignore="true"
      */
     public void setWarfile(File warFile) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Zip.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Zip.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Zip.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/Zip.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -133,7 +133,8 @@
      * This is the name/location of where to
      * create the .zip file.
      * @param zipFile the path of the zipFile
-     * @deprecated Use setDestFile(File) instead.
+     * @deprecated since 1.5.x.
+     *             Use setDestFile(File) instead.
      * @ant.attribute ignore="true"
      */
     public void setZipfile(File zipFile) {
@@ -145,7 +146,8 @@
      * create the file.
      * @param file the path of the zipFile
      * @since Ant 1.5
-     * @deprecated Use setDestFile(File) instead
+     * @deprecated since 1.5.x.
+     *             Use setDestFile(File) instead.
      * @ant.attribute ignore="true"
      */
     public void setFile(File file) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/compilers/DefaultCompilerAdapter.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/compilers/DefaultCompilerAdapter.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/compilers/DefaultCompilerAdapter.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/compilers/DefaultCompilerAdapter.java Fri Apr 21 14:47:06 2006
@@ -514,7 +514,8 @@
     /**
      * Add extdirs to classpath
      * @param classpath the classpath to use
-     * @deprecated use org.apache.tools.ant.types.Path#addExtdirs instead
+     * @deprecated since 1.5.x. 
+     *             Use org.apache.tools.ant.types.Path#addExtdirs instead.
      */
     protected void addExtdirsToClasspath(Path classpath) {
         classpath.addExtdirs(extdirs);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/RenameExtensions.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/RenameExtensions.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/RenameExtensions.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/RenameExtensions.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000,2002,2004-2005 The Apache Software Foundation
+ * Copyright  2000,2002,2004-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -38,7 +38,8 @@
  *
  * @version 1.2
  *
- * @deprecated Use &lt;move&gt; instead
+ * @deprecated since 1.5.x. 
+ *             Use &lt;move&gt; instead
  */
 public class RenameExtensions extends MatchingTask {
 

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/ReplaceRegExp.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/ReplaceRegExp.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/ReplaceRegExp.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/ReplaceRegExp.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2005 The Apache Software Foundation
+ * Copyright  2001-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -209,7 +209,8 @@
      * each line, which is not easy to do when processing the file as a whole.
      * Defaults to <i>false</i>.</td>
      * @param byline the byline attribute as a string
-     * @deprecated - use setByLine(boolean)
+     * @deprecated since 1.6.x. 
+     *             Use setByLine(boolean).
      */
     public void setByLine(String byline) {
         Boolean res = Boolean.valueOf(byline);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/StyleBook.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/StyleBook.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/StyleBook.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/StyleBook.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2002,2004-2005 The Apache Software Foundation
+ * Copyright  2000-2002,2004-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -29,7 +29,8 @@
  * and options are available. Do not set any apart from the <tt>classpath</tt>
  * as they are not guaranteed to be there in future.
  * @todo stop extending from Java.
- * @deprecated This task is considered unsupported by the Ant developers
+ * @deprecated since 1.7. 
+ *             This task is considered unsupported by the Ant developers
  */
 public class StyleBook extends Java {
     protected File m_targetDirectory;

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/Test.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/Test.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/Test.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/Test.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000,2002-2005 The Apache Software Foundation
+ * Copyright  2000,2002-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -24,8 +24,9 @@
  * This is a primitive task to execute a unit test in the
  * org.apache.testlet framework.
  *
- * @deprecated testlet has been abandoned in favor of JUnit by the
- * Avalon community
+ * @deprecated since 1.5.x. 
+ *             Testlet has been abandoned in favor of JUnit by the
+ * Avalon community.
  *
  * @ant.task ignore="true"
  */

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/TraXLiaison.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/TraXLiaison.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/TraXLiaison.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/TraXLiaison.java Fri Apr 21 14:47:06 2006
@@ -432,7 +432,8 @@
     /**
      * @param file the filename to use for the systemid
      * @return the systemid
-     * @deprecated use org.apache.tools.ant.util.JAXPUtils#getSystemId instead
+     * @deprecated since 1.5.x. 
+     *             Use org.apache.tools.ant.util.JAXPUtils#getSystemId instead.
      */
     protected String getSystemId(File file) {
         return JAXPUtils.getSystemId(file);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/jdepend/JDependTask.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/jdepend/JDependTask.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/jdepend/JDependTask.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/jdepend/JDependTask.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2005 The Apache Software Foundation
+ * Copyright  2001-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -185,7 +185,7 @@
     /**
      * Adds a path to source code to analyze.
      * @return a source path
-     * @deprecated
+     * @deprecated since 1.6.x.
      */
     public Path createSourcespath() {
         if (sourcesPath == null) {
@@ -197,8 +197,7 @@
     /**
      * Gets the sourcepath.
      * @return the sources path
-     * @deprecated
-     *
+     * @deprecated since 1.6.x.
      */
     public Path getSourcespath() {
         return sourcesPath;

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java Fri Apr 21 14:47:06 2006
@@ -1203,7 +1203,8 @@
      * Sets the FTP action to be taken. Currently accepts "put", "get", "del",
      * "mkdir", "chmod", "list", and "site".
      *
-     * @deprecated setAction(String) is deprecated and is replaced with
+     * @deprecated since 1.5.x. 
+     *             setAction(String) is deprecated and is replaced with
      *      setAction(FTP.Action) to make Ant's Introspection mechanism do the
      *      work and also to encapsulate operations on the type in its own
      *      class.

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/MimeMail.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/MimeMail.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/MimeMail.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/net/MimeMail.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2002,2004 The Apache Software Foundation
+ * Copyright  2001-2002,2004,2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -22,7 +22,8 @@
 /**
  * A task to send SMTP email; Use <tt>mail</tt> instead
  *
- * @deprecated Use {@link EmailTask} instead.
+ * @deprecated since 1.6.x. 
+ *             Use {@link EmailTask} instead.
  *
  * @since Ant1.4
  */

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/script/ScriptDef.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -295,7 +295,8 @@
      *
      * @param attributes collection of attributes
      * @param elements a list of nested element values.
-     * @deprecated use executeScript(attribute, elements, instance) instead
+     * @deprecated since 1.7. 
+     *             Use executeScript(attribute, elements, instance) instead.
      */
     public void executeScript(Map attributes, Map elements) {
         executeScript(attributes, elements,null);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2002-2005 The Apache Software Foundation
+ * Copyright  2002-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -60,7 +60,8 @@
      * flag to enable proxy settings; optional, deprecated : consider
      * using &lt;setproxy&gt; instead
      * @param useProxy if ture, enable proxy settings
-     * @deprecated use org.apache.tools.ant.taskdefs.optional.SetProxy
+     * @deprecated since 1.5.x. 
+     *             Use org.apache.tools.ant.taskdefs.optional.SetProxy
      */
     public void setUseproxy(boolean useProxy) {
         this.useProxy = useProxy;

Modified: ant/core/trunk/src/main/org/apache/tools/ant/types/CommandlineJava.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/types/CommandlineJava.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/types/CommandlineJava.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/types/CommandlineJava.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -508,7 +508,9 @@
      * operation, as it has to evaluate the size of many components.
      * @return the total number of arguments in the java command line.
      * @see #getCommandline()
-     * @deprecated please dont use this--it effectively creates the entire command.
+     * @deprecated since 1.7. 
+     *             Please dont use this, it effectively creates the 
+     *             entire command.
      */
     public int size() {
         int size = getActualVMCommand().size() + javaCommand.size()

Modified: ant/core/trunk/src/main/org/apache/tools/ant/types/DataType.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/types/DataType.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/types/DataType.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/types/DataType.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -41,17 +41,19 @@
     /**
      * The description the user has set.
      *
-     * @deprecated The user should not be directly referencing
-     *   variable. Please use {@link #setDescription} or
-     *   {@link #getDescription} instead.
+     * @deprecated since 1.7.
+     *             The user should not be directly referencing
+     *             variable. Please use {@link #setDescription} or
+     *             {@link #getDescription} instead.
      */
     protected String description;
 
     /**
      * Value to the refid attribute.
      *
-     * @deprecated The user should not be directly referencing
-     *   variable. Please use {@link #getRefid} instead.
+     * @deprecated since 1.7. 
+     *             The user should not be directly referencing
+     *             variable. Please use {@link #getRefid} instead.
      */
     protected Reference ref;
 
@@ -63,9 +65,10 @@
      * child element has been added that is a subclass of
      * DataType).</p>
      *
-     * @deprecated The user should not be directly referencing
-     *   variable. Please use {@link #setChecked} or
-     *   {@link #isChecked} instead.
+     * @deprecated since 1.7. 
+     *             The user should not be directly referencing
+     *             variable. Please use {@link #setChecked} or 
+     *             {@link #isChecked} instead.
      */
     protected boolean checked = true;
 

Modified: ant/core/trunk/src/main/org/apache/tools/ant/types/Reference.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/types/Reference.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/types/Reference.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/types/Reference.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2002,2004-2005 The Apache Software Foundation
+ * Copyright  2000-2002,2004-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -31,7 +31,9 @@
 
     /**
      * Create a reference.
-     * @deprecated Please use {@link Reference#Reference(Project,String)} instead.
+     * @deprecated since 1.7. 
+     *             Please use {@link Reference#Reference(Project,String)}
+     *             instead.
      */
     public Reference() {
     }
@@ -39,7 +41,9 @@
     /**
      * Create a reference to a named ID.
      * @param id the name of this reference
-     * @deprecated Please use {@link Reference#Reference(Project,String)} instead.
+     * @deprecated since 1.7. 
+     *             Please use {@link Reference#Reference(Project,String)}
+     *             instead.
      */
     public Reference(String id) {
         setRefId(id);

Modified: ant/core/trunk/src/main/org/apache/tools/ant/util/CollectionUtils.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/util/CollectionUtils.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/util/CollectionUtils.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/util/CollectionUtils.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2002-2005 The Apache Software Foundation
+ * Copyright  2002-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -35,7 +35,7 @@
      * @param v2 the second vector.
      * @return true if the vectors are equal.
      * @since Ant 1.5
-     * @deprecated
+     * @deprecated since 1.6.x.
      */
     public static boolean equals(Vector v1, Vector v2) {
         if (v1 == v2) {
@@ -58,7 +58,7 @@
      * @param d2 the second directory.
      * @return true if the directories are equal.
      * @since Ant 1.5
-     * @deprecated
+     * @deprecated since 1.6.x.
      */
     public static boolean equals(Dictionary d1, Dictionary d2) {
         if (d1 == d2) {
@@ -94,7 +94,7 @@
      * @param m1 the to directory.
      * @param m2 the from directory.
      * @since Ant 1.6
-     * @deprecated
+     * @deprecated since 1.6.x.
      */
     public static void putAll(Dictionary m1, Dictionary m2) {
         for (Enumeration it = m2.keys(); it.hasMoreElements();) {

Modified: ant/core/trunk/src/main/org/apache/tools/ant/util/FileUtils.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/util/FileUtils.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/util/FileUtils.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/util/FileUtils.java Fri Apr 21 14:47:06 2006
@@ -84,7 +84,9 @@
      * Factory method.
      *
      * @return a new instance of FileUtils.
-     * @deprecated Use getFileUtils instead, FileUtils do not have state.
+     * @deprecated since 1.7.
+     *             Use getFileUtils instead, 
+     * FileUtils do not have state.
      */
     public static FileUtils newFileUtils() {
         return new FileUtils();
@@ -870,7 +872,8 @@
      * @return the given file's parent, or null if the file does not have a
      *         parent.
      * @since 1.10
-     * @deprecated Just use {@link File#getParentFile} directly.
+     * @deprecated since 1.7.
+     *             Just use {@link File#getParentFile} directly.
      */
     public File getParentFile(File f) {
         return (f == null) ? null : f.getParentFile();

Modified: ant/core/trunk/src/main/org/apache/tools/ant/util/WeakishReference.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/util/WeakishReference.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/util/WeakishReference.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/util/WeakishReference.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -23,7 +23,8 @@
  * This is a weak reference on java1.2 and up, that is all
  * platforms Ant1.6 supports.
  * @since ant1.6
- * @deprecated Just use {@link java.lang.ref.WeakReference} directly.
+ * @deprecated since 1.7.
+ *             Just use {@link java.lang.ref.WeakReference} directly.
  */
 public abstract class WeakishReference  {
 
@@ -47,7 +48,8 @@
 
     /**
      * A hard reference for Java 1.1.
-     * @deprecated Hopefully nobody is using this.
+     * @deprecated since 1.7. 
+     *             Hopefully nobody is using this.
      */
     public static class HardReference extends WeakishReference {
         private Object object;

Modified: ant/core/trunk/src/main/org/apache/tools/ant/util/optional/WeakishReference12.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/ant/util/optional/WeakishReference12.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/ant/util/optional/WeakishReference12.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/ant/util/optional/WeakishReference12.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2000-2005 The Apache Software Foundation
+ * Copyright  2000-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -24,7 +24,8 @@
 /**
  * This is a reference that really is is Weak, as it uses the
  * appropriate java.lang.ref class.
- * @deprecated Just use {@link WeakReference} directly.
+ * @deprecated since 1.7.
+ *             Just use {@link WeakReference} directly.
  */
 public class WeakishReference12 extends WeakishReference  {
 

Modified: ant/core/trunk/src/main/org/apache/tools/zip/ZipEntry.java
URL: http://svn.apache.org/viewcvs/ant/core/trunk/src/main/org/apache/tools/zip/ZipEntry.java?rev=396012&r1=396011&r2=396012&view=diff
==============================================================================
--- ant/core/trunk/src/main/org/apache/tools/zip/ZipEntry.java (original)
+++ ant/core/trunk/src/main/org/apache/tools/zip/ZipEntry.java Fri Apr 21 14:47:06 2006
@@ -1,5 +1,5 @@
 /*
- * Copyright  2001-2005 The Apache Software Foundation
+ * Copyright  2001-2006 The Apache Software Foundation
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -296,7 +296,8 @@
      * <p>This either stores the size for later usage or invokes
      * setCompressedSize via reflection.</p>
      * @param size the size to use
-     * @deprecated use setCompressedSize directly. 
+     * @deprecated since 1.7.
+     *             Use setCompressedSize directly. 
      * @since 1.2
      */
     public void setComprSize(long size) {



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org