diff --git a/docs/manual/CoreTasks/javac.html b/docs/manual/CoreTasks/javac.html index 23dd77587..5dae4f78b 100644 --- a/docs/manual/CoreTasks/javac.html +++ b/docs/manual/CoreTasks/javac.html @@ -11,56 +11,84 @@
Compiles a Java source tree.
The source and destination directory will be recursively scanned for Java -source files to compile. Only Java files that have no corresponding class file -or where the class file is older than the java file will be compiled.
+source files to compile. Only Java files that have no corresponding +.class
file
+or where the class file is older than the
+.java
file will be compiled.
Note: Ant uses only the names of the source and class files to find -the classes that need a rebuild. It will not scan the source and therefor +the classes that need a rebuild. It will not scan the source and therefore will have no knowledge about nested classes, classes that are named different -from the source file and so on.
-The directory structure of the source tree should follow the package
+from the source file, and so on. See the
+<depend>
task
+for dependency checking based on other than just
+existence/modification times.
+
When the source files are part of a package, the directory structure of +the source tree should follow the package hierarchy.
-It is possible to refine the set of files that are being compiled/copied. -This can be done with the includes, includesfile, excludes, excludesfile and defaultexcludes -attributes. With the includes or includesfile attribute you specify the files you want to -have included by using patterns. The exclude or excludesfile attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the defaultexcludes attribute, you can specify whether you -want to use default exclusions or not. See the section on directory based tasks, on how the -inclusion/exclusion of files works, and how to write patterns.
-It is possible to use different compilers. This can be selected with the -"build.compiler" property or the compiler attribute. Here are the choices:-
+It is possible to refine the set of files that are being compiled.
+This can be done with the includes
, includesfile
,
+excludes
, excludesfile
,
+and defaultexcludes
+attributes. With the includes
or
+includesfile
attribute, you specify the files you want to
+have included.
+The exclude
or excludesfile
attribute is used
+to specify
+the files you want to have excluded. In both cases, the list of files
+can be specified by either the filename, relative to the directory(s) specified
+in the srcdir
attribute or nested
It is possible to use different compilers. This can be specified by
+either setting the global build.compiler
property, which will
+affect all <javac>
tasks throughout the build, or by
+setting the compiler
attribute, specific to the current
+<javac>
task.
+Valid values for either the
+build.compiler
property or the compiler
+attribute are:
classic
(the standard compiler of JDK 1.1/1.2) –
+ javac1.1
and
+ javac1.2
can be used as aliases.modern
(the standard compiler of JDK 1.3/1.4) –
+ javac1.3
and
+ javac1.4
can be used as aliases.jikes
(the Jikes
- compiler)jvc
(the Command-Line Compiler from Microsoft's SDK
+ for Java / Visual J++) – microsoft
can be used
+ as an alias.kjc
(the kopi
+ compiler).gcj
(the gcj compiler from gcc).sj
(Symantec java compiler) –
+ symantec
can be used as an alias.extJavac
(run either modern or classic in a JVM of
+ its own).For JDK 1.1/1.2, classic is the default. For JDK 1.3/1.4, modern is the default. + +
For JDK 1.1/1.2, classic
is the default.
+For JDK 1.3/1.4, modern
is the default.
If you wish to use a different compiler interface than those
-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.
+supplied, you can write a class that implements the CompilerAdapter interface
+(package org.apache.tools.ant.taskdefs.compilers
). Supply the full
+classname in the build.compiler
property or the
+compiler
attribute.
The fork attribute overrides the build.compiler setting and expects -a JDK1.1 or higher to be set in java.home. +
The fork attribute overrides the build.compiler
property
+or compiler
attribute setting and
+expects a JDK1.1 or higher to be set in JAVA_HOME
.
This task will drop all entries that point to non-existent -files/directories from the CLASSPATH it passes to the compiler.
+files/directories from the classpath it passes to the compiler.Windows Note:When the modern compiler is used
in unforked mode on Windows, it locks up the files present in the
-classpath of the <javac> task, and does not release them. The side
-effect of this is that you will not be able to delete or move
+classpath of the <javac>
task, and does not release them.
+The side effect of this is that you will not be able to delete or move
those files later on in the build. The workaround is to fork when
invoking the compiler.
<src>
elements are present..java
files are included when omitted.yes
| no
); default excludes are used when omitted.<src>
elements).
+ <src>
elements).
To suppress the sourcepath switch, use sourcepath=""
.off
.-nowarn
switch
+ should be passed to the compiler; defaults to off
.off
.-g
+ command-line switch. This will be ignored by all implementations except
+ modern
and classic(ver >= 1.2)
.
+ Legal values are none
or a comma-separated list of the
+ following keywords:
+ lines
, vars
, and source
.
+ If debuglevel
is not specified, by default,
+ :none
will be
+ appended to -g
. If debug
is not turned on,
+ this attribute will be ignored.
+ off
.off
.1.1
or 1.2
).jikes
and
+ classic
).yes
.yes
.no
.yes
.no
. You can also give a
- complete path to the javac executable to use instead of
- yes
, which would run the compiler of the Java
- vesrion that is currently running Ant.javac
using the
+ JDK compiler externally; defaults to no
. You can also
+ give a complete path to the javac
executable to use
+ instead of yes
, which would run the compiler of the Java
+ version that is currently running Ant.83886080
, 81920k
, or 80m
)javac
is run externally; ignored otherwise. Defaults
+ to the standard VM memory setting.
+ (Examples: 83886080
, 81920k
, or
+ 80m
)83886080
, 81920k
, or 80m
)javac
is run externally; ignored otherwise. Defaults
+ to the standard VM memory setting.
+ (Examples: 83886080
, 81920k
, or
+ 80m
)true
.
+ Indicates whether the build will continue even if there are compilation errors; defaults to true
.
-source
command line
- switch, will be ignored by all implementations except
- modern
, legal values are "1.3" and
- "1.4" - by default, no -source
argument
+ -source
command-line
+ switch; will be ignored by all implementations except
+ modern
. Legal values are 1.3
and
+ 1.4
– by default, no -source
argument
will be used at all.-g
command line
- switch. This will be ignored by all implementations except
- modern
and classic(ver >= 1.2)
, legal values are
- "none" or a comma separated list of the following keywords.
- Valid keywords are "lines", "vars" and "source"
- - if debuglevel is not specified, by default, nothing will be
- appended to -g
. If debug is not turned on, this attribute will be
- ignored.
- build.compiler
property, if set, will be used.
+ Otherwise, the default compiler for the current VM will be used.
+ (See the above list of valid
+ compilers.)build.compiler
property.no
.<fileset>
<patternset>
elements.
src
, classpath
, sourcepath
,
bootclasspath
and extdirs
Javac
's srcdir, classpath,
-sourcepath, bootclasspath and extdirs attributes are path-like structures and can also be set via nested
+
<javac>
's srcdir
, classpath
,
+sourcepath
, bootclasspath
, and
+extdirs
attributes are
+path-like structures
+and can also be set via nested
<src>
,
<classpath>
,
<sourcepath>
,
@@ -300,7 +345,8 @@ used.
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.
xyz.jar
, and compiling with
+debug information is on.
<javac srcdir="${src}" destdir="${build}" @@ -339,7 +388,7 @@ The classpath used containsxyz.jar
, and debug information is on.compiles all
+compiler using the default.java
files under the${src}
directory, and stores the.class
files in the${build}
directory. This will fork off the javac -compiler using the default javac executable.javac
executable.<javac srcdir="${src}" destdir="${build}" @@ -348,7 +397,7 @@ compiler using the default javac executable.compiles all
.java
files under the${src}
directory, and stores the.class
files in the${build}
directory. This will fork off the javac -compiler using the executable namedjava$javac.exe
. Note +compiler, using the executable namedjava$javac.exe
. Note that the$
sign needs to be escaped by a second one.<javac srcdir="${src}" @@ -361,10 +410,10 @@ that the$
sign needs to be escaped by a second one.compiles
+used. All files in and below the.java
files under the${src}
directory, and stores the.class
files in the${build}
directory. -The classpath used containsxyz.jar
, and debug information is on. +The classpath used includesxyz.jar
, and debug information is on. Only files undermypackage/p1
andmypackage/p2
are -used. Files in themypackage/p1/testpackage
directory are excluded -from compilation.mypackage/p1/testpackage
+directory are excluded from compilation.<javac srcdir="${src}:${src2}" destdir="${build}" @@ -389,64 +438,95 @@ the property-src2
. This can also be represented using nested <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 JDKs < 1.2.
+Note: +If you wish to compile only source files located in certain packages below a +common root, use the
-include
/exclude
attributes +or<include>
/<exclude>
nested elements +to filter for these packages. Do not include part of your package structure +in thesrcdir
attribute +(or nested<src>
elements), or Ant will recompile your +source files every time you run your compile target. See the +Ant FAQ +for additional information.Note: If you wish to compile only source-files located in some packages below a -common root you should not include these packages in the srcdir-attribute. Use include/exclude-attributes -or elements to filter for these packages. If you include part of your package-structure inside the srcdir-attribute -(or nested src-elements) Ant will start to recompile your sources every time you call it.
+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.
Jikes Notes
Jikes supports some extra options, which can be set be defining -properties prior to invoking the task. The ant developers are aware that -this is ugly and inflexible -expect a better solution in the future. All -the options are boolean, and must be set to "true" or "yes" to be -interpreted as anything other than false; by default -build.compiler.warnings is "true" while all others are "false" +the properties shown below prior to invoking the task. The setting +for each property will be in affect for all<javac>
+tasks throughout the build. +The Ant developers are aware that +this is ugly and inflexible – expect a better solution in the future. +All the options are boolean, and must be set totrue
or +yes
to be +interpreted as anything other than false. By default, +build.compiler.warnings
istrue
, +while all others arefalse
.
Property | +Description | +Default | +
build.compiler.emacs | - Enable emacs compatible error messages + Enable emacs-compatible error messages. | +
+ false
+ |
- build.compiler.warnings - This property has been deprecated, use the nowarn attribute - instead + build.compiler.fulldepend |
- don't disable warning messages
+ Enable full dependency checking; see + the +F switch in the Jikes manual.
|
+
+ false
+ |
build.compiler.pedantic | - enable pedantic warnings + Enable pedantic warnings. | +
+ false
+ |
- build.compiler.fulldepend
+ build.compiler.warnings + Deprecated. Use + <javac> 's nowarn
+ attribute instead.
|
- enable full dependency checking, - "+F" in the jikes manual. + Don't disable warning messages. |
+
+ true
+ |
Copyright © 2001-2002 Apache Software Foundation. All rights -Reserved.
+Copyright © 2001-2002 Apache Software Foundation. +All rights Reserved.