From 13000c1a4670271a3257b3c41dc1e17941067c78 Mon Sep 17 00:00:00 2001
From: "Jesse N. Glick" In addition, Ant has some built-in properties:
+
basedir the absolute path of the project's basedir (as set
with the basedir attribute of <project>).
ant.file the absolute path of the buildfile.
diff --git a/manual/tutorial-tasks-filesets-properties.html b/manual/tutorial-tasks-filesets-properties.html
index 007657911..1caa74bbf 100644
--- a/manual/tutorial-tasks-filesets-properties.html
+++ b/manual/tutorial-tasks-filesets-properties.html
@@ -883,7 +883,7 @@ do a second checkstyle run. Now our task isn't listed. That's fine :-)
Creating a diff for Ant is very easy: just start ant -f patch.xml and all is done automatically. This step requires a cvs executable in your path and internet access (more precise: -cvs access). As a result we get a file XXX .
+cvs access). As a result we get a file TODO . --> diff --git a/src/main/org/apache/tools/ant/AntClassLoader.java b/src/main/org/apache/tools/ant/AntClassLoader.java index 2c0a05693..7be318b25 100644 --- a/src/main/org/apache/tools/ant/AntClassLoader.java +++ b/src/main/org/apache/tools/ant/AntClassLoader.java @@ -824,7 +824,7 @@ public class AntClassLoader extends ClassLoader implements SubBuildListener { // designated to use a specific loader first // (this one or the parent one) - // XXX - shouldn't this always return false in isolated mode? + // TODO - shouldn't this always return false in isolated mode? boolean useParentFirst = parentFirst; @@ -1561,4 +1561,4 @@ public class AntClassLoader extends ClassLoader implements SubBuildListener { return new AntClassLoader(parent, project, path, parentFirst); } -} \ No newline at end of file +} diff --git a/src/main/org/apache/tools/ant/Main.java b/src/main/org/apache/tools/ant/Main.java index 320bfd82a..debfb8843 100644 --- a/src/main/org/apache/tools/ant/Main.java +++ b/src/main/org/apache/tools/ant/Main.java @@ -962,7 +962,7 @@ public class Main implements AntMain { project.setInputHandler(handler); } - // XXX: (Jon Skeet) Any reason for writing a message and then using a bare + // TODO: (Jon Skeet) Any reason for writing a message and then using a bare // RuntimeException rather than just using a BuildException here? Is it // in case the message could end up being written to no loggers (as the // loggers could have failed to be created due to this failure)? diff --git a/src/main/org/apache/tools/ant/Task.java b/src/main/org/apache/tools/ant/Task.java index 099f716e8..08abe6390 100644 --- a/src/main/org/apache/tools/ant/Task.java +++ b/src/main/org/apache/tools/ant/Task.java @@ -185,7 +185,7 @@ public abstract class Task extends ProjectComponent { this.wrapper = wrapper; } - // XXX: (Jon Skeet) The comment "if it hasn't been done already" may + // TODO: (Jon Skeet) The comment "if it hasn't been done already" may // not be strictly true. wrapper.maybeConfigure() won't configure the same // attributes/text more than once, but it may well add the children again, // unless I've missed something. diff --git a/src/main/org/apache/tools/ant/helper/ProjectHelper2.java b/src/main/org/apache/tools/ant/helper/ProjectHelper2.java index 57936b7be..dc19512b1 100644 --- a/src/main/org/apache/tools/ant/helper/ProjectHelper2.java +++ b/src/main/org/apache/tools/ant/helper/ProjectHelper2.java @@ -699,7 +699,7 @@ public class ProjectHelper2 extends ProjectHelper { // Set the location of the implicit target associated with the project tag context.getImplicitTarget().setLocation(new Location(context.getLocator())); - /** XXX I really don't like this - the XML processor is still + /** TODO I really don't like this - the XML processor is still * too 'involved' in the processing. A better solution (IMO) * would be to create UE for Project and Target too, and * then process the tree and have Project/Target deal with @@ -751,13 +751,13 @@ public class ProjectHelper2 extends ProjectHelper { baseDir = value; } } else { - // XXX ignore attributes in a different NS ( maybe store them ? ) + // TODO ignore attributes in a different NS ( maybe store them ? ) throw new SAXParseException("Unexpected attribute \"" + attrs.getQName(i) + "\"", context.getLocator()); } } - // XXX Move to Project ( so it is shared by all helpers ) + // TODO Move to Project ( so it is shared by all helpers ) String antFileProp = MagicNames.ANT_FILE + "." + context.getCurrentProjectName(); String dup = project.getProperty(antFileProp); diff --git a/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java b/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java index c1d418572..d35fabf1c 100644 --- a/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java +++ b/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java @@ -727,7 +727,7 @@ public class ProjectHelperImpl extends ProjectHelper { if (task == null) { task = new UnknownElement(tag); task.setProject(helperImpl.project); - //XXX task.setTaskType(tag); + //TODO task.setTaskType(tag); task.setTaskName(tag); } task.setLocation(new Location(helperImpl.locator)); diff --git a/src/main/org/apache/tools/ant/launch/Locator.java b/src/main/org/apache/tools/ant/launch/Locator.java index ea30b1be6..2b8ea89ca 100644 --- a/src/main/org/apache/tools/ant/launch/Locator.java +++ b/src/main/org/apache/tools/ant/launch/Locator.java @@ -166,7 +166,7 @@ public final class Locator { * *Will be an absolute path if the given URI is absolute.
* - *Prior to Java 1.4, + *
Prior to Java 1.4, * swallows '%' that are not followed by two characters.
* * See dt-sysid @@ -181,7 +181,7 @@ public final class Locator { public static String fromURI(String uri) { return fromURIJava13(uri); // #buzilla8031: first try Java 1.4. - // XXX should use java.net.URI now that we can rely on 1.4... + // TODO should use java.net.URI now that we can rely on 1.4... // but check for UNC-related regressions, e.g. #42275 // (and remember that \\server\share\file -> file:////server/share/file // rather than -> file://server/share/file as it should; @@ -392,7 +392,7 @@ public final class Locator { * Convert a File to a URL. * File.toURL() does not encode characters like #. * File.toURI() has been introduced in java 1.4, so - * Ant cannot use it (except by reflection) + * Ant cannot use it (except by reflection) * FileUtils.toURI() cannot be used by Locator.java * Implemented this way. * File.toURL() adds file: and changes '\' to '/' for dos OSes diff --git a/src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java b/src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java index 833bb946e..9cfaf5c10 100644 --- a/src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java +++ b/src/main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java @@ -259,7 +259,7 @@ public abstract class AbstractCvsTask extends Task { * @throws BuildException if failonError is set to true and the cvs command fails */ protected void runCommand(Commandline toExecute) throws BuildException { - // XXX: we should use JCVS (www.ice.com/JCVS) instead of + // TODO: we should use JCVS (www.ice.com/JCVS) instead of // command line execution so that we don't rely on having // native CVS stuff around (SM) diff --git a/src/main/org/apache/tools/ant/taskdefs/AbstractJarSignerTask.java b/src/main/org/apache/tools/ant/taskdefs/AbstractJarSignerTask.java index d0b80618e..bc8c03195 100644 --- a/src/main/org/apache/tools/ant/taskdefs/AbstractJarSignerTask.java +++ b/src/main/org/apache/tools/ant/taskdefs/AbstractJarSignerTask.java @@ -262,7 +262,7 @@ public abstract class AbstractJarSignerTask extends Task { // Try to avoid showing password prompts on log output, as they would be confusing. LineContainsRegExp filter = new LineContainsRegExp(); RegularExpression rx = new RegularExpression(); - // XXX only handles English locale, not ja or zh_CN + // TODO only handles English locale, not ja or zh_CN rx.setPattern("^(Enter Passphrase for keystore: |Enter key password for .+: )$"); filter.addConfiguredRegexp(rx); filter.setNegate(true); diff --git a/src/main/org/apache/tools/ant/taskdefs/AntStructure.java b/src/main/org/apache/tools/ant/taskdefs/AntStructure.java index 8cbfc4bd3..1620113cd 100644 --- a/src/main/org/apache/tools/ant/taskdefs/AntStructure.java +++ b/src/main/org/apache/tools/ant/taskdefs/AntStructure.java @@ -288,7 +288,7 @@ public class AntStructure extends Task { ih = IntrospectionHelper.getHelper(p, element); } catch (Throwable t) { /* - * XXX - failed to load the class properly. + * TODO - failed to load the class properly. * * should we print a warning here? */ @@ -433,7 +433,7 @@ public class AntStructure extends Task { final int length = s.length(); for (int i = 0; i < length; i++) { char c = s.charAt(i); - // XXX - we are committing CombiningChar and Extender here + // TODO - we are committing CombiningChar and Extender here if (!Character.isLetterOrDigit(c) && c != '.' && c != '-' && c != '_' && c != ':') { return false; diff --git a/src/main/org/apache/tools/ant/taskdefs/Classloader.java b/src/main/org/apache/tools/ant/taskdefs/Classloader.java index 19d8e5a7e..8183415bc 100644 --- a/src/main/org/apache/tools/ant/taskdefs/Classloader.java +++ b/src/main/org/apache/tools/ant/taskdefs/Classloader.java @@ -178,7 +178,7 @@ public class Classloader extends Task { obj = null; // a new one will be created. } - // XXX maybe use reflection to addPathElement (other patterns ?) + // TODO maybe use reflection to addPathElement (other patterns ?) if (obj != null && !(obj instanceof AntClassLoader)) { log("Referenced object is not an AntClassLoader", Project.MSG_ERR); @@ -235,7 +235,7 @@ public class Classloader extends Task { } } - // XXX add exceptions + // TODO add exceptions } catch (Exception ex) { ex.printStackTrace(); diff --git a/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java b/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java index 70a3dcb72..6f4d94922 100644 --- a/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java +++ b/src/main/org/apache/tools/ant/taskdefs/ExecuteJava.java @@ -154,7 +154,7 @@ public class ExecuteJava implements Runnable, TimeoutObserver { thread = new Thread(this, "ExecuteJava"); Task currentThreadTask = project.getThreadTask(Thread.currentThread()); - // XXX is the following really necessary? it is in the same thread group... + // TODO is the following really necessary? it is in the same thread group... project.registerThreadTask(thread, currentThreadTask); // if we run into a timeout, the run-away thread shall not // make the VM run forever - if no timeout occurs, Ant's @@ -188,7 +188,7 @@ public class ExecuteJava implements Runnable, TimeoutObserver { } catch (SecurityException e) { throw e; } catch (ThreadDeath e) { - // XXX could perhaps also call thread.stop(); not sure if anyone cares + // TODO could perhaps also call thread.stop(); not sure if anyone cares throw e; } catch (Throwable e) { throw new BuildException(e); diff --git a/src/main/org/apache/tools/ant/taskdefs/Jar.java b/src/main/org/apache/tools/ant/taskdefs/Jar.java index 567c33892..91a49fa4b 100644 --- a/src/main/org/apache/tools/ant/taskdefs/Jar.java +++ b/src/main/org/apache/tools/ant/taskdefs/Jar.java @@ -353,7 +353,7 @@ public class Jar extends Zip { try { zf.close(); } catch (IOException e) { - // XXX - log an error? throw an exception? + // TODO - log an error? throw an exception? } } } @@ -392,7 +392,7 @@ public class Jar extends Zip { try { zf.close(); } catch (IOException e) { - // XXX - log an error? throw an exception? + // TODO - log an error? throw an exception? } } } diff --git a/src/main/org/apache/tools/ant/taskdefs/Javadoc.java b/src/main/org/apache/tools/ant/taskdefs/Javadoc.java index 913a4af98..6fc3f9128 100644 --- a/src/main/org/apache/tools/ant/taskdefs/Javadoc.java +++ b/src/main/org/apache/tools/ant/taskdefs/Javadoc.java @@ -2212,7 +2212,7 @@ public class Javadoc extends Task { for (SourceFile sf : sourceFilesToDoc) { String sourceFileName = sf.getFile().getAbsolutePath(); if (useExternalFile) { - // XXX what is the following doing? + // TODO what is the following doing? // should it run if !javadoc4 && executable != null? if (sourceFileName.indexOf(" ") > -1) { String name = sourceFileName; diff --git a/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java b/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java index 5d94bff37..f6181e8b6 100644 --- a/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java +++ b/src/main/org/apache/tools/ant/taskdefs/JikesOutputParser.java @@ -121,7 +121,7 @@ public class JikesOutputParser implements ExecuteStreamHandler { String line; String lower; // We assume, that every output, jikes does, stands for an error/warning - // XXX + // TODO // Is this correct? // TODO: diff --git a/src/main/org/apache/tools/ant/taskdefs/compilers/Jikes.java b/src/main/org/apache/tools/ant/taskdefs/compilers/Jikes.java index 9356b74a1..eac1bcfc6 100644 --- a/src/main/org/apache/tools/ant/taskdefs/compilers/Jikes.java +++ b/src/main/org/apache/tools/ant/taskdefs/compilers/Jikes.java @@ -162,7 +162,7 @@ public class Jikes extends DefaultCompilerAdapter { private void addPropertyParams(Commandline cmd) { /** - * XXX + * TODO * Perhaps we shouldn't use properties for these * three options (emacs mode, warnings and pedantic), * but include it in the javac directive? diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/Native2Ascii.java b/src/main/org/apache/tools/ant/taskdefs/optional/Native2Ascii.java index 291d444d7..2ff92f0ff 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/Native2Ascii.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/Native2Ascii.java @@ -274,7 +274,7 @@ public class Native2Ascii extends MatchingTask { } // Make intermediate directories if needed - // XXX JDK 1.1 doesn't have File.getParentFile, + // TODO JDK 1.1 doesn't have File.getParentFile, String parentName = destFile.getParent(); if (parentName != null) { File parentFile = new File(parentName); diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/jsp/WLJspc.java b/src/main/org/apache/tools/ant/taskdefs/optional/jsp/WLJspc.java index 48b2623e3..0bb28ce4f 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/jsp/WLJspc.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/jsp/WLJspc.java @@ -148,7 +148,7 @@ public class WLJspc extends MatchingTask { File jspFile = null; String parents = ""; int j = 0; - //XXX this array stuff is a remnant of prev trials.. gotta remove. + //TODO this array stuff is a remnant of prev trials.. gotta remove. args[j++] = "-d"; args[j++] = destinationDirectory.getAbsolutePath().trim(); args[j++] = "-docroot"; @@ -169,7 +169,7 @@ public class WLJspc extends MatchingTask { final int size = filesToDo.size(); for (int i = 0; i < size; i++) { - //XXX + //TODO // All this to get package according to weblogic standards // Can be written better... this is too hacky! // Careful.. similar code in scanDir , but slightly different!! @@ -271,7 +271,7 @@ public class WLJspc extends MatchingTask { String pack = ""; for (int i = 0; i < files.length; i++) { File srcFile = new File(this.sourceDirectory, files[i]); - //XXX + //TODO // All this to convert source to destination directory according // to weblogic standards Can be written better... this is too hacky! jspFile = new File(files[i]); diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/junit/JUnitTestRunner.java b/src/main/org/apache/tools/ant/taskdefs/optional/junit/JUnitTestRunner.java index 7cd26abcc..d14074e50 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/junit/JUnitTestRunner.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/junit/JUnitTestRunner.java @@ -290,7 +290,7 @@ public class JUnitTestRunner implements TestListener, JUnitTaskMirror.JUnitTestR boolean showOutput, boolean logTestListenerEvents, ClassLoader loader) { super(); - JUnitTestRunner.filtertrace = filtertrace; // XXX clumsy, should use instance field somehow + JUnitTestRunner.filtertrace = filtertrace; // TODO clumsy, should use instance field somehow this.junitTest = test; this.haltOnError = haltOnError; this.haltOnFailure = haltOnFailure; diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java b/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java index 0b4bff001..9ac230792 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java @@ -2136,7 +2136,7 @@ public class FTP extends Task implements FTPTaskConfig { InputStream instream = null; try { - // XXX - why not simply new File(dir, filename)? + // TODO - why not simply new File(dir, filename)? File file = getProject().resolveFile(new File(dir, filename).getPath()); if (newerOnly && isUpToDate(ftp, file, resolveFile(filename))) { diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/net/FTPTaskMirrorImpl.java b/src/main/org/apache/tools/ant/taskdefs/optional/net/FTPTaskMirrorImpl.java index c8fd88975..7597a2d39 100644 --- a/src/main/org/apache/tools/ant/taskdefs/optional/net/FTPTaskMirrorImpl.java +++ b/src/main/org/apache/tools/ant/taskdefs/optional/net/FTPTaskMirrorImpl.java @@ -1523,7 +1523,7 @@ public class FTPTaskMirrorImpl implements FTPTaskMirror { InputStream instream = null; try { - // XXX - why not simply new File(dir, filename)? + // TODO - why not simply new File(dir, filename)? File file = task.getProject().resolveFile(new File(dir, filename).getPath()); if (task.isNewer() && isUpToDate(ftp, file, resolveFile(filename))) { diff --git a/src/main/org/apache/tools/ant/types/Path.java b/src/main/org/apache/tools/ant/types/Path.java index 5723b2af7..57f5d0804 100644 --- a/src/main/org/apache/tools/ant/types/Path.java +++ b/src/main/org/apache/tools/ant/types/Path.java @@ -601,7 +601,7 @@ public class Path extends DataType implements Cloneable, ResourceCollection { } if (System.getProperty("java.vendor").toLowerCase(Locale.ENGLISH).indexOf("microsoft") >= 0) { - // XXX is this code still necessary? is there any 1.2+ port? + // TODO is this code still necessary? is there any 1.2+ port? // Pull in *.zip from packages directory FileSet msZipFiles = new FileSet(); msZipFiles.setDir(new File(System.getProperty("java.home") diff --git a/src/main/org/apache/tools/ant/types/resources/Union.java b/src/main/org/apache/tools/ant/types/resources/Union.java index be485e6d2..e2f2f9f2b 100644 --- a/src/main/org/apache/tools/ant/types/resources/Union.java +++ b/src/main/org/apache/tools/ant/types/resources/Union.java @@ -116,7 +116,7 @@ public class Union extends BaseResourceCollectionContainer { */ @Deprecated @SuppressWarnings("unchecked") - protected