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><script></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><script></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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
