commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hen...@apache.org
Subject svn commit: r1157108 - in /commons/proper/jexl/trunk: RELEASE-NOTES.txt src/site/xdoc/index.xml src/site/xdoc/reference/syntax.xml
Date Fri, 12 Aug 2011 13:51:10 GMT
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>



Mime
View raw message