svn commit: r1492668 - /jackrabbit/oak/trunk/doc/jsop-diff.md

[md...@apache.org]

Author: mduerig
Date: Thu Jun 13 13:32:24 2013
New Revision: 1492668

URL: http://svn.apache.org/r1492668
Log:
OAK-659 Move purge logic for transient changes below the NodeBuilder interface
jsop-diff is not sufficient. Put a not into the documentation

Modified:
    jackrabbit/oak/trunk/doc/jsop-diff.md

Modified: jackrabbit/oak/trunk/doc/jsop-diff.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/doc/jsop-diff.md?rev=1492668&r1=1492667&r2=1492668&view=diff
==============================================================================
--- jackrabbit/oak/trunk/doc/jsop-diff.md (original)
+++ jackrabbit/oak/trunk/doc/jsop-diff.md Thu Jun 13 13:32:24 2013
@@ -15,6 +15,22 @@
    limitations under the License.
   -->
 
+*Note:* Below algorithms turns out to be not sufficient. The edit script for the
+following case is incomplete. Given S constructed from an empty tree
+
+    S = +/s:{} +/t:{}
+
+obtain T from S by
+
+    T = S +/s/a:{} >/s:/t/s
+
+Running below algorithm on S and T will result in an edit script which, when
+applied to S, will not create child node a. I.e. it will result in
+
+    S >/s:/t/s
+
+* * *
+
 An algorithm for creating edit scripts (in JSOP format) from two trees.
 See [this GitHub repository](https://github.com/mduerig/json-diff) for a
 proof of concept implementation and