svn commit: r491723 - in /ant/core/trunk/docs/manual: CoreTasks/javac.html using.html

[peterreilly]

Author: peterreilly
Date: Mon Jan  1 16:22:43 2007
New Revision: 491723

URL: http://svn.apache.org/viewvc?view=rev&rev=491723
Log:
a note on using 3344{toString:} for path references

Modified:
    ant/core/trunk/docs/manual/CoreTasks/javac.html
    ant/core/trunk/docs/manual/using.html

Modified: ant/core/trunk/docs/manual/CoreTasks/javac.html
URL: 
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/CoreTasks/javac.html?view=diff&rev=491723&r1=491722&r2=491723
==============================================================================
--- ant/core/trunk/docs/manual/CoreTasks/javac.html (original)
+++ ant/core/trunk/docs/manual/CoreTasks/javac.html Mon Jan  1 16:22:43 2007
@@ -173,7 +173,11 @@
   </tr>
   <tr>
     <td valign="top">bootclasspath</td>
-    <td valign="top">Location of bootstrap class files.</td>
+    <td valign="top">
+      Location of bootstrap class files. (See <a href="#bootstrap">below</a>
+      for using the -X and -J-X parameters for specifing
+      the bootstrap classpath).
+    </td>
     <td align="center" valign="top">No</td>
   </tr>
   <tr>
@@ -683,6 +687,29 @@
 <p>Jvc will enable Microsoft extensions unless you set the property
 <code>build.compiler.jvc.extensions</code> to false before invoking
 <code>&lt;javac&gt;</code>.</p>
+
+<h3><a name="bootstrap">Bootstrap Options</h3>
+<p>
+  The Sun javac compiler has a <em>bootclasspath</em> command
+  line option - this corresponds to the "bootclasspath" attribute/element
+  of the &lt;javac&gt; task. The Sun compiler also allows more
+  control over the boot classpath using the -X and -J-X attributes.
+  One can set these by using the &lt;compilerarg&gt;. Since Ant 1.6.0,
+  there is a shortcut to convert path references to strings that
+  can by used in an OS independent fashion (see
+  <a href="../using.html#pathshortcut">pathshortcut</a>). For example:
+</p>
+<pre>
+  &lt;path id="lib.path.ref"&gt;
+    &lt;fileset dir="lib" includes="*.jar"/&gt;
+  &lt;/path&gt;
+  &lt;javac srcdir="src" destdir="classes"&gt;
+    &lt;compilerarg arg="-Xbootstrap/p:${toString:lib.path.ref}"/&gt;
+  &lt;/javac&gt;
+</pre>
+
+  
+</p>
 
 <h3>OpenJDK Notes</h3>
 <p>

Modified: ant/core/trunk/docs/manual/using.html
URL: 
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/using.html?view=diff&rev=491723&r1=491722&r2=491723
==============================================================================
--- ant/core/trunk/docs/manual/using.html (original)
+++ ant/core/trunk/docs/manual/using.html Mon Jan  1 16:22:43 2007
@@ -494,6 +494,24 @@
     &lt;path id=&quot;base.path&quot; path=&quot;${classpath}&quot;/&gt;
 </pre>
 
+  <h4><a name="pathshortcut">Path Shortcut</a></h4>
+  <p>
+    In Ant 1.6 a shortcut for converting paths to OS specific strings
+    in properties has been added. One can use the expression 
+    ${toString:<em>pathreference</em>} to convert a path element
+    reference to a string that can be used for a path argument.
+    For example:
+  </p>
+<pre>
+  &lt;path id="lib.path.ref"&gt;
+    &lt;fileset dir="lib" includes="*.jar"/&gt;
+  &lt;/path&gt;
+  &lt;javac srcdir="src" destdir="classes"&gt;
+    &lt;compilerarg arg="-Xbootstrap/p:${toString:lib.path.ref}"/&gt;
+  &lt;/javac&gt;
+</pre>
+
+
 <h3><a name="arg">Command-line Arguments</a></h3>
 <p>Several tasks take arguments that will be passed to another
 process on the command line. To make it easier to specify arguments



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]