Author: mduerig
Date: Tue Sep 18 09:24:54 2012
New Revision: 1387069
URL: http://svn.apache.org/viewvc?rev=1387069&view=rev
Log:
OAK-304 Rename ContentSession.getCurrentRoot()
- improve Javadoc
Modified:
jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/ContentSession.java
Modified: jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/ContentSession.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/ContentSession.java?rev=1387069&r1=1387068&r2=1387069&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/ContentSession.java
(original)
+++ jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/ContentSession.java
Tue Sep 18 09:24:54 2012
@@ -72,11 +72,9 @@ public interface ContentSession extends
* in that subtree the underlying Microkernel.
* <p>
* The root instance gives you a stable view of the tree at the time the
- * root is acquired. Changes by other sessions that were committed at the
- * time this method is called are usually visible, even thought there are no
- * strict guarantees that all changes are visible, specially when clustering
- * is used.
- * <p>
+ * root is acquired. In certain setups (i.e. clusters) changes committed
+ * through other sessions might not be immediately reflected through this
+ * call. <p>
* Please note this method is possibly expensive because it internally reads
* from the backend to detect if there were any changes (from any session).
*