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-scxml.git
The following commit(s) were added to refs/heads/master by this push:
new e658acac Javadoc
e658acac is described below
commit e658acac55697dd625b9744b4a85cbf5fdde17c2
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 09:09:14 2026 -0400
Javadoc
---
src/main/java/org/apache/commons/scxml2/EvaluatorFactory.java | 2 +-
src/main/java/org/apache/commons/scxml2/EvaluatorProvider.java | 4 ++--
src/main/java/org/apache/commons/scxml2/EventDispatcher.java | 2 +-
src/main/java/org/apache/commons/scxml2/PathResolver.java | 2 +-
.../java/org/apache/commons/scxml2/SCInstanceObjectInputStream.java | 2 +-
.../java/org/apache/commons/scxml2/env/groovy/GroovyEvaluator.java | 2 +-
.../java/org/apache/commons/scxml2/env/javascript/JSEvaluator.java | 2 +-
src/main/java/org/apache/commons/scxml2/env/jexl/JexlEvaluator.java | 2 +-
src/main/java/org/apache/commons/scxml2/io/SCXMLReader.java | 2 +-
src/main/java/org/apache/commons/scxml2/io/SCXMLWriter.java | 2 +-
src/main/java/org/apache/commons/scxml2/model/SCXML.java | 2 +-
src/main/java/org/apache/commons/scxml2/model/TransitionalState.java | 2 +-
src/test/java/org/apache/commons/scxml2/w3c/W3CTests.java | 4 ++--
13 files changed, 15 insertions(+), 15 deletions(-)
diff --git a/src/main/java/org/apache/commons/scxml2/EvaluatorFactory.java
b/src/main/java/org/apache/commons/scxml2/EvaluatorFactory.java
index eee2d413..a1d3aee2 100644
--- a/src/main/java/org/apache/commons/scxml2/EvaluatorFactory.java
+++ b/src/main/java/org/apache/commons/scxml2/EvaluatorFactory.java
@@ -67,7 +67,7 @@ public class EvaluatorFactory {
* <p>If no SCXML document is provided a default Evaluator will be
returned.</p>
*
* @param document The document to return a dedicated Evaluator for. May
be null to retrieve the default Evaluator.
- * @return a new and not sharable Evaluator instance for the provided
document, or a default Evaluator otherwise
+ * @return A new and not sharable Evaluator instance for the provided
document, or a default Evaluator otherwise
* @throws ModelException If the SCXML document datamodel is not supported.
*/
public static Evaluator getEvaluator(final SCXML document) throws
ModelException {
diff --git a/src/main/java/org/apache/commons/scxml2/EvaluatorProvider.java
b/src/main/java/org/apache/commons/scxml2/EvaluatorProvider.java
index a984947f..db8aa3a3 100644
--- a/src/main/java/org/apache/commons/scxml2/EvaluatorProvider.java
+++ b/src/main/java/org/apache/commons/scxml2/EvaluatorProvider.java
@@ -24,7 +24,7 @@ import org.apache.commons.scxml2.model.SCXML;
public interface EvaluatorProvider {
/**
- * @return a default or generic {@link Evaluator} supporting the {@link
#getSupportedDatamodel()}
+ * @return A default or generic {@link Evaluator} supporting the {@link
#getSupportedDatamodel()}
*/
Evaluator getEvaluator();
@@ -36,7 +36,7 @@ public interface EvaluatorProvider {
* </p>
*
* @param document the SCXML document
- * @return a new and not sharable Evaluator instance
+ * @return A new and not sharable Evaluator instance
*/
Evaluator getEvaluator(SCXML document);
diff --git a/src/main/java/org/apache/commons/scxml2/EventDispatcher.java
b/src/main/java/org/apache/commons/scxml2/EventDispatcher.java
index ec894fc6..49485334 100644
--- a/src/main/java/org/apache/commons/scxml2/EventDispatcher.java
+++ b/src/main/java/org/apache/commons/scxml2/EventDispatcher.java
@@ -42,7 +42,7 @@ public interface EventDispatcher {
* the EventDispatcher provides this newInstnace method to allow creating
a new instance without sharing its
* internal state.
*
- * @return a new EventDispatcher instance for usage in an invoked child
statemachine.
+ * @return A new EventDispatcher instance for usage in an invoked child
statemachine.
*/
EventDispatcher newInstance();
diff --git a/src/main/java/org/apache/commons/scxml2/PathResolver.java
b/src/main/java/org/apache/commons/scxml2/PathResolver.java
index 17363fa8..7c59c122 100644
--- a/src/main/java/org/apache/commons/scxml2/PathResolver.java
+++ b/src/main/java/org/apache/commons/scxml2/PathResolver.java
@@ -26,7 +26,7 @@ public interface PathResolver {
* Gets a PathResolver rooted at this context sensitive path.
*
* @param ctxPath Context sensitive path, can be a relative URL
- * @return a new resolver rooted at ctxPath
+ * @return A new resolver rooted at ctxPath
*/
PathResolver getResolver(String ctxPath);
diff --git
a/src/main/java/org/apache/commons/scxml2/SCInstanceObjectInputStream.java
b/src/main/java/org/apache/commons/scxml2/SCInstanceObjectInputStream.java
index 2a9c5703..c1b71c67 100644
--- a/src/main/java/org/apache/commons/scxml2/SCInstanceObjectInputStream.java
+++ b/src/main/java/org/apache/commons/scxml2/SCInstanceObjectInputStream.java
@@ -37,7 +37,7 @@ public class SCInstanceObjectInputStream extends
ObjectInputStream {
* Callback method invoked from {@link
SCInstanceObjectInputStream#resolveClass(ObjectStreamClass)}
*
* @param osc an instance of class ObjectStreamClass
- * @return a Class object corresponding to osc
+ * @return A Class object corresponding to osc
* @throws IOException if an I/O error occurs while reading the
instance of class ObjectStreamClass
* @throws ClassNotFoundException if the class is not found while
reading the instance of class ObjectStreamClass
*/
diff --git
a/src/main/java/org/apache/commons/scxml2/env/groovy/GroovyEvaluator.java
b/src/main/java/org/apache/commons/scxml2/env/groovy/GroovyEvaluator.java
index 46f2169e..8a3df0e8 100644
--- a/src/main/java/org/apache/commons/scxml2/env/groovy/GroovyEvaluator.java
+++ b/src/main/java/org/apache/commons/scxml2/env/groovy/GroovyEvaluator.java
@@ -127,7 +127,7 @@ public class GroovyEvaluator extends AbstractBaseEvaluator {
*
* @param ctx variable context
* @param expr expression
- * @return a result of the evaluation
+ * @return A result of the evaluation
* @throws SCXMLExpressionException For a malformed expression
* @see Evaluator#eval(Context, String)
*/
diff --git
a/src/main/java/org/apache/commons/scxml2/env/javascript/JSEvaluator.java
b/src/main/java/org/apache/commons/scxml2/env/javascript/JSEvaluator.java
index c9c9f63f..cde6dc76 100644
--- a/src/main/java/org/apache/commons/scxml2/env/javascript/JSEvaluator.java
+++ b/src/main/java/org/apache/commons/scxml2/env/javascript/JSEvaluator.java
@@ -292,7 +292,7 @@ public class JSEvaluator extends AbstractBaseEvaluator {
/**
* Creates a child context.
*
- * @return a new child JSContext.
+ * @return A new child JSContext.
*/
@Override
public Context newContext(final Context parent) {
diff --git
a/src/main/java/org/apache/commons/scxml2/env/jexl/JexlEvaluator.java
b/src/main/java/org/apache/commons/scxml2/env/jexl/JexlEvaluator.java
index 1e3007a5..57b7533b 100644
--- a/src/main/java/org/apache/commons/scxml2/env/jexl/JexlEvaluator.java
+++ b/src/main/java/org/apache/commons/scxml2/env/jexl/JexlEvaluator.java
@@ -100,7 +100,7 @@ public class JexlEvaluator extends AbstractBaseEvaluator {
*
* @param ctx variable context
* @param expr expression
- * @return a result of the evaluation
+ * @return A result of the evaluation
* @throws SCXMLExpressionException For a malformed expression
* @see Evaluator#eval(Context, String)
*/
diff --git a/src/main/java/org/apache/commons/scxml2/io/SCXMLReader.java
b/src/main/java/org/apache/commons/scxml2/io/SCXMLReader.java
index 1c9adadd..a9b098a5 100644
--- a/src/main/java/org/apache/commons/scxml2/io/SCXMLReader.java
+++ b/src/main/java/org/apache/commons/scxml2/io/SCXMLReader.java
@@ -563,7 +563,7 @@ public final class SCXMLReader {
/**
* @param prefix prefix
* @param localName localName
- * @return a qualified name from a prefix and localName
+ * @return A qualified name from a prefix and localName
*/
private static String createQualifiedName(final String prefix, final
String localName) {
return (prefix != null && !prefix.isEmpty() ? prefix + ":" : "") +
localName;
diff --git a/src/main/java/org/apache/commons/scxml2/io/SCXMLWriter.java
b/src/main/java/org/apache/commons/scxml2/io/SCXMLWriter.java
index 3159aad1..4cf3e4c6 100644
--- a/src/main/java/org/apache/commons/scxml2/io/SCXMLWriter.java
+++ b/src/main/java/org/apache/commons/scxml2/io/SCXMLWriter.java
@@ -269,7 +269,7 @@ public class SCXMLWriter {
/**
* @param prefix prefix
* @param localName localName
- * @return a qualified name from a prefix and localName
+ * @return A qualified name from a prefix and localName
*/
private static String createQualifiedName(final String prefix, final
String localName) {
return (prefix != null && !prefix.isEmpty() ? prefix + ":" : "") +
localName;
diff --git a/src/main/java/org/apache/commons/scxml2/model/SCXML.java
b/src/main/java/org/apache/commons/scxml2/model/SCXML.java
index bff73457..6bd8329f 100644
--- a/src/main/java/org/apache/commons/scxml2/model/SCXML.java
+++ b/src/main/java/org/apache/commons/scxml2/model/SCXML.java
@@ -157,7 +157,7 @@ public class SCXML implements Serializable, Observable {
/**
* Simple unique TransitionTarget id value generation
*
- * @return a unique TransitionTarget id for this SCXML instance
+ * @return A unique TransitionTarget id for this SCXML instance
*/
public final String generateTransitionTargetId() {
return GENERATED_TT_ID_PREFIX +ttNextId++;
diff --git
a/src/main/java/org/apache/commons/scxml2/model/TransitionalState.java
b/src/main/java/org/apache/commons/scxml2/model/TransitionalState.java
index 3781fbac..eb4f0b21 100644
--- a/src/main/java/org/apache/commons/scxml2/model/TransitionalState.java
+++ b/src/main/java/org/apache/commons/scxml2/model/TransitionalState.java
@@ -137,7 +137,7 @@ public abstract class TransitionalState extends
EnterableState {
/**
* Gets the list of history pseudo states for this state.
*
- * @return a list of all history pseudo states contained by a given state
+ * @return A list of all history pseudo states contained by a given state
* (can be empty)
* @see #hasHistory()
* @since 0.7
diff --git a/src/test/java/org/apache/commons/scxml2/w3c/W3CTests.java
b/src/test/java/org/apache/commons/scxml2/w3c/W3CTests.java
index 8319e0c1..447214de 100644
--- a/src/test/java/org/apache/commons/scxml2/w3c/W3CTests.java
+++ b/src/test/java/org/apache/commons/scxml2/w3c/W3CTests.java
@@ -467,7 +467,7 @@ public class W3CTests {
/**
* Unmarshall and return the W3C IRP tests manifest.xml
- * @return an Assertions instance reprenting the W3C IRP tests manifest.xml
+ * @return An Assertions instance reprenting the W3C IRP tests manifest.xml
* @throws Exception
*/
protected Assertions loadAssertions() throws Exception {
@@ -478,7 +478,7 @@ public class W3CTests {
/**
* Loads the tests.xml configuration file into a Tests class configuration
model instance.
- * @return a Tests instance for the tests.xml configuration file.
+ * @return A Tests instance for the tests.xml configuration file.
* @throws Exception
*/
protected Tests loadTests() throws Exception {