Some words of warning - always specify -target and -source or you are lost with JDK 1.5

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@276974 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/CoreTasks/javac.html

@@ -239,7 +239,7 @@ invoking the compiler.</p>
     particular, if you use JDK 1.4+ the generated classes will not be
     usable for a 1.1 Java VM unless you explicitly set this attribute
     to the value 1.1 (which is the default value for JDK 1.1 to
-    1.3).</b></td>
+    1.3).  We highly recommend to always specify this attribute.</b></td>
     <td align="center" valign="top">No</td>
   </tr>
   <tr>
@@ -316,9 +316,11 @@ invoking the compiler.</p>
     running in a 1.3 VM) and <code>jikes</code>.<br> If you use this
     attribute together with <code>jikes</code>, you must make sure
     that your version of jikes supports the <code>-source</code>
-    switch.<br> Legal values are <code>1.3</code>, <code>1.4</code> and <code>1.5</code>
-    &ndash; by default, no <code>-source</code> argument will be used
-    at all.</td>
+    switch.  By default, no <code>-source</code> argument will be used
+    at all.<br>
+    <b>Note that the default value depends on the JVM that is running
+    Ant.  We highly recommend to always specify this
+    attribute.</b></td>
 
     <td align="center" valign="top">No</td>
   </tr>