From f9ddec7b87382f81161818966776347a4809cd2e Mon Sep 17 00:00:00 2001 From: Diane Holt Date: Wed, 17 Jan 2001 21:21:27 +0000 Subject: [PATCH] Fix a few things that jumped out at me when Stefan put the Javac change through. (And verify I can really commit!) git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268475 13f79535-47bb-0310-9956-ffa450edef68 --- docs/index.html | 101 +++++++++++++++++++++++++----------------------- 1 file changed, 53 insertions(+), 48 deletions(-) diff --git a/docs/index.html b/docs/index.html index f236ec0e0..efa2dd3d5 100644 --- a/docs/index.html +++ b/docs/index.html @@ -3205,9 +3205,9 @@ inclusion/exclusion of files works, and how to write patterns.

  • jvc (the Command-Line Compiler from Microsoft's SDK for Java / Visual J++)
    • -

    For JDK 1.1/1.2 is classic the default. For JDK 1.3 is modern the default. -If you whish to use a different compiler interface then one of the four -supplied, then write a class that implements the CompilerAdapter interface +

    For JDK 1.1/1.2, classic is the default. For JDK 1.3, modern is the default. +If you wish to use a different compiler interface than one of the four +supplied, write a class that implements the CompilerAdapter interface (package org.apache.tools.ant.taskdefs.compilers). Supply the full classname in the "build.compiler" property.

    @@ -3225,37 +3225,37 @@ classname in the "build.compiler" property. destdir - location where to store the class files. + location to store the class files. No includes - comma separated list of patterns of files that must be - included. All files are included when omitted. + comma-separated list of patterns of files that must be + included; all files are included when omitted. No includesfile - the name of a file. Each line of this file is - taken to be an include pattern + the name of a file that contains + include patterns. No excludes - comma separated list of patterns of files that must be - excluded. No files (except default excludes) are excluded when omitted. + comma-separated list of patterns of files that must be + excluded; no files (except default excludes) are excluded when omitted. No excludesfile - the name of a file. Each line of this file is - taken to be an exclude pattern + the name of a file that contains + exclude patterns. No defaultexcludes - indicates whether default excludes should be used or not - ("yes"/"no"). Default excludes are used when omitted. + indicates whether default excludes should be used + (yes | no); default excludes are used when omitted. No @@ -3270,14 +3270,14 @@ classname in the "build.compiler" property. classpathref - the classpath to use, given as reference to a PATH defined elsewhere. + the classpath to use, given as a + reference to a PATH defined elsewhere. No bootclasspathref - location of bootstrap class files, given as by reference to a PATH defined elsewhere. + location of bootstrap class files, given as a + reference to a PATH defined elsewhere. No @@ -3292,26 +3292,26 @@ classname in the "build.compiler" property. debug - indicates whether there should be compiled with debug - information ("off"). + indicates whether source should be compiled with debug + information; defaults to off. No optimize - indicates whether there should be compiled with - optimization ("off"). + indicates whether source should be compiled with + optimization; defaults to off. No deprecation - indicates whether there should be compiled with deprecation - information ("off"). + indicates whether source should be compiled with + deprecation information; defaults to off. No target - Generate class files for specific VM version, e.g. - "1.1" or "1.2". + generate class files for specific VM version (e.g., + 1.1 or 1.2). No @@ -3320,26 +3320,25 @@ classname in the "build.compiler" property. No - depend enables dependency - tracking for compilers that support this (jikes and classic) + depend enables dependency-tracking + for compilers that support this (jikes and classic) No includeAntRuntime - whether or not to include the ant runtime libraries. - Default is no. + whether to include the Ant run-time libraries; + defaults to no. No includeJavaRuntime - whether or not to include the default runtime - libraries from the executing virtual machine. Default is no. + whether to include the default run-time + libraries from the executing VM; defaults to no. No failonerror - If set to false, the build will continue even if there are compilation errors. - Defaults to true. + indicates whether the build will continue even if there are compilation errors; defaults to true. No @@ -3351,12 +3350,14 @@ supports all attributes of <fileset> (dir becomes srcdir) as well as the nested <include>, <exclude> and <patternset> elements.

    -

    src, classpath, bootclasspath and extdirs

    +

    src, classpath, bootclasspath and extdirs

    Javac's srcdir, classpath, bootclasspath and extdirs attributes are PATH like structure and can also be set via nested -src, classpath, bootclasspath and -extdirs elements respectively.

    +href="#path">path-like structures and can also be set via nested +<src>, +<classpath>, +<bootclasspath> and +<extdirs> elements, respectively.

    Examples

      <javac srcdir="${src}"
@@ -3364,8 +3365,9 @@ href="#path">PATH like structure and can also be set via nested
          classpath="xyz.jar"
          debug="on"
   />
    -

    compiles all .java files under the directory ${src}, and stores -the .class files in the directory ${build}. +

    compiles all .java files under the ${src} +directory, and stores +the .class files in the ${build} directory. The classpath used contains xyz.jar, and debug information is on.

      <javac srcdir="${src}"
          destdir="${build}"
@@ -3374,12 +3376,13 @@ The classpath used contains xyz.jar, and debug information is on.
-
    compiles .java files under the directory ${src}, and stores the
-.class files in the directory ${build}. 
+
    compiles .java files under the ${src}
+directory, and stores the
+.class files in the ${build} directory.
 The classpath used contains xyz.jar, and debug information is on.
 Only files under mypackage/p1 and mypackage/p2 are
 used. Files in the mypackage/p1/testpackage directory are excluded
-form compilation and copy.
    
+from compilation.
    
 
 
      <javac srcdir="${src}:${src2}"
          destdir="${build}"
@@ -3389,8 +3392,10 @@ form compilation and copy.
    
          debug="on"
   />
    
 
-
    is the same as the previous example with the addition of a second source path, defined by
-the propery src2. This can also be represented using nested elements as follows
+
    is the same as the previous example, with the addition of a second
+source path, defined by
+the property src2. This can also be represented using nested
+<src> elements as follows:
 
 
      <javac destdir="${build}"
          classpath="xyz.jar"
@@ -3402,9 +3407,9 @@ the propery src2. This can also be represented using nested element
     <exclude name="mypackage/p1/testpackage/**"/>
   </javac>
    
 
-
    Note: If you are using Ant on Windows and a new DOS-Window pops up
-for every use of an external compiler this may be a problem of the JDK you are using.
-This problem may occur with all JDK's < 1.2.
    
+
    Note: If you are using Ant on Windows and a new DOS window pops up
+for every use of an external compiler, this may be a problem of the JDK you are using.
+This problem may occur with all JDKs < 1.2.
    
 
 
    
 
    Javadoc/Javadoc2