Author: rahul
Date: Thu Jan 3 14:18:41 2008
New Revision: 608658
URL: http://svn.apache.org/viewvc?rev=608658&view=rev
Log:
Clarify that parser(s) have undefined behavior when supplied with malformed or
incorrect SCXML documents.
Modified:
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLDigester.java
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLParser.java
Modified:
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLDigester.java
URL:
http://svn.apache.org/viewvc/commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLDigester.java?rev=608658&r1=608657&r2=608658&view=diff
==============================================================================
---
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLDigester.java
(original)
+++
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLDigester.java
Thu Jan 3 14:18:41 2008
@@ -88,6 +88,10 @@
* ruleset.</li>
* </ol>
*
+ * <p><b>NOTE:</b> The SCXMLDigester assumes that the SCXML document to be
+ * parsed is well-formed and correct. If that assumption does not hold,
+ * any subsequent behavior is undefined.</p>
+ *
* @deprecated Use [EMAIL PROTECTED] SCXMLParser} instead, after updating the
SCXML
* document as necessary, in line with newer Working Drafts.
*/
Modified:
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLParser.java
URL:
http://svn.apache.org/viewvc/commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLParser.java?rev=608658&r1=608657&r2=608658&view=diff
==============================================================================
---
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLParser.java
(original)
+++
commons/proper/scxml/trunk/src/main/java/org/apache/commons/scxml/io/SCXMLParser.java
Thu Jan 3 14:18:41 2008
@@ -99,6 +99,10 @@
* </ul>
* <p>See latest version of the SCXML Working Draft for more details.</p>
*
+ * <p><b>NOTE:</b> The SCXMLParser assumes that the SCXML document to be
+ * parsed is well-formed and correct. If that assumption does not hold,
+ * any subsequent behavior is undefined.</p>
+ *
* @since 0.7
*/
public final class SCXMLParser {
