diff --git a/src/main/org/apache/tools/ant/launch/Launcher.java b/src/main/org/apache/tools/ant/launch/Launcher.java index 4009e0c11..da4031d3b 100644 --- a/src/main/org/apache/tools/ant/launch/Launcher.java +++ b/src/main/org/apache/tools/ant/launch/Launcher.java @@ -27,57 +27,66 @@ import java.util.Iterator; /** - * This is a launcher for Ant. + * This is a launcher for Ant. * * @since Ant 1.6 */ public class Launcher { + /** - * Ant home directory - * Value : {@value} + * The Ant Home (installation) Directory property. + * {@value} */ public static final String ANTHOME_PROPERTY = "ant.home"; - /** The Ant Library Directory property */ + /** + * The Ant Library Directory property. + * {@value} + */ public static final String ANTLIBDIR_PROPERTY = "ant.library.dir"; - /** - * The directory name of the per-user ant directory + /** + * The directory name of the per-user ant directory. * {@value} */ public static final String ANT_PRIVATEDIR = ".ant"; /** - * The name of a per-user library directory + * The name of a per-user library directory. * {@value} */ public static final String ANT_PRIVATELIB = "lib"; - /** The location of a per-user library directory - * {@value} + /** + * The location of a per-user library directory. + *

+ * It's value is the concatenation of {@link #ANT_PRIVATEDIR} + * with {@link #ANT_PRIVATELIB}, with an appropriate file separator + * in between. For example, on Unix, it's .ant/lib. */ - public static final String USER_LIBDIR = + public static final String USER_LIBDIR = ANT_PRIVATEDIR + File.separatorChar + ANT_PRIVATELIB; - /** - * The startup class that is to be run + /** + * The startup class that is to be run. * {@value} */ public static final String MAIN_CLASS = "org.apache.tools.ant.Main"; + /** - * system property with user home directory + * System property with user home directory. * {@value} */ public static final String USER_HOMEDIR = "user.home"; /** - * System property of + * System property with application classpath. * {@value} */ private static final String JAVA_CLASS_PATH = "java.class.path"; /** - * Entry point for starting command line Ant + * Entry point for starting command line Ant. * * @param args commandline arguments */ @@ -93,16 +102,17 @@ public class Launcher { } /** - * Add a CLASSPATH or -lib to lib path urls. - * @param path the classpath or lib path to add to the libPathULRLs - * @param getJars if true and a path is a directory, add the jars in - * the directory to the path urls - * @param libPathURLs the list of paths to add to - */ + * Add a CLASSPATH or -lib to lib path urls. + * + * @param path the classpath or lib path to add to the libPathULRLs + * @param getJars if true and a path is a directory, add the jars in + * the directory to the path urls + * @param libPathURLs the list of paths to add to + */ private void addPath(String path, boolean getJars, List libPathURLs) - throws MalformedURLException { + throws MalformedURLException { StringTokenizer myTokenizer - = new StringTokenizer(path, System.getProperty("path.separator")); + = new StringTokenizer(path, File.pathSeparator); while (myTokenizer.hasMoreElements()) { String elementName = myTokenizer.nextToken(); File element = new File(elementName); @@ -122,14 +132,15 @@ public class Launcher { } /** - * Run the launcher to launch Ant + * Run the launcher to launch Ant. * * @param args the command line arguments * * @exception MalformedURLException if the URLs required for the classloader * cannot be created. */ - private void run(String[] args) throws LaunchException, MalformedURLException { + private void run(String[] args) + throws LaunchException, MalformedURLException { String antHomeProperty = System.getProperty(ANTHOME_PROPERTY); File antHome = null; @@ -273,5 +284,5 @@ public class Launcher { t.printStackTrace(); } } -} +}