svn commit: r1614818 - /jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/memory/MemoryNodeBuilder.java

[ju...@apache.org]

Author: jukka
Date: Thu Jul 31 07:53:02 2014
New Revision: 1614818

URL: http://svn.apache.org/r1614818
Log:
OAK-1995: Improved SegmentNodeStore documentation

Add a warning about the complex internals of MemoryNodeBuilder

Modified:
    jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/memory/MemoryNodeBuilder.java

Modified: jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/memory/MemoryNodeBuilder.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/memory/MemoryNodeBuilder.java?rev=1614818&r1=1614817&r2=1614818&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/memory/MemoryNodeBuilder.java (original)
+++ jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/memory/MemoryNodeBuilder.java Thu Jul 31 07:53:02 2014
@@ -16,6 +16,16 @@
  */
 package org.apache.jackrabbit.oak.plugins.memory;
 
+// WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! //
+//                                                                         //
+// This class has complex internals that have evolved in over a hundred    //
+// commits. It is a central component in how Oak handles modifications to  //
+// content trees. Please use 'svn blame', 'svn log' and the referenced     //
+// Jira issues to understand the reason for some of the more complex parts //
+// of this class. See also the MemoryNodeBuilderTest for existing tests.   //
+//                                                                         //
+// WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! //
+
 import java.io.IOException;
 import java.io.InputStream;