diff --git a/src/main/org/apache/tools/ant/XmlLogger.java b/src/main/org/apache/tools/ant/XmlLogger.java index 5131d9eb7..cf0cccbf3 100644 --- a/src/main/org/apache/tools/ant/XmlLogger.java +++ b/src/main/org/apache/tools/ant/XmlLogger.java @@ -427,10 +427,23 @@ public class XmlLogger implements BuildLogger { // -------------------------------------------------- BuildLogger interface + /** + * Set the logging level when using this as a Logger + * + * @param level the logging level - + * see {@link org.apache.tools.ant.Project#MSG_ERR Project} + * class for level definitions + */ public void setMessageOutputLevel(int level) { msgOutputLevel = level; } + /** + * Set the output stream to which logging output is sent when operating + * as a logger. + * + * @param output the output PrintStream. + */ public void setOutputPrintStream(PrintStream output) { this.outStream = new PrintStream(output, true); } diff --git a/src/main/org/apache/tools/ant/filters/StringInputStream.java b/src/main/org/apache/tools/ant/filters/StringInputStream.java index bb1bfbf65..2ddb561a5 100644 --- a/src/main/org/apache/tools/ant/filters/StringInputStream.java +++ b/src/main/org/apache/tools/ant/filters/StringInputStream.java @@ -106,8 +106,11 @@ public class StringInputStream in.reset(); } + /** + * @see InputStream#markSupported + */ public boolean markSupported() { - return true; + return in.markSupported(); } } diff --git a/src/main/org/apache/tools/ant/taskdefs/Chmod.java b/src/main/org/apache/tools/ant/taskdefs/Chmod.java index 1941e66c0..6a75599fa 100644 --- a/src/main/org/apache/tools/ant/taskdefs/Chmod.java +++ b/src/main/org/apache/tools/ant/taskdefs/Chmod.java @@ -92,7 +92,7 @@ public class Chmod extends ExecuteOn { } /** - * @see ProjectComponent#setProject + * @see org.apache.tools.ant.ProjectComponent#setProject */ public void setProject(Project project) { super.setProject(project); diff --git a/src/main/org/apache/tools/ant/taskdefs/MatchingTask.java b/src/main/org/apache/tools/ant/taskdefs/MatchingTask.java index 805348a4e..3e0d83262 100644 --- a/src/main/org/apache/tools/ant/taskdefs/MatchingTask.java +++ b/src/main/org/apache/tools/ant/taskdefs/MatchingTask.java @@ -83,7 +83,7 @@ public abstract class MatchingTask extends Task { protected FileSet fileset = new FileSet(); /** - * @see ProjectComponent#setProject + * @see org.apache.tools.ant.ProjectComponent#setProject */ public void setProject(Project project) { super.setProject(project); diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/AbstractHotDeploymentTool.java b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/AbstractHotDeploymentTool.java index 817bcfb2a..0f4612496 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/AbstractHotDeploymentTool.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/AbstractHotDeploymentTool.java @@ -138,7 +138,7 @@ public abstract class AbstractHotDeploymentTool implements HotDeploymentTool { } /** - * Perform the actual deployment.
+ * Perform the actual deployment. * It's up to the subclasses to implement the actual behavior. * @exception org.apache.tools.ant.BuildException if the attributes are invalid or incomplete. */ diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/GenericHotDeploymentTool.java b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/GenericHotDeploymentTool.java index 974cdb659..c8462174e 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/GenericHotDeploymentTool.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/GenericHotDeploymentTool.java @@ -121,7 +121,7 @@ public class GenericHotDeploymentTool extends AbstractHotDeploymentTool { } /** - * Perform the actual deployment.
+ * Perform the actual deployment. * For this generic implementation, a JVM is spawned using the * supplied classpath, classname, JVM args, and command line arguments. * @exception org.apache.tools.ant.BuildException if the attributes are invalid or incomplete. diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/HotDeploymentTool.java b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/HotDeploymentTool.java index c961d98b0..0c71de634 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/HotDeploymentTool.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/HotDeploymentTool.java @@ -86,7 +86,7 @@ public interface HotDeploymentTool { public void validateAttributes() throws BuildException; /** - * Perform the actual deployment.
+ * Perform the actual deployment. * @exception org.apache.tools.ant.BuildException if the attributes are invalid or incomplete. */ public void deploy() throws BuildException; diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/JonasHotDeploymentTool.java b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/JonasHotDeploymentTool.java index 471d4c97b..58adff522 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/JonasHotDeploymentTool.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/JonasHotDeploymentTool.java @@ -70,11 +70,10 @@ import org.apache.tools.ant.types.Path; * In the end, this task assembles the commadline parameters and * runs the weblogic.deploy tool in a seperate JVM. * - *@author Cyrille Morvan - *@created March 30, 2002 - *@see org.apache.tools.ant.taskdefs.optional.j2ee.HotDeploymentTool - *@see org.apache.tools.ant.taskdefs.optional.j2ee.AbstractHotDeploymentTool - *@see org.apache.tools.ant.taskdefs.optional.j2ee.ServerDeploy + *@author Cyrille Morvan + *@see org.apache.tools.ant.taskdefs.optional.j2ee.HotDeploymentTool + *@see org.apache.tools.ant.taskdefs.optional.j2ee.AbstractHotDeploymentTool + *@see org.apache.tools.ant.taskdefs.optional.j2ee.ServerDeploy */ public class JonasHotDeploymentTool extends GenericHotDeploymentTool implements HotDeploymentTool { diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/WebLogicHotDeploymentTool.java b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/WebLogicHotDeploymentTool.java index 95b398b9f..28284c89e 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/WebLogicHotDeploymentTool.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/j2ee/WebLogicHotDeploymentTool.java @@ -91,7 +91,7 @@ public class WebLogicHotDeploymentTool extends AbstractHotDeploymentTool impleme private String component; /** - * Perform the actual deployment.
+ * Perform the actual deployment. * For this implementation, a JVM is spawned and the weblogic.deploy * tools is executed. * @exception org.apache.tools.ant.BuildException if the attributes are invalid or incomplete. diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/net/SetProxy.java b/src/main/org/apache/tools/ant/taskdefs/optional/net/SetProxy.java index 964a8f0a4..7535a90bd 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/net/SetProxy.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/net/SetProxy.java @@ -66,10 +66,8 @@ import org.apache.tools.ant.*; * @see * java 1.4 network property list * @author Steve Loughran - * @created March 17, 2001 * @ant.task */ - public class SetProxy extends Task { /** @@ -99,7 +97,7 @@ public class SetProxy extends Task { private String nonProxyHosts = null; /** - * set a proxy host. the port should be defined too + * Set a proxy host. The port should be defined too. * * @param hostname the new proxy hostname */ @@ -137,8 +135,8 @@ public class SetProxy extends Task { } /** - * specify a list of hosts to bypass the proxy on; separate them with the - * vertical bar character '|' + * Specify a list of hosts to bypass the proxy on. These should be separated + * with the vertical bar character '|'. * e.g. fozbot.corp.sun.com|*.eng.sun.com * @param nonProxyHosts lists of hosts to talk direct to */ diff --git a/src/main/org/apache/tools/ant/types/AntFilterReader.java b/src/main/org/apache/tools/ant/types/AntFilterReader.java index 4e35df294..fa73a85e0 100644 --- a/src/main/org/apache/tools/ant/types/AntFilterReader.java +++ b/src/main/org/apache/tools/ant/types/AntFilterReader.java @@ -136,7 +136,8 @@ public final class AntFilterReader } /** - * Makes this instance in effect a reference to another AntFilterReader instance + * Makes this instance in effect a reference to another AntFilterReader + * instance. * *

You must not set another attribute or nest elements inside * this element if you make it a reference.

diff --git a/src/main/org/apache/tools/ant/types/FilterChain.java b/src/main/org/apache/tools/ant/types/FilterChain.java index c25163a70..197a58df3 100644 --- a/src/main/org/apache/tools/ant/types/FilterChain.java +++ b/src/main/org/apache/tools/ant/types/FilterChain.java @@ -139,7 +139,8 @@ public final class FilterChain extends DataType implements Cloneable { } /** - * Makes this instance in effect a reference to another FilterChain instance + * Makes this instance in effect a reference to another FilterChain + * instance. * *

You must not set another attribute or nest elements inside * this element if you make it a reference.

diff --git a/src/main/org/apache/tools/ant/util/FileUtils.java b/src/main/org/apache/tools/ant/util/FileUtils.java index 52e604dc7..9bbd29162 100644 --- a/src/main/org/apache/tools/ant/util/FileUtils.java +++ b/src/main/org/apache/tools/ant/util/FileUtils.java @@ -803,7 +803,7 @@ public class FileUtils { } /** - * Emulation of File.createNewFile for JDK 1.1 + * Emulation of File.createNewFile for JDK 1.1. * *

This method does not guarantee that the * operation is atomic.