ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From peterrei...@apache.org
Subject svn commit: r481978 - in /ant/core/trunk: WHATSNEW docs/manual/OptionalTasks/script.html
Date Sun, 03 Dec 2006 23:02:53 GMT
Author: peterreilly
Date: Sun Dec  3 15:02:52 2006
New Revision: 481978

URL: http://svn.apache.org/viewvc?view=rev&rev=481978
Log:
doc for javax scripting

Modified:
    ant/core/trunk/WHATSNEW
    ant/core/trunk/docs/manual/OptionalTasks/script.html

Modified: ant/core/trunk/WHATSNEW
URL: http://svn.apache.org/viewvc/ant/core/trunk/WHATSNEW?view=diff&rev=481978&r1=481977&r2=481978
==============================================================================
--- ant/core/trunk/WHATSNEW (original)
+++ ant/core/trunk/WHATSNEW Sun Dec  3 15:02:52 2006
@@ -4,6 +4,11 @@
 Changes that could break older environments:
 -------------------------------------------
 
+* Initial support for JDK6 scripting <script>.
+  <*script*> will now use javax.scripting if bsf is
+  not available, or if explicilty requested by using
+  a "manager" attribute.
+
 Fixed bugs:
 -----------
 * Directory deletion did not work properly.

Modified: ant/core/trunk/docs/manual/OptionalTasks/script.html
URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/OptionalTasks/script.html?view=diff&rev=481978&r1=481977&r2=481978
==============================================================================
--- ant/core/trunk/docs/manual/OptionalTasks/script.html (original)
+++ ant/core/trunk/docs/manual/OptionalTasks/script.html Sun Dec  3 15:02:52 2006
@@ -26,18 +26,29 @@
 
 <h2><a name="script">Script</a></h2>
 <h3>Description</h3>
-<p>Execute a script in a
-  <a href="http://jakarta.apache.org/bsf" target="_top">Apache BSF</a> supported
language.</p>
-<p><b>Note:</b> This task depends on external libraries not included in
the Ant distribution.
-See <a href="../install.html#librarydependencies">Library Dependencies</a> for
more information.</p>
-<p>All items (tasks, targets, etc) of the running project are
-accessible from the script, using either their <code>name</code> or
-<code>id</code> attributes (as long as their names are considered
-valid Java identifiers, that is).
-This is controlled by the "setbeans" attribute of the task.
-The name "project" is a pre-defined reference to the Project, which can be
-used instead of the project name. The name "self" is a pre-defined reference to the actual
-<code>&lt;script&gt;</code>-Task instance.<br>From these objects
you have access to the Ant Java API, see the
+  <p>Execute a script in a
+    <a href="http://jakarta.apache.org/bsf" target="_top">Apache BSF</a>
+    or
+    <a href="https//scripting.dev.java.net">JSR 233</a>  supported language.
+  </p>
+  <p><b>Note:</b>
+    This task depends on external libraries not included in the Ant distribution.
+    See <a href="../install.html#librarydependencies">Library Dependencies</a>
+    for more information.
+  </p>
+  <p>
+    The task may use the BSF scripting manager or the JSR 233 manager that
+    is included in JDK6 and higher. This is controlled by the <code>manager</code>
+    attribute. The JSR 233 scripting manager is indicated by "javax".
+  </p>
+  <p>All items (tasks, targets, etc) of the running project are
+    accessible from the script, using either their <code>name</code> or
+    <code>id</code> attributes (as long as their names are considered
+    valid Java identifiers, that is).
+    This is controlled by the "setbeans" attribute of the task.
+    The name "project" is a pre-defined reference to the Project, which can be
+    used instead of the project name. The name "self" is a pre-defined reference to the actual
+    <code>&lt;script&gt;</code>-Task instance.<br>From these objects
you have access to the Ant Java API, see the
 <a href="../api/index.html">JavaDoc</a> (especially for
 <a href="../api/org/apache/tools/ant/Project.html">Project</a> and
 <a href="../api/org/apache/tools/ant/taskdefs/optional/Script.html">Script</a>)
for more information.</p>
@@ -63,8 +74,26 @@
   <tr>
     <td valign="top">language</td>
     <td valign="top">The programming language the script is written in.
-      Must be a supported Apache BSF language</td>
+      Must be a supported Apache BSF or JSR 223 language</td>
     <td valign="top" align="center">Yes</td>
+  </tr>
+  <tr>
+    <td valign="top">manager</td>
+    <td valign="top">
+      <em>Since: Ant 1.7. </em>
+      The script engine manager to use. This can have
+      one of three values ("auto", "bsf" or "javax").
+      The default value is "auto".
+      <dl>
+        <li>"bsf" use the BSF scripting manager to run
+          the language.</li>
+        <li>"javax" use the <em>javax.scripting</em> manager
+          to run the language. (This will only work for JDK6 and higher).</li>
+        <li>"auto" use the BSF engine if it exists,
+          otherwise use the <em>javax.scripting</em> manager.</li>
+      </dl>
+    </td>
+    <td valign="top" align="center">No</td>
   </tr>
   <tr>
     <td valign="top">src</td>



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message