SF.net SVN: xmlunit: [257] trunk/xmlunit/src

[<bo...@us...>]

Revision: 257
          http://xmlunit.svn.sourceforge.net/xmlunit/?rev=257&view=rev
Author:   bodewig
Date:     2008-03-27 07:05:06 -0700 (Thu, 27 Mar 2008)

Log Message:
-----------
Document DifferenceListener changes

Modified Paths:
--------------
    trunk/xmlunit/src/java/org/custommonkey/xmlunit/DetailedDiff.java
    trunk/xmlunit/src/user-guide/XMLUnit-Java.xml

Modified: trunk/xmlunit/src/java/org/custommonkey/xmlunit/DetailedDiff.java
===================================================================
--- trunk/xmlunit/src/java/org/custommonkey/xmlunit/DetailedDiff.java	2008-03-26 20:59:54 UTC (rev 256)
+++ trunk/xmlunit/src/java/org/custommonkey/xmlunit/DetailedDiff.java	2008-03-27 14:05:06 UTC (rev 257)
@@ -1,6 +1,6 @@
 /*
 ******************************************************************
-Copyright (c) 2001-2007, Jeff Martin, Tim Bacon
+Copyright (c) 2001-2008, Jeff Martin, Tim Bacon
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

Modified: trunk/xmlunit/src/user-guide/XMLUnit-Java.xml
===================================================================
--- trunk/xmlunit/src/user-guide/XMLUnit-Java.xml	2008-03-26 20:59:54 UTC (rev 256)
+++ trunk/xmlunit/src/user-guide/XMLUnit-Java.xml	2008-03-27 14:05:06 UTC (rev 257)
@@ -1639,7 +1639,7 @@
       ignored by <literal>DifferenceEngine</literal>, it becomes
       important when used together with <literal>Diff</literal>,
       though (see <xref linkend="Diff"/>).  The return value should be
-      one of the three constants defined in the the
+      one of the four constants defined in the the
       <literal>DifferenceListener</literal> interface:</para>
 
       <programlisting language="Java"><![CDATA[
@@ -1661,6 +1661,12 @@
      * interpreted as being similar.
      */
     int RETURN_IGNORE_DIFFERENCE_NODES_SIMILAR;
+    /** 
+     * Override return value for the <code>differenceFound</code> method.
+     * Indicates that the nodes identified as being similar should be 
+     * interpreted as being different.
+     */
+    int RETURN_UPGRADE_DIFFERENCE_NODES_DIFFERENT = 3;
 ]]></programlisting>
 
       <para>The <literal>skippedComparison</literal> method is
@@ -3366,6 +3372,13 @@
           addition to W3C XML Schema.  See
           <xref linkend="JAXP 1.3 Validation"/> for details.</listitem>
 
+          <listitem><literal>DifferenceListener</literal> can now
+          "upgrade" recoverable differences to non-recoverable by
+          returning <literal>RETURN_UPGRADE_DIFFERENCE_NODES_DIFFERENT</literal>
+          in the <literal>differenceFound</literal>
+          method.  <ulink url="https://sourceforge.net/tracker/index.php?func=detail&amp;aid=1854284&amp;group_id=23187&amp;atid=377771">Issue
+          1854284</ulink>.</listitem>
+
           <listitem>New examples have been added:
             <itemizedlist>
               <listitem><literal>RecursiveElementNameAndTextQualifier</literal>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.