This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-jexl.git
The following commit(s) were added to refs/heads/master by this push:
new 792570d9 Javadoc
792570d9 is described below
commit 792570d9944fff297c9036a5c10ea298afa49bcb
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 09:08:53 2026 -0400
Javadoc
---
.../org/apache/commons/jexl3/JexlArithmetic.java | 48 +++++++++++-----------
.../java/org/apache/commons/jexl3/JexlBuilder.java | 4 +-
.../org/apache/commons/jexl3/JexlConfigLoader.java | 6 +--
.../java/org/apache/commons/jexl3/JexlContext.java | 2 +-
.../java/org/apache/commons/jexl3/JexlEngine.java | 10 ++---
.../org/apache/commons/jexl3/JexlException.java | 6 +--
.../org/apache/commons/jexl3/JexlFeatures.java | 8 ++--
.../java/org/apache/commons/jexl3/JexlInfo.java | 2 +-
.../java/org/apache/commons/jexl3/JexlOptions.java | 2 +-
.../java/org/apache/commons/jexl3/JxltEngine.java | 2 +-
.../commons/jexl3/internal/ArrayBuilder.java | 2 +-
.../org/apache/commons/jexl3/internal/Engine.java | 8 ++--
.../org/apache/commons/jexl3/internal/Frame.java | 2 +-
.../commons/jexl3/internal/IntegerRange.java | 2 +-
.../commons/jexl3/internal/InterpreterBase.java | 2 +-
.../apache/commons/jexl3/internal/LongRange.java | 2 +-
.../apache/commons/jexl3/internal/Operator.java | 6 +--
.../apache/commons/jexl3/internal/SoftCache.java | 2 +-
.../commons/jexl3/internal/TemplateEngine.java | 6 +--
.../internal/introspection/AbstractExecutor.java | 4 +-
.../jexl3/internal/introspection/ClassMisc.java | 2 +-
.../internal/introspection/ConstructorMethod.java | 2 +-
.../jexl3/internal/introspection/IndexedType.java | 2 +-
.../internal/introspection/MethodExecutor.java | 2 +-
.../jexl3/internal/introspection/MethodKey.java | 4 +-
.../jexl3/internal/introspection/Uberspect.java | 6 +--
.../jexl3/introspection/JexlPermissions.java | 6 +--
.../commons/jexl3/introspection/JexlSandbox.java | 6 +--
.../commons/jexl3/introspection/JexlUberspect.java | 18 ++++----
.../commons/jexl3/parser/ASTSwitchStatement.java | 2 +-
.../jexl3/scripting/JexlScriptEngineFactory.java | 2 +-
.../org/apache/commons/jexl3/AntishCallTest.java | 2 +-
.../org/apache/commons/jexl3/Arithmetic360.java | 4 +-
.../commons/jexl3/examples/MethodPropertyTest.java | 2 +-
.../org/apache/commons/jexl3/internal/Util.java | 2 +-
.../internal/introspection/PermissionsTest.java | 2 +-
36 files changed, 95 insertions(+), 95 deletions(-)
diff --git a/src/main/java/org/apache/commons/jexl3/JexlArithmetic.java
b/src/main/java/org/apache/commons/jexl3/JexlArithmetic.java
index 00fe77d2..46b2f23e 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlArithmetic.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlArithmetic.java
@@ -223,7 +223,7 @@ public class JexlArithmetic {
* <p>An array (as in int[]) is not convenient to call methods so when
encountered we turn them into lists</p>
*
* @param container an array or on object
- * @return an abstract list wrapping the array instance or the initial
argument
+ * @return An abstract list wrapping the array instance or the initial
argument
* @see org.apache.commons.jexl3.internal.introspection.ArrayListWrapper
*/
private static Object arrayWrap(final Object container) {
@@ -396,7 +396,7 @@ public class JexlArithmetic {
* Creates an array builder.
*
* @param size the number of elements in the array
- * @return an array builder instance
+ * @return An array builder instance
* @deprecated since 3.3.1
*/
@Deprecated
@@ -421,7 +421,7 @@ public class JexlArithmetic {
*
* @param strict whether null argument is converted as 0 or remains null
* @param value argument
- * @return a non-null value if argument can be represented by a long
+ * @return A non-null value if argument can be represented by a long
*/
protected Number asLongNumber(final boolean strict, final Object value) {
if (value instanceof Long
@@ -448,7 +448,7 @@ public class JexlArithmetic {
* <p>For convenience, booleans are converted as 1/0 (true/false).</p>
*
* @param value argument
- * @return a non-null value if argument can be represented by a long
+ * @return A non-null value if argument can be represented by a long
*/
protected Number asLongNumber(final Object value) {
return asLongNumber(strict, value);
@@ -1251,7 +1251,7 @@ public class JexlArithmetic {
* Creates a map-builder.
*
* @param size the number of elements in the map
- * @return a map-builder instance
+ * @return A map-builder instance
* @deprecated 3.3
*/
@Deprecated
@@ -1403,7 +1403,7 @@ public class JexlArithmetic {
* succeed.</p>
*
* @param original the original number.
- * @return a value of the smallest type the original number will fit into.
+ * @return A value of the smallest type the original number will fit into.
*/
public Number narrow(final Number original) {
return narrowNumber(original, null);
@@ -1452,7 +1452,7 @@ public class JexlArithmetic {
* @param lhs the left-hand side operand that lead to the bigd result
* @param rhs the right-hand side operand that lead to the bigd result
* @param big the BigDecimal to narrow
- * @return an Integer or Long if narrowing is possible, the original
BigDecimal otherwise
+ * @return An Integer or Long if narrowing is possible, the original
BigDecimal otherwise
*/
protected Number narrowBigDecimal(final Object lhs, final Object rhs,
final BigDecimal big) {
return narrowToLong(lhs, rhs, big, BigDecimal::longValueExact);
@@ -1470,7 +1470,7 @@ public class JexlArithmetic {
* @param lhs the left-hand side operand that lead to the bigi result
* @param rhs the right-hand side operand that lead to the bigi result
* @param big the BigInteger to narrow
- * @return an Integer or Long if narrowing is possible, the original
BigInteger otherwise
+ * @return An Integer or Long if narrowing is possible, the original
BigInteger otherwise
*/
protected Number narrowBigInteger(final Object lhs, final Object rhs,
final BigInteger big) {
return narrowToLong(lhs, rhs, big, BigInteger::longValueExact);
@@ -1485,7 +1485,7 @@ public class JexlArithmetic {
* @param big the number to narrow
* @param toLongFunction the function to convert the number to a long
* @param <X> The number type
- * @return an Integer or Long if narrowing is possible, the original
number otherwise
+ * @return An Integer or Long if narrowing is possible, the original
number otherwise
*/
protected <X extends Number> Number narrowToLong(final Object lhs, final
Object rhs, final X big, final ToLongFunction<X> toLongFunction) {
if (isNumberable(lhs) || isNumberable(rhs)) {
@@ -1510,7 +1510,7 @@ public class JexlArithmetic {
* @param lhs the left hand side operand that lead to the long result
* @param rhs the right hand side operand that lead to the long result
* @param r the long to narrow
- * @return an Integer if narrowing is possible, the original Long otherwise
+ * @return An Integer if narrowing is possible, the original Long otherwise
*/
protected Number narrowLong(final Object lhs, final Object rhs, final long
r) {
if (!(lhs instanceof Long || rhs instanceof Long) && (int) r == r) {
@@ -1638,7 +1638,7 @@ public class JexlArithmetic {
*
* @see #createWithOptions(boolean, java.math.MathContext, int)
* @param context the context that may extend {@link
JexlContext.OptionsHandle} to use
- * @return a new arithmetic instance or this
+ * @return A new arithmetic instance or this
* @since 3.1
*/
public JexlArithmetic options(final JexlContext context) {
@@ -1656,7 +1656,7 @@ public class JexlArithmetic {
*
* @see #createWithOptions(boolean, java.math.MathContext, int)
* @param options the {@link JexlEngine.Options} to use
- * @return an arithmetic with those options set
+ * @return An arithmetic with those options set
* @deprecated 3.2
*/
@Deprecated
@@ -1685,7 +1685,7 @@ public class JexlArithmetic {
*
* @see #createWithOptions(boolean, java.math.MathContext, int)
* @param options the {@link JexlEngine.Options} to use
- * @return an arithmetic with those options set
+ * @return An arithmetic with those options set
*/
public JexlArithmetic options(final JexlOptions options) {
if (options != null) {
@@ -1725,7 +1725,7 @@ public class JexlArithmetic {
* <>Empty string is considered as 0.
*
* @param arg the arg
- * @return a BigDecimal
+ * @return A BigDecimal
* @throws CoercionException if the string cannot be coerced into a
BigDecimal
*/
private BigDecimal parseBigDecimal(final String arg) throws
ArithmeticException {
@@ -1741,7 +1741,7 @@ public class JexlArithmetic {
* <>Empty string is considered as 0.
*
* @param arg the arg
- * @return a big integer
+ * @return A big integer
* @throws ArithmeticException if the string cannot be coerced into a big
integer
*/
private BigInteger parseBigInteger(final String arg) throws
ArithmeticException {
@@ -1757,7 +1757,7 @@ public class JexlArithmetic {
* <>Empty string is considered as NaN.
*
* @param arg the arg
- * @return a double
+ * @return A double
* @throws ArithmeticException if the string cannot be coerced into a
double
*/
private double parseDouble(final String arg) throws ArithmeticException {
@@ -1773,7 +1773,7 @@ public class JexlArithmetic {
* <p>This ensures the represented number is a natural (not a real).</p>
*
* @param arg the arg
- * @return an int
+ * @return An int
* @throws ArithmeticException if the string cannot be coerced into a long
*/
private int parseInteger(final String arg) throws ArithmeticException {
@@ -1790,7 +1790,7 @@ public class JexlArithmetic {
* <p>This ensures the represented number is a natural (not a real).</p>
*
* @param arg the arg
- * @return a long
+ * @return A long
* @throws ArithmeticException if the string cannot be coerced into a long
*/
private long parseLong(final String arg) throws ArithmeticException {
@@ -1810,7 +1810,7 @@ public class JexlArithmetic {
* 0|([1-9][0-9]*)
*
* @param id the identifier
- * @return an integer or null
+ * @return An integer or null
*/
public static Integer parseIdentifier(final Object id) {
if (id instanceof Number) {
@@ -1890,7 +1890,7 @@ public class JexlArithmetic {
* Creates a set-builder.
*
* @param size the number of elements in the set
- * @return a set-builder instance
+ * @return A set-builder instance
* @deprecated since 3.3.1
*/
@Deprecated
@@ -2087,7 +2087,7 @@ public class JexlArithmetic {
*
* @param strict true if the calling operator or casting is strict, false
otherwise
* @param val the object to be coerced.
- * @return a BigDecimal.
+ * @return A BigDecimal.
* @throws ArithmeticException if val is null and mode is strict or if
coercion is not possible
* @since 3.3
*/
@@ -2101,7 +2101,7 @@ public class JexlArithmetic {
* <p>Boolean false is 0, true is 1.</p>
*
* @param val the object to be coerced.
- * @return a BigDecimal.
+ * @return A BigDecimal.
* @throws ArithmeticException if val is null and mode is strict or if
coercion is not possible
*/
public BigDecimal toBigDecimal(final Object val) {
@@ -2143,7 +2143,7 @@ public class JexlArithmetic {
*
* @param strict true if the calling operator or casting is strict, false
otherwise
* @param val the object to be coerced.
- * @return a BigInteger
+ * @return A BigInteger
* @throws ArithmeticException if val is null and mode is strict or if
coercion is not possible
* @since 3.3
*/
@@ -2157,7 +2157,7 @@ public class JexlArithmetic {
* <p>Boolean false is 0, true is 1.</p>
*
* @param val the object to be coerced.
- * @return a BigInteger
+ * @return A BigInteger
* @throws ArithmeticException if val is null and mode is strict or if
coercion is not possible
*/
public BigInteger toBigInteger(final Object val) {
diff --git a/src/main/java/org/apache/commons/jexl3/JexlBuilder.java
b/src/main/java/org/apache/commons/jexl3/JexlBuilder.java
index 63283988..e661acfa 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlBuilder.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlBuilder.java
@@ -169,7 +169,7 @@ public class JexlBuilder {
* Loops are left enabled so scripts can iterate; expressions never allow
loops since they are
* parsed as a single expression.</p>
*
- * @return a fresh hardened feature set
+ * @return A fresh hardened feature set
* @since 3.7.0
*/
private static JexlFeatures secureFeatures() {
@@ -504,7 +504,7 @@ public class JexlBuilder {
/**
* Create a new engine
*
- * @return a {@link JexlEngine} instance
+ * @return A {@link JexlEngine} instance
*/
public JexlEngine create() {
return new Engine(this);
diff --git a/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
b/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
index be9573f5..868e2b60 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
@@ -233,7 +233,7 @@ public final class JexlConfigLoader {
* Loads configuration from a YAML {@link InputStream} (UTF-8) into a
{@link JexlBuilder}.
*
* @param in YAML input; the caller is responsible for closing it
- * @return a configured JexlBuilder
+ * @return A configured JexlBuilder
* @throws IOException if the stream cannot be read
*/
public static JexlBuilder load(final InputStream in) throws IOException {
@@ -244,7 +244,7 @@ public final class JexlConfigLoader {
* Loads configuration from a YAML {@link Reader} into a {@link
JexlBuilder}.
*
* @param reader YAML input; the caller is responsible for closing it
- * @return a configured JexlBuilder
+ * @return A configured JexlBuilder
* @throws IOException if the reader cannot be read
*/
public static JexlBuilder load(final Reader reader) throws IOException {
@@ -259,7 +259,7 @@ public final class JexlConfigLoader {
* Convenience: loads YAML from {@code in} and creates the engine in one
call.
*
* @param in YAML input; the caller is responsible for closing it
- * @return a new JexlEngine configured from the YAML
+ * @return A new JexlEngine configured from the YAML
* @throws IOException if the stream cannot be read
*/
public static JexlEngine engine(final InputStream in) throws IOException {
diff --git a/src/main/java/org/apache/commons/jexl3/JexlContext.java
b/src/main/java/org/apache/commons/jexl3/JexlContext.java
index 4fceae5a..510a63a9 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlContext.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlContext.java
@@ -89,7 +89,7 @@ public interface JexlContext {
/**
* Gets a cancelable boolean used by the interpreter.
*
- * @return a cancelable boolean used by the interpreter.
+ * @return A cancelable boolean used by the interpreter.
*/
AtomicBoolean getCancellation();
}
diff --git a/src/main/java/org/apache/commons/jexl3/JexlEngine.java
b/src/main/java/org/apache/commons/jexl3/JexlEngine.java
index 339f61fe..bbf3f9bd 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlEngine.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlEngine.java
@@ -278,7 +278,7 @@ public abstract class JexlEngine {
* <p>This gathers the class, method and line number of the first calling
method
* outside of o.a.c.jexl3.</p>
*
- * @return a JexlInfo instance
+ * @return A JexlInfo instance
*/
public JexlInfo createInfo() {
return isDebug()? new JexlInfo() : new JexlInfo("jexl", 1, 1);
@@ -290,7 +290,7 @@ public abstract class JexlEngine {
* @param fn url/file/template/script user given name
* @param l line number
* @param c column number
- * @return a JexlInfo instance
+ * @return A JexlInfo instance
*/
public JexlInfo createInfo(final String fn, final int l, final int c) {
return new JexlInfo(fn, l, c);
@@ -299,7 +299,7 @@ public abstract class JexlEngine {
/**
* Creates a new {@link JxltEngine} instance using this engine.
*
- * @return a JEXL Template engine
+ * @return A JEXL Template engine
*/
public JxltEngine createJxltEngine() {
return createJxltEngine(true);
@@ -309,7 +309,7 @@ public abstract class JexlEngine {
* Creates a new {@link JxltEngine} instance using this engine.
*
* @param noScript whether the JxltEngine only allows Jexl expressions or
scripts
- * @return a JEXL Template engine
+ * @return A JEXL Template engine
*/
public JxltEngine createJxltEngine(final boolean noScript) {
return createJxltEngine(noScript, JXLT_CACHE_SIZE, '$', '#');
@@ -322,7 +322,7 @@ public abstract class JexlEngine {
* @param cacheSize the number of expressions in this cache, default is 256
* @param immediate the immediate template expression character, default
is '$'
* @param deferred the deferred template expression character, default is
'#'
- * @return a JEXL Template engine
+ * @return A JEXL Template engine
*/
public abstract JxltEngine createJxltEngine(boolean noScript, int
cacheSize, char immediate, char deferred);
diff --git a/src/main/java/org/apache/commons/jexl3/JexlException.java
b/src/main/java/org/apache/commons/jexl3/JexlException.java
index c6d3851c..ab71c8f4 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlException.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlException.java
@@ -813,7 +813,7 @@ public class JexlException extends RuntimeException {
* Creates a string builder pre-filled with common error information (if
possible).
*
* @param node the node
- * @return a string builder
+ * @return A string builder
*/
static StringBuilder errorAt(final JexlNode node) {
final JexlInfo info = node != null ? detailedInfo(node,
node.jexlInfo()) : null;
@@ -891,7 +891,7 @@ public class JexlException extends RuntimeException {
*
* @param name the method name
* @param args the method arguments
- * @return a suitable signed name
+ * @return A suitable signed name
*/
static String methodSignature(final String name, final Object[] args) {
if (args != null && args.length > 0) {
@@ -999,7 +999,7 @@ public class JexlException extends RuntimeException {
* <p>Return the cause if it is already a JexlException.
*
* @param xinvoke the invocation exception
- * @return a JexlException
+ * @return A JexlException
*/
public static JexlException tryFailed(final InvocationTargetException
xinvoke) {
final Throwable cause = xinvoke.getCause();
diff --git a/src/main/java/org/apache/commons/jexl3/JexlFeatures.java
b/src/main/java/org/apache/commons/jexl3/JexlFeatures.java
index afc7d62e..2509349d 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlFeatures.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlFeatures.java
@@ -227,7 +227,7 @@ public final class JexlFeatures {
/**
* Creates an all features enabled set.
*
- * @return a new instance of all features set
+ * @return A new instance of all features set
* @since 3.3.1
*/
public static JexlFeatures createAll() {
@@ -258,7 +258,7 @@ public final class JexlFeatures {
* <li>pragma anywhere, {@link
JexlFeatures#supportsPragmaAnywhere()}</li>
* </ul>
*
- * @return a new instance of a default scripting features set
+ * @return A new instance of a default scripting features set
* @since 3.3.1
*/
public static JexlFeatures createDefault() {
@@ -270,7 +270,7 @@ public final class JexlFeatures {
* <p>This is the strictest base-set since no feature is allowed, suitable
as-is only
* for the simplest expressions.</p>
*
- * @return a new instance of an empty features set
+ * @return A new instance of an empty features set
* @since 3.3.1
*/
public static JexlFeatures createNone() {
@@ -292,7 +292,7 @@ public final class JexlFeatures {
* <em>try, catch, throw, finally, switch, case, default, class,
instanceof</em>
* </p>
*
- * @return a new instance of a modern scripting features set
+ * @return A new instance of a modern scripting features set
* @since 3.3.1
*/
public static JexlFeatures createScript() {
diff --git a/src/main/java/org/apache/commons/jexl3/JexlInfo.java
b/src/main/java/org/apache/commons/jexl3/JexlInfo.java
index 9512d681..19de3de2 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlInfo.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlInfo.java
@@ -128,7 +128,7 @@ public class JexlInfo {
*
* @param l the line
* @param c the column
- * @return a new info instance
+ * @return A new info instance
*/
public JexlInfo at(final int l, final int c) {
return new JexlInfo(name, l, c);
diff --git a/src/main/java/org/apache/commons/jexl3/JexlOptions.java
b/src/main/java/org/apache/commons/jexl3/JexlOptions.java
index d545f721..f5dc9c56 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlOptions.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlOptions.java
@@ -195,7 +195,7 @@ public final class JexlOptions {
/**
* Creates a copy of this instance.
*
- * @return a copy
+ * @return A copy
*/
public JexlOptions copy() {
return new JexlOptions().set(this);
diff --git a/src/main/java/org/apache/commons/jexl3/JxltEngine.java
b/src/main/java/org/apache/commons/jexl3/JxltEngine.java
index 817a0080..7b27a453 100644
--- a/src/main/java/org/apache/commons/jexl3/JxltEngine.java
+++ b/src/main/java/org/apache/commons/jexl3/JxltEngine.java
@@ -190,7 +190,7 @@ public abstract class JxltEngine {
* <p>If the underlying JEXL engine is silent, errors will be logged
through its logger as warning.* </p>
*
* @param context the context to use for immediate expression
evaluations
- * @return an {@link Expression} or null if an error occurs and the
{@link JexlEngine} is running
+ * @return An {@link Expression} or null if an error occurs and the
{@link JexlEngine} is running
* in silent mode
* @throws Exception if an error occurs and the {@link JexlEngine} is
not in silent mode
*/
diff --git a/src/main/java/org/apache/commons/jexl3/internal/ArrayBuilder.java
b/src/main/java/org/apache/commons/jexl3/internal/ArrayBuilder.java
index 2d5fbab9..4e196dee 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/ArrayBuilder.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/ArrayBuilder.java
@@ -158,7 +158,7 @@ public class ArrayBuilder implements
JexlArithmetic.ArrayBuilder {
*
* @param baseClass the baseClass
* @param other another class
- * @return a common ancestor, class or interface, worst case being class
Object
+ * @return A common ancestor, class or interface, worst case being class
Object
*/
protected Class<?> getCommonSuperClass(final Class<?> baseClass, final
Class<?> other) {
return ClassMisc.getCommonSuperClass(baseClass, other);
diff --git a/src/main/java/org/apache/commons/jexl3/internal/Engine.java
b/src/main/java/org/apache/commons/jexl3/internal/Engine.java
index 4df0ed9e..86482b54 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/Engine.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/Engine.java
@@ -185,7 +185,7 @@ public class Engine extends JexlEngine implements
JexlUberspect.ConstantResolver
*
* @param logger the logger
* @param strategy the strategy
- * @return an Uberspect instance
+ * @return An Uberspect instance
* @deprecated 3.3
*/
@Deprecated
@@ -438,7 +438,7 @@ public class Engine extends JexlEngine implements
JexlUberspect.ConstantResolver
* @param context a JexlContext; if null, the empty context is used
instead.
* @param frame the interpreter frame
* @param opts the evaluation options
- * @return an Interpreter
+ * @return An Interpreter
*/
protected Interpreter createInterpreter(final JexlContext context, final
Frame frame, final JexlOptions opts) {
return new Interpreter(this, opts, context, frame);
@@ -1122,7 +1122,7 @@ public class Engine extends JexlEngine implements
JexlUberspect.ConstantResolver
/**
* Creates a collector instance.
*
- * @return a collector instance
+ * @return A collector instance
*/
protected VarCollector varCollector() {
return new VarCollector(this.collectMode);
@@ -1148,7 +1148,7 @@ public class Engine extends JexlEngine implements
JexlUberspect.ConstantResolver
* <p>This uses the metacache instance as factory.</p>
*
* @param capacity the cache capacity
- * @return a cache instance, null if capacity == 0, the JEXL cache if
capacity < 0
+ * @return A cache instance, null if capacity == 0, the JEXL cache if
capacity < 0
*/
protected JexlCache<Source, Object> createCache(final int capacity) {
return capacity < 0 ? cache : capacity > 0 ?
metaCache.createCache(capacity) : null;
diff --git a/src/main/java/org/apache/commons/jexl3/internal/Frame.java
b/src/main/java/org/apache/commons/jexl3/internal/Frame.java
index 2037cb2f..737d7bf4 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/Frame.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/Frame.java
@@ -81,7 +81,7 @@ public class Frame {
* @param s the scope
* @param r the arguments
* @param c the number of curried parameters
- * @return a new instance of frame
+ * @return A new instance of frame
*/
Frame newFrame(final Scope s, final Object[] r, final int c) {
return new Frame(s, r, c);
diff --git a/src/main/java/org/apache/commons/jexl3/internal/IntegerRange.java
b/src/main/java/org/apache/commons/jexl3/internal/IntegerRange.java
index 0a333cfa..be17f7fb 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/IntegerRange.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/IntegerRange.java
@@ -153,7 +153,7 @@ public abstract class IntegerRange implements
Collection<Integer> {
*
* @param from the lower inclusive boundary
* @param to the higher inclusive boundary
- * @return a range
+ * @return A range
*/
public static IntegerRange create(final int from, final int to) {
if (from <= to) {
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/InterpreterBase.java
b/src/main/java/org/apache/commons/jexl3/internal/InterpreterBase.java
index 479c20c4..92737634 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/InterpreterBase.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/InterpreterBase.java
@@ -723,7 +723,7 @@ public abstract class InterpreterBase extends ParserVisitor
{
* @param node the node triggering the exception
* @param methodName the method/function name
* @param xany the cause
- * @return a JexlException that will be thrown
+ * @return A JexlException that will be thrown
*/
protected JexlException invocationException(final JexlNode node, final
String methodName, final Throwable xany) {
final Throwable cause = xany.getCause();
diff --git a/src/main/java/org/apache/commons/jexl3/internal/LongRange.java
b/src/main/java/org/apache/commons/jexl3/internal/LongRange.java
index d4e61cdf..2e24a1b5 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/LongRange.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/LongRange.java
@@ -155,7 +155,7 @@ public abstract class LongRange implements Collection<Long>
{
*
* @param from the lower inclusive boundary
* @param to the higher inclusive boundary
- * @return a range
+ * @return A range
*/
public static LongRange create(final long from, final long to) {
if (from <= to) {
diff --git a/src/main/java/org/apache/commons/jexl3/internal/Operator.java
b/src/main/java/org/apache/commons/jexl3/internal/Operator.java
index 8e01b246..aa396303 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/Operator.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/Operator.java
@@ -172,7 +172,7 @@ public final class Operator implements
JexlOperator.Uberspect {
* @param methodName the method name
* @param right the left argument in the operator
* @param left the right argument in the operator
- * @return a boolean is call was possible, null otherwise
+ * @return A boolean is call was possible, null otherwise
* @throws Exception if invocation fails
*/
private Boolean booleanDuckCall(final String methodName, final Object
left, final Object right) throws Exception {
@@ -240,7 +240,7 @@ public final class Operator implements
JexlOperator.Uberspect {
* @param arithmetic the arithmetic instance
* @param operator the operator
* @param args the arguments
- * @return a JexlMethod instance or null
+ * @return A JexlMethod instance or null
*/
private JexlMethod uberspectOperator(final JexlArithmetic arithmetic,
final JexlOperator operator,
@@ -572,7 +572,7 @@ public final class Operator implements
JexlOperator.Uberspect {
*
* @param operator the operator
* @param args the arguments
- * @return an instance or null
+ * @return An instance or null
*/
private JexlMethod getAlternateOverload(final JexlOperator operator, final
Object... args) {
// comparison operators may use the compare overload in derived
arithmetic
diff --git a/src/main/java/org/apache/commons/jexl3/internal/SoftCache.java
b/src/main/java/org/apache/commons/jexl3/internal/SoftCache.java
index ab66afd8..acf365b4 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/SoftCache.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/SoftCache.java
@@ -121,7 +121,7 @@ public class SoftCache<K, V> implements JexlCache<K, V> {
* @param <KT> the key type
* @param <VT> the value type
* @param cacheSize the cache size, must be > 0
- * @return a Map usable as a cache bounded to the given size
+ * @return A Map usable as a cache bounded to the given size
*/
protected <KT, VT> Map<KT, VT> createMap(final int cacheSize) {
return createSynchronizedLinkedHashMap(cacheSize);
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/TemplateEngine.java
b/src/main/java/org/apache/commons/jexl3/internal/TemplateEngine.java
index 94424a00..e9b6ec13 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/TemplateEngine.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/TemplateEngine.java
@@ -328,7 +328,7 @@ public final class TemplateEngine extends JxltEngine {
*
* @param el the unified el instance
* @param source the source TemplateExpression
- * @return an TemplateExpression
+ * @return An TemplateExpression
*/
TemplateExpression build(final TemplateEngine el, final
TemplateExpression source) {
int sum = 0;
@@ -689,7 +689,7 @@ public final class TemplateEngine extends JxltEngine {
* Prepares a sub-expression for interpretation.
*
* @param interpreter a JEXL interpreter
- * @return a prepared unified expression
+ * @return A prepared unified expression
* @throws JexlException (only for nested and composite)
*/
protected TemplateExpression prepare(final Interpreter interpreter) {
@@ -780,7 +780,7 @@ public final class TemplateEngine extends JxltEngine {
* @param action createExpression, prepare, evaluate
* @param expr the template expression
* @param xany the exception
- * @return an exception containing an explicit error message
+ * @return An exception containing an explicit error message
*/
static Exception createException(final JexlInfo info,
final String action,
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/AbstractExecutor.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/AbstractExecutor.java
index 569d8899..1e85a06d 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/AbstractExecutor.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/AbstractExecutor.java
@@ -100,7 +100,7 @@ abstract class AbstractExecutor {
* Coerce an Object which must be a number to an Integer.
*
* @param arg the Object to coerce
- * @return an Integer if it can be converted, null otherwise
+ * @return An Integer if it can be converted, null otherwise
*/
static Integer castInteger(final Object arg) {
return arg instanceof Number? ((Number) arg).intValue() : null;
@@ -110,7 +110,7 @@ abstract class AbstractExecutor {
* Coerce an Object to a String.
*
* @param arg the Object to coerce
- * @return a String if it can be converted, null otherwise
+ * @return A String if it can be converted, null otherwise
*/
static String castString(final Object arg) {
return arg instanceof CharSequence || arg instanceof Integer ?
arg.toString() : null;
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/ClassMisc.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/ClassMisc.java
index c9ec6428..8b1b39d7 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/ClassMisc.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/ClassMisc.java
@@ -96,7 +96,7 @@ public class ClassMisc {
*
* @param baseClass the class to serve as base
* @param otherClasses the (optional) other classes
- * @return an empty set if nothing in common, the set of common classes and
interfaces that
+ * @return An empty set if nothing in common, the set of common classes and
interfaces that
* does not contain the baseClass nor Object class
*/
public static Set<Class<?>> getSuperClasses(final Class<?> baseClass, final
Class<?>... otherClasses) {
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/ConstructorMethod.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/ConstructorMethod.java
index 06335319..3b0dbce6 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/ConstructorMethod.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/ConstructorMethod.java
@@ -34,7 +34,7 @@ public final class ConstructorMethod implements JexlMethod {
* @param is the introspector
* @param ctorHandle a class or class name
* @param args constructor arguments
- * @return a {@link JexlMethod}
+ * @return A {@link JexlMethod}
*/
public static ConstructorMethod discover(final Introspector is, final
Object ctorHandle, final Object... args) {
String className;
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
index 9fa4f9e2..1d0475b5 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
@@ -105,7 +105,7 @@ public final class IndexedType implements JexlPropertyGet {
* @param is the introspector
* @param object the object
* @param name the container name
- * @return a JexlPropertyGet is successful, null otherwise
+ * @return A JexlPropertyGet is successful, null otherwise
*/
public static JexlPropertyGet discover(final Introspector is, final Object
object, final String name) {
if (object != null && name != null && !name.isEmpty()) {
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodExecutor.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodExecutor.java
index 7ce18944..305238de 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodExecutor.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodExecutor.java
@@ -44,7 +44,7 @@ public final class MethodExecutor extends
AbstractExecutor.Method {
* @param obj the object to introspect
* @param method the name of the method to find
* @param args the method arguments
- * @return a filled up parameter (may contain a null method)
+ * @return A filled up parameter (may contain a null method)
*/
public static MethodExecutor discover(final Introspector is, final Object
obj, final String method, final Object[] args) {
final Class<?> clazz = obj.getClass();
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodKey.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodKey.java
index e2ace756..d7c6d220 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodKey.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/MethodKey.java
@@ -172,7 +172,7 @@ public final class MethodKey {
*
* @param classes the argument args
* @param applicables the list of applicable methods or constructors
- * @return an ambiguous exception
+ * @return An ambiguous exception
*/
private static <T extends Executable>
AmbiguousException ambiguousException(final Class<?>[] classes, final
Iterable<T> applicables) {
@@ -213,7 +213,7 @@ public final class MethodKey {
*
* @param methods list of all candidate methods
* @param classes the actual types of the arguments
- * @return a list that contains only applicable methods (number of
+ * @return A list that contains only applicable methods (number of
* formal and actual arguments matches, and argument types are assignable
* to formal types through a method invocation conversion).
*/
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/Uberspect.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/Uberspect.java
index e420bc2e..b9b511a4 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/Uberspect.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/Uberspect.java
@@ -217,7 +217,7 @@ public class Uberspect implements JexlUberspect {
*
* @param c Class in which the field search is taking place
* @param key Name of the field being searched for
- * @return a {@link java.lang.reflect.Field} or null if it does not exist
or is not accessible
+ * @return A {@link java.lang.reflect.Field} or null if it does not exist
or is not accessible
*/
public final Field getField(final Class<?> c, final String key) {
return base().getField(c, key);
@@ -280,7 +280,7 @@ public class Uberspect implements JexlUberspect {
*
* @param c Class in which the method search is taking place
* @param key MethodKey of the method being searched for
- * @return a {@link java.lang.reflect.Method}
+ * @return A {@link java.lang.reflect.Method}
* or null if no unambiguous method could be found through
introspection.
*/
public final Method getMethod(final Class<?> c, final MethodKey key) {
@@ -296,7 +296,7 @@ public class Uberspect implements JexlUberspect {
* @param c Class in which the method search is taking place
* @param name Name of the method being searched for
* @param params An array of Objects (not Classes) that describe the
parameters
- * @return a {@link java.lang.reflect.Method}
+ * @return A {@link java.lang.reflect.Method}
* or null if no unambiguous method could be found through
introspection.
*/
public final Method getMethod(final Class<?> c, final String name, final
Object[] params) {
diff --git
a/src/main/java/org/apache/commons/jexl3/introspection/JexlPermissions.java
b/src/main/java/org/apache/commons/jexl3/introspection/JexlPermissions.java
index 360ede3c..40be25bc 100644
--- a/src/main/java/org/apache/commons/jexl3/introspection/JexlPermissions.java
+++ b/src/main/java/org/apache/commons/jexl3/introspection/JexlPermissions.java
@@ -669,7 +669,7 @@ public interface JexlPermissions {
* Wraps these permissions in a {@link LoggingPermissions} that logs every
allow/deny decision.
* <p>Useful to discover which reflective elements a permission set allows
or denies.</p>
*
- * @return a logging view of these permissions
+ * @return A logging view of these permissions
* @since 3.7.0
*/
default JexlPermissions logging() {
@@ -681,7 +681,7 @@ public interface JexlPermissions {
* to a named logger.
*
* @param loggerName the name of the logger to log decisions to
- * @return a logging view of these permissions
+ * @return A logging view of these permissions
* @since 3.7.0
*/
default JexlPermissions logging(final String loggerName) {
@@ -693,7 +693,7 @@ public interface JexlPermissions {
* to the given logger.
*
* @param log the logger to log decisions to
- * @return a logging view of these permissions
+ * @return A logging view of these permissions
* @since 3.7.0
*/
default JexlPermissions logging(final Log log) {
diff --git
a/src/main/java/org/apache/commons/jexl3/introspection/JexlSandbox.java
b/src/main/java/org/apache/commons/jexl3/introspection/JexlSandbox.java
index 07442574..3837a39e 100644
--- a/src/main/java/org/apache/commons/jexl3/introspection/JexlSandbox.java
+++ b/src/main/java/org/apache/commons/jexl3/introspection/JexlSandbox.java
@@ -219,7 +219,7 @@ public final class JexlSandbox {
/**
* Gets a copy of this sandbox
*
- * @return a copy of this sandbox
+ * @return A copy of this sandbox
*/
public JexlSandbox copy() {
// modified concurrently at runtime so...
@@ -523,7 +523,7 @@ public final class JexlSandbox {
/**
* Gets a copy of these Names
*
- * @return a copy of these Names
+ * @return A copy of these Names
*/
protected Names copy() {
return this;
@@ -596,7 +596,7 @@ public final class JexlSandbox {
}
/**
- * @return a copy of these permissions
+ * @return A copy of these permissions
*/
Permissions copy() {
return new Permissions(inheritable, read.copy(), write.copy(),
execute.copy());
diff --git
a/src/main/java/org/apache/commons/jexl3/introspection/JexlUberspect.java
b/src/main/java/org/apache/commons/jexl3/introspection/JexlUberspect.java
index 8ee85c89..ae9e84e9 100644
--- a/src/main/java/org/apache/commons/jexl3/introspection/JexlUberspect.java
+++ b/src/main/java/org/apache/commons/jexl3/introspection/JexlUberspect.java
@@ -124,7 +124,7 @@ public interface JexlUberspect {
* Creates a constant resolver.
*
* @param imports the collection of imports (packages and classes) to
use
- * @return a constant resolver
+ * @return A constant resolver
*/
ClassConstantResolver createConstantResolver(Collection<String>
imports);
}
@@ -264,7 +264,7 @@ public interface JexlUberspect {
* Gets an arithmetic operator executor for a given arithmetic instance.
*
* @param arithmetic the arithmetic instance
- * @return an operator uberspect instance
+ * @return An operator uberspect instance
* @since 3.5.0
*/
default JexlOperator.Uberspect getOperator(final JexlArithmetic
arithmetic) {
@@ -298,7 +298,7 @@ public interface JexlUberspect {
*
* @param ctorHandle a class or class name
* @param args constructor arguments
- * @return a {@link JexlMethod}
+ * @return A {@link JexlMethod}
* @since 3.0
*/
JexlMethod getConstructor(Object ctorHandle, Object... args);
@@ -307,7 +307,7 @@ public interface JexlUberspect {
* Gets an iterator from an object.
*
* @param obj to get the iterator from
- * @return an iterator over obj or null
+ * @return An iterator over obj or null
*/
Iterator<?> getIterator(Object obj);
@@ -317,7 +317,7 @@ public interface JexlUberspect {
* @param obj the object
* @param method the method name
* @param args method arguments
- * @return a {@link JexlMethod}
+ * @return A {@link JexlMethod}
*/
JexlMethod getMethod(Object obj, String method, Object... args);
@@ -330,7 +330,7 @@ public interface JexlUberspect {
* @param resolvers the list of property resolvers to try
* @param obj the object to get the property from
* @param identifier property name
- * @return a {@link JexlPropertyGet} or null
+ * @return A {@link JexlPropertyGet} or null
* @since 3.0
*/
JexlPropertyGet getPropertyGet(List<PropertyResolver> resolvers, Object
obj, Object identifier);
@@ -342,7 +342,7 @@ public interface JexlUberspect {
*
* @param obj the object to get the property from
* @param identifier property name
- * @return a {@link JexlPropertyGet} or null
+ * @return A {@link JexlPropertyGet} or null
*/
JexlPropertyGet getPropertyGet(Object obj, Object identifier);
@@ -356,7 +356,7 @@ public interface JexlUberspect {
* @param obj the object to get the property from
* @param identifier property name
* @param arg value to set
- * @return a {@link JexlPropertySet} or null
+ * @return A {@link JexlPropertySet} or null
* @since 3.0
*/
JexlPropertySet getPropertySet(List<PropertyResolver> resolvers, Object
obj, Object identifier, Object arg);
@@ -369,7 +369,7 @@ public interface JexlUberspect {
* @param obj the object to get the property from.
* @param identifier property name
* @param arg value to set
- * @return a {@link JexlPropertySet} or null
+ * @return A {@link JexlPropertySet} or null
*/
JexlPropertySet getPropertySet(Object obj, Object identifier, Object arg);
diff --git
a/src/main/java/org/apache/commons/jexl3/parser/ASTSwitchStatement.java
b/src/main/java/org/apache/commons/jexl3/parser/ASTSwitchStatement.java
index 45b555bc..9ecc4d08 100644
--- a/src/main/java/org/apache/commons/jexl3/parser/ASTSwitchStatement.java
+++ b/src/main/java/org/apache/commons/jexl3/parser/ASTSwitchStatement.java
@@ -49,7 +49,7 @@ public class ASTSwitchStatement extends JexlNode {
* The list at each index contains the case values for that index.
* If the values-list is empty for an index, it is the default case.
*
- * @return an array of case values
+ * @return An array of case values
*/
public List<Object>[] getCasesList() {
@SuppressWarnings("unchecked")
diff --git
a/src/main/java/org/apache/commons/jexl3/scripting/JexlScriptEngineFactory.java
b/src/main/java/org/apache/commons/jexl3/scripting/JexlScriptEngineFactory.java
index ca1dce80..e51dfe9c 100644
---
a/src/main/java/org/apache/commons/jexl3/scripting/JexlScriptEngineFactory.java
+++
b/src/main/java/org/apache/commons/jexl3/scripting/JexlScriptEngineFactory.java
@@ -90,7 +90,7 @@ public class JexlScriptEngineFactory implements
ScriptEngineFactory {
/**
* Creates a new JexlEngine instance.
- * @return a new JexlEngine instance
+ * @return A new JexlEngine instance
*/
protected JexlEngine createJexlEngine() {
final JexlBuilder builder = new JexlBuilder()
diff --git a/src/test/java/org/apache/commons/jexl3/AntishCallTest.java
b/src/test/java/org/apache/commons/jexl3/AntishCallTest.java
index b06eb382..462a7157 100644
--- a/src/test/java/org/apache/commons/jexl3/AntishCallTest.java
+++ b/src/test/java/org/apache/commons/jexl3/AntishCallTest.java
@@ -124,7 +124,7 @@ class AntishCallTest extends JexlTestCase {
* <p>Note that before 3.2, a class was not considered a functor.
* @param ref the ClassReference of the class we seek to instantiate
* @param args the constructor arguments
- * @return an instance if that was possible
+ * @return An instance if that was possible
*/
public static Object callConstructor(final JexlEngine engine, final
ClassReference ref, final Object... args) {
return callConstructor(engine, ref.clazz, args);
diff --git a/src/test/java/org/apache/commons/jexl3/Arithmetic360.java
b/src/test/java/org/apache/commons/jexl3/Arithmetic360.java
index d83f4bc4..3449ee10 100644
--- a/src/test/java/org/apache/commons/jexl3/Arithmetic360.java
+++ b/src/test/java/org/apache/commons/jexl3/Arithmetic360.java
@@ -89,7 +89,7 @@ public class Arithmetic360 extends JexlArithmetic {
* <p>Narrowing will only occur if the initial operand is not a Long.
* @param operand the operand that lead to the long result
* @param result the long result to narrow
- * @return an Integer if narrowing is possible, the original Long otherwise
+ * @return An Integer if narrowing is possible, the original Long otherwise
*/
protected Number narrowLong(final Object operand, final long result) {
if (!(operand instanceof Long)) {
@@ -107,7 +107,7 @@ public class Arithmetic360 extends JexlArithmetic {
* @param lhs the left-hand side operand that lead to the long result
* @param rhs the right-hand side operand that lead to the long result
* @param result the long to narrow
- * @return an Integer if narrowing is possible, the original Long otherwise
+ * @return An Integer if narrowing is possible, the original Long otherwise
*/
@Override
protected Number narrowLong(final Object lhs, final Object rhs, final long
result) {
diff --git
a/src/test/java/org/apache/commons/jexl3/examples/MethodPropertyTest.java
b/src/test/java/org/apache/commons/jexl3/examples/MethodPropertyTest.java
index f9b3603d..d9b5d55b 100644
--- a/src/test/java/org/apache/commons/jexl3/examples/MethodPropertyTest.java
+++ b/src/test/java/org/apache/commons/jexl3/examples/MethodPropertyTest.java
@@ -54,7 +54,7 @@ class MethodPropertyTest {
/**
* Gets foo.
- * @return a string.
+ * @return A string.
*/
public String getFoo() {
return "This is from getFoo()";
diff --git a/src/test/java/org/apache/commons/jexl3/internal/Util.java
b/src/test/java/org/apache/commons/jexl3/internal/Util.java
index 8223048c..0e565b9a 100644
--- a/src/test/java/org/apache/commons/jexl3/internal/Util.java
+++ b/src/test/java/org/apache/commons/jexl3/internal/Util.java
@@ -153,7 +153,7 @@ public class Util {
/**
* A helper class to help validate AST problems.
* @param e the script
- * @return an indented version of the AST
+ * @return An indented version of the AST
*/
protected static String flattenedStr(final JexlScript e) {
return ""; //e.getText() + "\n" + flattenedStr(((Script)e).script);
diff --git
a/src/test/java/org/apache/commons/jexl3/internal/introspection/PermissionsTest.java
b/src/test/java/org/apache/commons/jexl3/internal/introspection/PermissionsTest.java
index 8db55eda..731f7e35 100644
---
a/src/test/java/org/apache/commons/jexl3/internal/introspection/PermissionsTest.java
+++
b/src/test/java/org/apache/commons/jexl3/internal/introspection/PermissionsTest.java
@@ -118,7 +118,7 @@ class PermissionsTest {
/**
* Same name signature as default private method.
* @param s the string
- * @return a double, NaN if fail
+ * @return A double, NaN if fail
*/
public double parseDouble(final String s) {
try {
