Doc patches to javac.html to bring it in to sync with what is in the code
base
-removed references to 'four' adapters; made 'maintenance free' by removing
any count of available adapters
-removed comment at top about running javac in the current VM, as it not
true for many adapters
-documented all the jikes support -the JAVA_HOME dir and all the (till now)
undocumented properties. I left out jikes.class.path as I dont think it adds
anything.
While I am at it, I noticed that the actual contents of JAVA_HOME are being
ignored; jikes must still be on the classpath. Surely that is a very minor
bug?
-Steve
Index: javac.html
===================================================================
RCS file: /home/cvspublic/jakarta-ant/docs/manual/CoreTasks/javac.html,v
retrieving revision 1.10
diff -u -r1.10 javac.html
--- javac.html 2001/08/07 11:53:42 1.10
+++ javac.html 2001/08/13 06:33:06
@@ -9,7 +9,7 @@
<h2><a name="javac">Javac</a></h2>
<h3>Description</h3>
-<p>Compiles a source tree within the running (Ant) VM.</p>
+<p>Compiles a Java source tree.</p>
<p>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.</p>
@@ -29,7 +29,7 @@
href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how
the
inclusion/exclusion of files works, and how to write patterns.</p>
<p>It is possible to use different compilers. This can be selected with the
-"build.compiler" property. There are four choices:</p>
+"build.compiler" property. Here are the choices:-</p>
<ul>
<li>classic (the standard compiler of JDK 1.1/1.2) - javac1.1 and
javac1.2 can be used as aliases</li>
@@ -47,7 +47,7 @@
<li>extJavac (run either modern or classic in a JVM of its own)</li>
</ul>
<p>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 one of the four
+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.
@@ -269,6 +269,58 @@
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 everytime
you call it.</p>
+<h3>Jikes Notes</h3>
+
+If the environment variable <tt>JIKES_HOME</tt> is set to the location
+of the jikes compiler, then the standard Ant invocation scripts
+automatically set build.compiler to "jikes". This enables one to use
+jikes when available, without having to commit the build file to a
+single choice of compiler.
+
+<p>
+
+Jikes also 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 they are all
+'false.
+
+<table border="1" cellpadding="2" cellspacing="0">
+ <tr>
+ <td valign="top">
+ build.compiler.emacs
+ </td>
+ <td valign="top">
+ Enable emacs compatible error messages
+ </td>
+ </tr>
+ <tr>
+ <td valign="top">
+ build.compiler.warnings
+ </td>
+ <td valign="top">
+ disable warning messages
+ </td>
+ </tr>
+ <tr>
+ <td valign="top">
+ build.compiler.pedantic
+ </td>
+ <td valign="top">
+ enable pedantic warnings
+ </td>
+ </tr>
+ <tr>
+ <td valign="top">
+ build.compiler.fulldepend
+ </td>
+ <td valign="top">
+ enable full dependency checking,<br>
+ "+F" in the jikes manual.
+ </td>
+ </tr>
+</table>
<hr>
<p align="center">Copyright © 2000,2001 Apache Software Foundation. All
rights
Reserved.</p>
