From 923355ba638e2035b7c6c1090b6b9b798745d849 Mon Sep 17 00:00:00 2001 From: Jan Materne Date: Thu, 6 Jul 2006 06:36:44 +0000 Subject: [PATCH] Examples for specifying a JDK in and . git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@419463 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/CoreTasks/java.html | 32 ++++++++++++++++++++++---------- docs/manual/CoreTasks/javac.html | 17 ++++++++++++++--- 2 files changed, 36 insertions(+), 13 deletions(-) diff --git a/docs/manual/CoreTasks/java.html b/docs/manual/CoreTasks/java.html index 9954eebb9..3315c99aa 100644 --- a/docs/manual/CoreTasks/java.html +++ b/docs/manual/CoreTasks/java.html @@ -241,9 +241,9 @@ been revoked) the System.exit() call will be intercepted and treated like indicated in failonerror.

Note:
If you do not specify permissions, -a set of default permissions will be added to your Java invocation to make +a set of default permissions will be added to your Java invocation to make sure that the ant run will continue or terminated as indicated by -failonerror. All permissions not granted per default will be +failonerror. All permissions not granted per default will be checked by whatever security manager was already in place. exitVM will be disallowed.

@@ -256,7 +256,7 @@ disallowed.

You can control enablement of Java 1.4 assertions with an <assertions> subelement.

- +

Assertion statements are currently ignored in non-forked mode.

since Ant 1.6.

@@ -340,13 +340,13 @@ and with a maximum memory of 128MB. Any non zero return code breaks the build. </classpath> </java> - Run the JAR dist/test.jar relative to the directory ${exec.dir}, this being the same directory into which the JVM -is to start up. - +is to start up. 
  <java classname="test.Main"/>
+Runs a given class with the current classpath. + 
   <java classname="test.Main"
         fork="yes" >
@@ -355,12 +355,24 @@ is to start up.
     <jvmarg value="-Xrunhprof:cpu=samples,file=log.txt,depth=3"/>
   </java>
-Note: you can not specify the (highly deprecated) MSJVM, "jview.exe" as the +Add system properties and JVM-properties to the JVM as in +java ="-Xrunhprof:cpu=samples,file=log.txt,depth=3 -DDEBUG=true test.Main + +
  <java classname="ShowJavaVersion" classpath="."
+        jvm="path-to-java14-home/bin/java" fork="true"
+        taskname="java1.4" >
+
+Use a given Java implementation (another the one Ant is currently using) to run the class. +For documentation in the log taskname is used to change the [java] +log-prefix to [java1.4]. + + +

Note: you can not specify the (highly deprecated) MSJVM, "jview.exe" as the JVM, as it takes different parameters for other JVMs, -That JVM can be started from <exec> if required. +That JVM can be started from <exec> if required.

-

Copyright © 2000-2005 The Apache Software Foundation. All rights +

Copyright © 2000-2006 The Apache Software Foundation. All rights Reserved.

- + \ No newline at end of file diff --git a/docs/manual/CoreTasks/javac.html b/docs/manual/CoreTasks/javac.html index f91ffae65..cd9b3a1bd 100644 --- a/docs/manual/CoreTasks/javac.html +++ b/docs/manual/CoreTasks/javac.html @@ -34,7 +34,7 @@ attributes. With the includes or 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 +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 <src> element(s), or by using wildcard patterns. See the section on @@ -369,7 +369,7 @@ supports all attributes of <fileset> (dir becomes srcdir) as well as the nested <include>, <exclude> and <patternset> elements.

-

src, classpath, sourcepath, +

src, classpath, sourcepath, bootclasspath and extdirs

<javac>'s srcdir, classpath, sourcepath, bootclasspath, and @@ -540,6 +540,18 @@ directory but skip the examples. The compiler will even produce errors if some o the non-example files refers to them.

+

+If you wish to compile with a special JDK (another than the one Ant is currently using), +set the executable and fork attribute. Using taskname +could show in the log, that these settings are fix. +

  <javac srcdir="." 
+         destdir="." 
+         executable="path-to-java14-home/bin/javac" 
+         fork="true"
+         taskname="javac1.4" />
+

+ +

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.

@@ -628,4 +640,3 @@ All rights Reserved.

-