The attached diffs banish the dreaded "breakiterator" messages during Javadoc
execution
while building Ant under Java 1.4.
--
Jack J. Woehr # We have gone from the horse and buggy
Senior Consultant # to the moon rocket in one lifetime, but
Purematrix, Inc. # there has not been a corresponding moral
www.purematrix.com # growth in mankind. - Dwight D. Eisenhower
Index: src/main/org/apache/tools/ant/AntTypeDefinition.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/AntTypeDefinition.java,v
retrieving revision 1.12
diff -u -r1.12 AntTypeDefinition.java
--- src/main/org/apache/tools/ant/AntTypeDefinition.java 15 Mar 2004
17:33:09 -0000 1.12
+++ src/main/org/apache/tools/ant/AntTypeDefinition.java 13 Apr 2004
20:25:50 -0000
@@ -215,7 +215,7 @@
}
/**
- * check if the attributes are correct
+ * Checks if the attributes are correct.
* <dl>
* <li>if the class can be created.</li>
* <li>if an adapter class can be created</li>
Index: src/main/org/apache/tools/ant/ComponentHelper.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/ComponentHelper.java,v
retrieving revision 1.35
diff -u -r1.35 ComponentHelper.java
--- src/main/org/apache/tools/ant/ComponentHelper.java 9 Mar 2004 16:47:59
-0000 1.35
+++ src/main/org/apache/tools/ant/ComponentHelper.java 13 Apr 2004 20:25:55
-0000
@@ -235,9 +235,9 @@
}
/**
- * Initialization code - implementing the original ant component
+ * This method is initialization code implementing the original ant
component
* loading from /org/apache/tools/ant/taskdefs/default.properties
- * and .../types/default.properties
+ * and /org/apache/tools/ant/types/default.properties.
*/
public void initDefaultDefinitions() {
initTasks();
Index: src/main/org/apache/tools/ant/PropertyHelper.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/PropertyHelper.java,v
retrieving revision 1.14
diff -u -r1.14 PropertyHelper.java
--- src/main/org/apache/tools/ant/PropertyHelper.java 9 Mar 2004 16:47:59
-0000 1.14
+++ src/main/org/apache/tools/ant/PropertyHelper.java 13 Apr 2004 20:25:59
-0000
@@ -169,9 +169,9 @@
/** Get a property. If all hooks return null, the default
* tables will be used.
*
- * @param ns
- * @param name
- * @return
+ * @param ns namespace of the sought property
+ * @param name name of the sought property
+ * @return The property, if returned by a hook, or null if none.
*/
public Object getPropertyHook(String ns, String name, boolean user) {
if (getNext() != null) {
Index: src/main/org/apache/tools/ant/filters/EscapeUnicode.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/filters/EscapeUnicode.java,v
retrieving revision 1.8
diff -u -r1.8 EscapeUnicode.java
--- src/main/org/apache/tools/ant/filters/EscapeUnicode.java 9 Mar 2004
16:48:02 -0000 1.8
+++ src/main/org/apache/tools/ant/filters/EscapeUnicode.java 13 Apr 2004
20:26:01 -0000
@@ -20,7 +20,7 @@
import java.io.Reader;
/**
- * Converts non latin characters to unicode escapes
+ * This method converts non-latin characters to unicode escapes.
* Useful to load properties containing non latin
* Example:
*
Index: src/main/org/apache/tools/ant/helper/ProjectHelper2.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/helper/ProjectHelper2.java,v
retrieving revision 1.44
diff -u -r1.44 ProjectHelper2.java
--- src/main/org/apache/tools/ant/helper/ProjectHelper2.java 10 Mar 2004
09:24:02 -0000 1.44
+++ src/main/org/apache/tools/ant/helper/ProjectHelper2.java 13 Apr 2004
20:26:09 -0000
@@ -317,8 +317,8 @@
}
/**
- * Called when this element and all elements nested into it have been
- * handled (i.e. at the </end_tag_of_the_element> ).
+ * This method is called when this element and all elements nested
into it have been
+ * handled. I.e., this happens at the </end_tag_of_the_element>.
* @param uri the namespace uri for this element
* @param tag the element name
* @param context the current context
Index: src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java,v
retrieving revision 1.33
diff -u -r1.33 AbstractCvsTask.java
--- src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java 9 Mar 2004
16:48:03 -0000 1.33
+++ src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java 13 Apr 2004
20:26:14 -0000
@@ -599,7 +599,7 @@
}
/**
- * add a command line argument to an external command
+ * This method adds a command line argument to an external command.
*
* I do not understand what this method does in this class ???
* particularly not why it is public ????
Index: src/main/org/apache/tools/ant/taskdefs/ExecTask.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/ExecTask.java,v
retrieving revision 1.68
diff -u -r1.68 ExecTask.java
--- src/main/org/apache/tools/ant/taskdefs/ExecTask.java 27 Mar 2004
21:22:58 -0000 1.68
+++ src/main/org/apache/tools/ant/taskdefs/ExecTask.java 13 Apr 2004
20:26:18 -0000
@@ -357,9 +357,9 @@
/**
- * Attempt to figure out where the executable is so that we can feed
- * the full path - first try basedir, then the exec dir and then
- * fallback to the straight executable name (i.e. on ther path)
+ * The method attempts to figure out where the executable is so that we
can feed
+ * the full path. We first try basedir, then the exec dir, and then
+ * fallback to the straight executable name (i.e. on ther path).
*
* @param exec the name of the executable
* @param searchPath if true, the excutable will be looked up in
Index: src/main/org/apache/tools/ant/taskdefs/PumpStreamHandler.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/PumpStreamHandler.java,v
retrieving revision 1.19
diff -u -r1.19 PumpStreamHandler.java
--- src/main/org/apache/tools/ant/taskdefs/PumpStreamHandler.java 9 Mar
2004 16:48:06 -0000 1.19
+++ src/main/org/apache/tools/ant/taskdefs/PumpStreamHandler.java 13 Apr
2004 20:26:20 -0000
@@ -41,7 +41,7 @@
* Construct a new <CODE>PumpStreamHandler</CODE>.
* @param out the output <CODE>OutputStream</CODE>.
* @param err the error <CODE>OutputStream</CODE>.
- * @param in the input <CODE>InputStream</CODE>.
+ * @param input the input <CODE>InputStream</CODE>.
*/
public PumpStreamHandler(OutputStream out, OutputStream err,
InputStream input) {
Index: src/main/org/apache/tools/ant/taskdefs/Redirector.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/Redirector.java,v
retrieving revision 1.17
diff -u -r1.17 Redirector.java
--- src/main/org/apache/tools/ant/taskdefs/Redirector.java 27 Mar 2004
21:22:58 -0000 1.17
+++ src/main/org/apache/tools/ant/taskdefs/Redirector.java 13 Apr 2004
20:26:24 -0000
@@ -360,7 +360,7 @@
/**
* Set the input <CODE>FilterChain</CODE>s.
*
- * @param <CODE>Vector</CODE> containing <CODE>FilterChain</CODE>.
+ * @param inputFilterChains <CODE>Vector</CODE> containing
<CODE>FilterChain</CODE>.
*/
public synchronized void setInputFilterChains(Vector inputFilterChains) {
this.inputFilterChains = inputFilterChains;
@@ -369,7 +369,7 @@
/**
* Set the output <CODE>FilterChain</CODE>s.
*
- * @param <CODE>Vector</CODE> containing <CODE>FilterChain</CODE>.
+ * @param outputFilterChains <CODE>Vector</CODE> containing
<CODE>FilterChain</CODE>.
*/
public void setOutputFilterChains(Vector outputFilterChains) {
this.outputFilterChains = outputFilterChains;
@@ -378,7 +378,7 @@
/**
* Set the error <CODE>FilterChain</CODE>s.
*
- * @param <CODE>Vector</CODE> containing <CODE>FilterChain</CODE>.
+ * @param errorFilterChains <CODE>Vector</CODE> containing
<CODE>FilterChain</CODE>.
*/
public void setErrorFilterChains(Vector errorFilterChains) {
this.errorFilterChains = errorFilterChains;
Index: src/main/org/apache/tools/ant/taskdefs/SubAnt.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/SubAnt.java,v
retrieving revision 1.15
diff -u -r1.15 SubAnt.java
--- src/main/org/apache/tools/ant/taskdefs/SubAnt.java 9 Mar 2004 16:48:06
-0000 1.15
+++ src/main/org/apache/tools/ant/taskdefs/SubAnt.java 13 Apr 2004 20:26:27
-0000
@@ -197,9 +197,10 @@
}
/**
- * Build file name, to use in conjunction with directories.<br/>
- * Defaults to "build.xml".<br/>
- * If <code>genericantfile</code> is set, this attribute is ignored.
+ * This method builds the file name to use in conjunction with directories.
+ *
+ * <p>Defaults to "build.xml".
+ * If <code>genericantfile</code> is set, this attribute is ignored.</p>
*
* @param antfile the short build file name. Defaults to "build.xml".
*/
@@ -208,9 +209,10 @@
}
/**
- * Build file path, to use in conjunction with directories.<br/>
- * Use <code>genericantfile</code>, in order to run the same build file
- * with different basedirs.<br/>
+ * This method builds a file path to use in conjunction with directories.
+ *
+ * <p>Use <code>genericantfile</code>, in order to run the same build file
+ * with different basedirs.</p>
* If this attribute is set, <code>antfile</code> is ignored.
*
* @param afile (path of the generic ant file, absolute or relative to
Index: src/main/org/apache/tools/ant/taskdefs/Tar.java
===================================================================
RCS file: /home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/Tar.java,v
retrieving revision 1.52
diff -u -r1.52 Tar.java
--- src/main/org/apache/tools/ant/taskdefs/Tar.java 15 Mar 2004 14:36:21
-0000 1.52
+++ src/main/org/apache/tools/ant/taskdefs/Tar.java 13 Apr 2004 20:26:32
-0000
@@ -540,7 +540,7 @@
/**
* The uid for the tar entry
* This is not the same as the User name.
- * @param userName the user name for the tar entry.
+ * @param uid the id of the user for the tar entry.
*/
public void setUid(int uid) {
this.uid = uid;
@@ -572,7 +572,7 @@
/**
* The GID for the tar entry; optional, default="0"
* This is not the same as the group name.
- * @param groupName the group name string.
+ * @param gid the group id.
*/
public void setGid(int gid) {
this.gid = gid;
Index: src/main/org/apache/tools/ant/taskdefs/optional/dotnet/CSharp.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/dotnet/CSharp.java,v
retrieving revision 1.42
diff -u -r1.42 CSharp.java
--- src/main/org/apache/tools/ant/taskdefs/optional/dotnet/CSharp.java 9 Mar
2004 16:48:18 -0000 1.42
+++ src/main/org/apache/tools/ant/taskdefs/optional/dotnet/CSharp.java 13 Apr
2004 20:26:35 -0000
@@ -361,7 +361,7 @@
// end execute
/**
- * how does C# separate references? with a semi colon
+ * Returns the delimiter which C# uses to separate references, i.e., a
semi colon.
*/
public String getReferenceDelimiter() {
return ";";
@@ -369,8 +369,8 @@
/**
- * extension is '.cs'
- * @return
+ * This method indicates the filename extension for C# files.
+ * @return the file extension for C#, i.e., "cs" (without the dot).
*/
public String getFileExtension() {
return "cs";
Index: src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetCompile.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetCompile.java,v
retrieving revision 1.24
diff -u -r1.24 DotnetCompile.java
--- src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetCompile.java
9 Mar 2004 16:48:18 -0000 1.24
+++ src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetCompile.java
13 Apr 2004 20:26:40 -0000
@@ -711,8 +711,8 @@
}
/**
- * what is the executable?
- * @return
+ * This method gets the name of the executable.
+ * @return the name of the executable
*/
protected String getExecutable() {
return executable;
@@ -764,7 +764,7 @@
/**
* getter for flag
- * @return
+ * @return The flag indicating whether the compilation is using a response
file.
*/
public boolean isUseResponseFile() {
return useResponseFile;
@@ -922,8 +922,8 @@
protected abstract void addCompilerSpecificOptions(NetCommand command);
/**
- * override point for delimiting definitions
- * @return
+ * override point for delimiting definitions.
+ * @return The definitions limiter, i.e., ";"
*/
public String getDefinitionsDelimiter() {
return ";";
Index: src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetDefine.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetDefine.java,v
retrieving revision 1.8
diff -u -r1.8 DotnetDefine.java
--- src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetDefine.java
9 Feb 2004 21:05:28 -0000 1.8
+++ src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetDefine.java
13 Apr 2004 20:26:40 -0000
@@ -62,10 +62,10 @@
}
/**
- * get the value of this definition. Will be null if a condition
+ * This method gets the value of this definition. Will be null if a
condition
* was declared and not met
* @param owner owning task
- * @return
+ * @return The value of the definition.
* @throws BuildException
*/
public String getValue(Task owner) throws BuildException {
Index:
src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetResource.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetResource.java,v
retrieving revision 1.5
diff -u -r1.5 DotnetResource.java
--- src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetResource.java
9 Feb 2004 21:05:28 -0000 1.5
+++ src/main/org/apache/tools/ant/taskdefs/optional/dotnet/DotnetResource.java
13 Apr 2004 20:26:41 -0000
@@ -98,7 +98,7 @@
/**
* build the C# style parameter (which has no public/private option)
- * @return
+ * @return the built C# style parameter
*/
public String getCSharpStyleParameter() {
StringBuffer buffer = new StringBuffer();
@@ -117,8 +117,8 @@
}
/**
- * get the style of param used by VB and javascript
- * @return
+ * This method gets the style of param used by VB and javascript
+ * @return The style VB parameter being used.
*/
public String getVbStyleParameter() {
StringBuffer buffer = new StringBuffer();
Index: src/main/org/apache/tools/ant/taskdefs/optional/dotnet/Ildasm.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/dotnet/Ildasm.java,v
retrieving revision 1.8
diff -u -r1.8 Ildasm.java
--- src/main/org/apache/tools/ant/taskdefs/optional/dotnet/Ildasm.java 9 Feb
2004 21:05:28 -0000 1.8
+++ src/main/org/apache/tools/ant/taskdefs/optional/dotnet/Ildasm.java 13 Apr
2004 20:26:43 -0000
@@ -280,7 +280,7 @@
setSourceFile(sourceFile);
}
/**
- * visibility options: one or more of the following, with + signs to
+ * This method sets the visibility options. It chooses one or more of the
following, with + signs to
* concatenate them:
* <pre>
* pub : Public
@@ -425,9 +425,9 @@
}
/**
- * map from an encoding enum to an encoding option
+ * This method maps from an encoding enum to an encoding option.
* @param enumValue
- * @return
+ * @return The encoding option indicated by the enum value.
*/
public static String getEncodingOption(String enumValue) {
if (UNICODE.equals(enumValue)) {
Index: src/main/org/apache/tools/ant/taskdefs/optional/dotnet/ImportTypelib.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/dotnet/ImportTypelib.java,v
retrieving revision 1.11
diff -u -r1.11 ImportTypelib.java
--- src/main/org/apache/tools/ant/taskdefs/optional/dotnet/ImportTypelib.java
9 Mar 2004 16:48:18 -0000 1.11
+++ src/main/org/apache/tools/ant/taskdefs/optional/dotnet/ImportTypelib.java
13 Apr 2004 20:26:44 -0000
@@ -76,7 +76,9 @@
private String extraOptions = null;
/**
- * name the output file. required
+ * This method names the output file.
+ *
+ * This is an operation which is required to have been performed.
* @param destFile
*/
public void setDestFile(File destFile) {
@@ -84,7 +86,8 @@
}
/**
- * what namespace is the typelib to be in. required
+ * This method sets what namespace the typelib is to be in.
+ * This is an operation which is required to have been performed.
* @param namespace
*/
public void setNamespace(String namespace) {
@@ -92,7 +95,8 @@
}
/**
- * what is the source .tlb file? required.
+ * This method sets which is the source .tlb file.
+ * This is an operation which is required to have been performed.
* @param srcFile
*/
public void setSrcFile(File srcFile) {
Index:
src/main/org/apache/tools/ant/taskdefs/optional/ejb/IPlanetDeploymentTool.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/ejb/IPlanetDeploymentTool.java,v
retrieving revision 1.14
diff -u -r1.14 IPlanetDeploymentTool.java
---
src/main/org/apache/tools/ant/taskdefs/optional/ejb/IPlanetDeploymentTool.java
9 Mar 2004 16:48:20 -0000 1.14
+++
src/main/org/apache/tools/ant/taskdefs/optional/ejb/IPlanetDeploymentTool.java
13 Apr 2004 20:26:48 -0000
@@ -292,8 +292,7 @@
*
* @param ejbFiles Hashtable of EJB class (and other) files to be added to
* the completed JAR file.
- * @param baseName String name of the EJB JAR file to be written (without
- * a filename extension).
+ * @param ddPrefix not used
*/
protected void addVendorFiles(Hashtable ejbFiles, String ddPrefix) {
ejbFiles.put(META_DIR + IAS_DD, new File(getConfig().descriptorDir,
Index:
src/main/org/apache/tools/ant/taskdefs/optional/extension/Specification.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/extension/Specification.java,v
retrieving revision 1.8
diff -u -r1.8 Specification.java
---
src/main/org/apache/tools/ant/taskdefs/optional/extension/Specification.java
9 Mar 2004 16:48:24 -0000 1.8
+++
src/main/org/apache/tools/ant/taskdefs/optional/extension/Specification.java
13 Apr 2004 20:26:52 -0000
@@ -108,9 +108,9 @@
new Compatibility("REQUIRE_IMPLEMENTATION_CHANGE");
/**
- * Enum indicating that extension is incompatible with
+ * This enum indicates that an extension is incompatible with
* other Package Specification in ways other than other enums
- * indicate). ie For example the other Package Specification
+ * indicate. For example, the other Package Specification
* may have a different ID.
*/
public static final Compatibility INCOMPATIBLE =
Index: src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspC.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspC.java,v
retrieving revision 1.41
diff -u -r1.41 JspC.java
--- src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspC.java 9 Mar
2004 16:48:30 -0000 1.41
+++ src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspC.java 13 Apr
2004 20:26:56 -0000
@@ -298,7 +298,7 @@
/**
* Filename for web.xml.
- * @return
+ * @return The filename for web.xml.
*/
public File getWebxml() {
return this.webxml;
Index: src/main/org/apache/tools/ant/taskdefs/optional/perforce/P4Labelsync.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/perforce/P4Labelsync.java,v
retrieving revision 1.8
diff -u -r1.8 P4Labelsync.java
--- src/main/org/apache/tools/ant/taskdefs/optional/perforce/P4Labelsync.java
9 Mar 2004 16:48:33 -0000 1.8
+++ src/main/org/apache/tools/ant/taskdefs/optional/perforce/P4Labelsync.java
13 Apr 2004 20:26:57 -0000
@@ -27,8 +27,8 @@
import org.apache.tools.ant.util.StringUtils;
/**
- * Syncs an existing Perforce label against the Perforce client
- * or against a set of files/revisions
+ * This method syncs an existing Perforce label against the Perforce client
+ * or against a set of files/revisions.
*
*
* Example Usage:
Index:
src/main/org/apache/tools/ant/taskdefs/optional/starteam/TreeBasedTask.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/taskdefs/optional/starteam/TreeBasedTask.java,v
retrieving revision 1.25
diff -u -r1.25 TreeBasedTask.java
--- src/main/org/apache/tools/ant/taskdefs/optional/starteam/TreeBasedTask.java
9 Mar 2004 16:48:37 -0000 1.25
+++ src/main/org/apache/tools/ant/taskdefs/optional/starteam/TreeBasedTask.java
13 Apr 2004 20:27:04 -0000
@@ -482,7 +482,7 @@
/**
* returns the label being used
*
- * @return
+ * @return the label being used
*/
protected Label getLabelInUse() {
return this.labelInUse;
Index: src/main/org/apache/tools/ant/types/Assertions.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/types/Assertions.java,v
retrieving revision 1.13
diff -u -r1.13 Assertions.java
--- src/main/org/apache/tools/ant/types/Assertions.java 9 Mar 2004 16:48:41
-0000 1.13
+++ src/main/org/apache/tools/ant/types/Assertions.java 13 Apr 2004 20:27:06
-0000
@@ -277,7 +277,7 @@
/**
* create a full command string from this class
* @throws BuildException in case of trouble
- * @return
+ * @return The command string
*/
public String toCommand() {
//catch invalidness
Index: src/main/org/apache/tools/ant/types/Commandline.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/types/Commandline.java,v
retrieving revision 1.36
diff -u -r1.36 Commandline.java
--- src/main/org/apache/tools/ant/types/Commandline.java 9 Mar 2004
16:48:41 -0000 1.36
+++ src/main/org/apache/tools/ant/types/Commandline.java 13 Apr 2004
20:27:09 -0000
@@ -452,8 +452,8 @@
}
/**
- * a deep clone of the contained object.
- * @return
+ * Generate a deep clone of the contained object.
+ * @return a clone of the contained object
*/
public Object clone() {
try {
Index: src/main/org/apache/tools/ant/types/CommandlineJava.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/types/CommandlineJava.java,v
retrieving revision 1.53
diff -u -r1.53 CommandlineJava.java
--- src/main/org/apache/tools/ant/types/CommandlineJava.java 9 Mar 2004
16:48:41 -0000 1.53
+++ src/main/org/apache/tools/ant/types/CommandlineJava.java 13 Apr 2004
20:27:13 -0000
@@ -115,9 +115,9 @@
}
/**
- * get the size of the sysproperties instance. This merges all
+ * This method gets the size of the sysproperties instance. This
merges all
* property sets, so is not an O(1) operation.
- * @return
+ * @return the size of the sysproperties instance
*/
public int size() {
Properties p = mergePropertySets();
@@ -458,7 +458,7 @@
/**
* Get the VM command parameters, including memory settings
- * @return
+ * @return the VM command parameters
*/
protected Commandline getActualVMCommand() {
Commandline actualVMCommand = (Commandline) vmCommand.clone();
@@ -557,7 +557,7 @@
/**
* get the system properties object
- * @return
+ * @return The system properties object
*/
public SysProperties getSystemProperties() {
return sysProperties;
Index: src/main/org/apache/tools/ant/util/ClasspathUtils.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/ant/util/ClasspathUtils.java,v
retrieving revision 1.11
diff -u -r1.11 ClasspathUtils.java
--- src/main/org/apache/tools/ant/util/ClasspathUtils.java 9 Feb 2004
21:05:38 -0000 1.11
+++ src/main/org/apache/tools/ant/util/ClasspathUtils.java 13 Apr 2004
20:27:17 -0000
@@ -78,7 +78,7 @@
*
* @param p
* @param ref
- * @return
+ * @return The class loader
*/
public static ClassLoader getClassLoaderForPath(
Project p, Reference ref) {
@@ -98,7 +98,7 @@
* @param reverseLoader if set to true this new loader will take
* precedence over it's parent (which is contra the regular
* classloader behaviour)
- * @return
+ * @return The class loader
*/
public static ClassLoader getClassLoaderForPath(
Project p, Reference ref, boolean reverseLoader) {
@@ -123,7 +123,7 @@
*
* @param path
* @param loaderId
- * @return
+ * @return The class loader
*/
public static ClassLoader getClassLoaderForPath(
Project p, Path path, String loaderId) {
@@ -140,7 +140,7 @@
*
* @param path
* @param loaderId
- * @return
+ * @return The class loader
*/
public static ClassLoader getClassLoaderForPath(
Project p, Path path, String loaderId, boolean reverseLoader) {
@@ -199,7 +199,7 @@
* property and should be used with caution.</p>
* @param path the classpath for this loader
* @param reverseLoader
- * @return
+ * @return The fresh, different, not used before class loader.
*/
public static ClassLoader getUniqueClassLoaderForPath(
Project p,
@@ -225,7 +225,7 @@
*
* @param className the full qualified class name to load.
* @param userDefinedLoader the classloader to use.
- * @return
+ * @return The fresh object instance
* @throws BuildException when loading or instantiation failed.
*/
public static Object newInstance(
@@ -312,7 +312,7 @@
}
/**
- * Delegate method handling the @classpath attribute
+ * This method is a Delegate method handling the @classpath attribute.
*
* <p>This attribute can set a path to add to the classpath</p>
*
@@ -332,7 +332,7 @@
* <p>This nested path-like structure can set a path to add to the
* classpath</p>
*
- * @return
+ * @return the created path
*/
public Path createClasspath() {
if (this.classpath == null) {
@@ -396,7 +396,7 @@
/**
* Finds or creates the classloader for this
- * @return
+ * @return The class loader
*/
public ClassLoader getClassLoader() {
ClassLoader cl;
Index: src/main/org/apache/tools/zip/ZipOutputStream.java
===================================================================
RCS file:
/home/cvspublic/ant/src/main/org/apache/tools/zip/ZipOutputStream.java,v
retrieving revision 1.22
diff -u -r1.22 ZipOutputStream.java
--- src/main/org/apache/tools/zip/ZipOutputStream.java 10 Mar 2004 14:40:49
-0000 1.22
+++ src/main/org/apache/tools/zip/ZipOutputStream.java 13 Apr 2004 20:27:23
-0000
@@ -155,7 +155,7 @@
private static final byte[] LZERO = {0, 0, 0, 0};
/**
- * Holds the offsets of the LFH starts for each entry
+ * Holds the offsets of the LFH starts for each entry.
*
* @since 1.1
*/
@@ -173,7 +173,7 @@
private String encoding = null;
/**
- * Deflater object for output
+ * This Deflater object is used for output.
*
* <p>This attribute is only protected to provide a level of API
* backwards compatibility. This class used to extend [EMAIL PROTECTED]
@@ -185,7 +185,7 @@
protected Deflater def = new Deflater(Deflater.DEFAULT_COMPRESSION, true);
/**
- * Deflater buffer
+ * This buffer servers as a Deflater.
*
* <p>This attribute is only protected to provide a level of API
* backwards compatibility. This class used to extend [EMAIL PROTECTED]
@@ -197,7 +197,7 @@
protected byte[] buf = new byte[512];
/**
- * Optional random access output
+ * Optional random access output.
*
* @since 1.14
*/
@@ -252,8 +252,8 @@
}
/**
- * Is this archive writing to a seekable stream (i.e. a random
- * access file)?
+ * This method indicates whether this archive is writing to a seekable
stream (i.e., to a random
+ * access file).
*
* <p>For seekable streams, you don't need to calculate the CRC or
* uncompressed size for [EMAIL PROTECTED] #STORED STORED} entries before
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
