Author: henrib
Date: Fri Aug 12 13:51:10 2011
New Revision: 1157108
URL: http://svn.apache.org/viewvc?rev=1157108&view=rev
Log:
Documentation update
Modified:
commons/proper/jexl/trunk/RELEASE-NOTES.txt
commons/proper/jexl/trunk/src/site/xdoc/index.xml
commons/proper/jexl/trunk/src/site/xdoc/reference/syntax.xml
Modified: commons/proper/jexl/trunk/RELEASE-NOTES.txt
URL:
http://svn.apache.org/viewvc/commons/proper/jexl/trunk/RELEASE-NOTES.txt?rev=1157108&r1=1157107&r2=1157108&view=diff
==============================================================================
--- commons/proper/jexl/trunk/RELEASE-NOTES.txt (original)
+++ commons/proper/jexl/trunk/RELEASE-NOTES.txt Fri Aug 12 13:51:10 2011
@@ -25,11 +25,12 @@ INTRODUCTION:
=============
JEXL is a library intended to facilitate the implementation of dynamic and
scripting features in
-applications and frameworks.
-JEXL exposes an Expression Language supporting most of the constructs seen in
shell-script and
-ECMAScript with syntactic rules based on some extensions to the JSTL
Expression Language.
-Its goal is to ease the implementation of scripting features usable by
technical operatives or consultants
-working with enterprise products or platforms.
+applications and frameworks written in Java.
+
+JEXL implements an Expression Language based on some extensions to the JSTL
Expression Language supporting most of the
+constructs seen in shell-script or ECMAScript.
+
+Its goal is to expose scripting features usable by technical operatives or
consultants working with enterprise platforms.
http://commons.apache.org/jexl/
@@ -37,12 +38,12 @@ working with enterprise products or plat
What's new in 2.1:
==================
-* A more thorough arithmetic (JexlArithmetic) that allows fine control over
decimals (scale and precision),a
- new syntax for numeric literals (OGNL inspired Big and Huge notations) and a
better handling of keeping the most
- appropriate type in casual operations.
+* A more thorough arithmetic (JexlArithmetic) that allows fine control over
decimals (scale and precision), a
+ new syntax for numeric literals (OGNL inspired Big and Huge notations) and a
better type handling keeping the most
+ appropriate representation in casual operations.
* The introduction of script variables and parameters that reduce context
dependencies and methods that allow some
- checks performed after script creation (light static checking hints).
-* A sandoxing feature to restrict what JEXL can access from the environment
allowing tighter control over security.
+ checks performed after script creation (light static checking hints). Plus
the ability to call script from scripts.
+* A sandoxing feature to restrict and rename what JEXL can access from the
environment allowing tighter control over security.
New features in 2.1:
====================
Modified: commons/proper/jexl/trunk/src/site/xdoc/index.xml
URL:
http://svn.apache.org/viewvc/commons/proper/jexl/trunk/src/site/xdoc/index.xml?rev=1157108&r1=1157107&r2=1157108&view=diff
==============================================================================
--- commons/proper/jexl/trunk/src/site/xdoc/index.xml (original)
+++ commons/proper/jexl/trunk/src/site/xdoc/index.xml Fri Aug 12 13:51:10 2011
@@ -26,16 +26,23 @@
<p>
JEXL is a library intended to facilitate the implementation of dynamic and
scripting features in
applications and frameworks written in Java.
-JEXL exposes an Expression Language supporting most of the constructs seen in
shell-script or
-ECMAScript based on some extensions to the JSTL Expression Language.
+</p>
+<p>
+JEXL implements an Expression Language based on some extensions to the JSTL
Expression Language supporting most of the
+constructs seen in shell-script or ECMAScript.
+<br/>
Its goal is to expose scripting features usable by technical operatives or
consultants
working with enterprise platforms.
</p>
<p>
- It is a small footprint "glueing" API
+ The library exposes a small footprint API
- the <a
href="apidocs/org/apache/commons/jexl2/package-summary.html#usage">core
features</a> fit in
3 classes and 10 methods - that can be used in various conditions:
<ul>
+ <li>Scripting features:
+ <ul><li>Your application lets (advanced) users
evaluate or define some simple expressions
+ like computation formulas.</li></ul>
+ </li>
<li>Module or component configuration:
<ul>
<li>Your application has configuration files
(eventually generated by a design module)
@@ -53,10 +60,6 @@ working with enterprise platforms.
strongly depend upon.</li>
</ul>
</li>
- <li>Scripting features:
- <ul><li>Your application lets (advanced) users
evaluate or define some simple expressions
- like computation formulas.</li></ul>
- </li>
<li>Simple template capabilities:
<ul><li>Your application has basic template
requirements and JSPs or
Velocity would be overkill or too inconvenient to
deploy.</li></ul>
@@ -69,7 +72,7 @@ working with enterprise platforms.
and JavaServer Pages version 2.0 (JSP).
JEXL 2.0 added features inspired by
<a
href="http://java.sun.com/products/jsp/reference/techart/unifiedEL.html";>Unified
EL</a>.
- Overall, the syntax is now close to a mix of ECMAScript and
"shell-script"
+ The syntax is now close to a mix of ECMAScript and "shell-script"
making it easy to master by technical operatives or consultants.
The objects exposed and their behavior
obviously need to be documented though...
</p>
Modified: commons/proper/jexl/trunk/src/site/xdoc/reference/syntax.xml
URL:
http://svn.apache.org/viewvc/commons/proper/jexl/trunk/src/site/xdoc/reference/syntax.xml?rev=1157108&r1=1157107&r2=1157108&view=diff
==============================================================================
--- commons/proper/jexl/trunk/src/site/xdoc/reference/syntax.xml (original)
+++ commons/proper/jexl/trunk/src/site/xdoc/reference/syntax.xml Fri Aug 12
13:51:10 2011
@@ -81,7 +81,8 @@
<code>or and eq ne lt gt le ge div mod not null true false new
var return</code>
For example, the following is invalid:
<source>my.new.dotted.var // invalid ('new' is keyword)</source>
- In such cases, the [ ] operator can be used, for example:
+ In such cases, quoted identifiers or the [ ] operator can be
used, for example:
+ <source>my.'new'.dotted.var</source>
<source>my['new'].dotted.var</source>
</p>
</td>
