Return-Path: 
 <oak-commits-return-1652-apmail-jackrabbit-oak-commits-archive=jackrabbit.apache.org@jackrabbit.apache.org>
X-Original-To: apmail-jackrabbit-oak-commits-archive@minotaur.apache.org
Delivered-To: apmail-jackrabbit-oak-commits-archive@minotaur.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id A7CB8D667
	for <apmail-jackrabbit-oak-commits-archive@minotaur.apache.org>;
 Mon, 17 Sep 2012 09:29:28 +0000 (UTC)
Received: (qmail 66200 invoked by uid 500); 17 Sep 2012 09:29:28 -0000
Delivered-To: apmail-jackrabbit-oak-commits-archive@jackrabbit.apache.org
Received: (qmail 66163 invoked by uid 500); 17 Sep 2012 09:29:28 -0000
Mailing-List: contact oak-commits-help@jackrabbit.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:oak-commits-help@jackrabbit.apache.org>
List-Unsubscribe: <mailto:oak-commits-unsubscribe@jackrabbit.apache.org>
List-Post: <mailto:oak-commits@jackrabbit.apache.org>
List-Id: <oak-commits.jackrabbit.apache.org>
Reply-To: oak-dev@jackrabbit.apache.org
Delivered-To: mailing list oak-commits@jackrabbit.apache.org
Received: (qmail 66143 invoked by uid 99); 17 Sep 2012 09:29:27 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 17 Sep 2012 09:29:27 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 17 Sep 2012 09:29:25 +0000
Received: from eris.apache.org (localhost [127.0.0.1])
	by eris.apache.org (Postfix) with ESMTP id 79F4C2388900;
	Mon, 17 Sep 2012 09:28:42 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1386527 -
 /jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/ContentSession.java
Date: Mon, 17 Sep 2012 09:28:42 -0000
To: oak-commits@jackrabbit.apache.org
From: thomasm@apache.org
X-Mailer: svnmailer-1.0.8-patched
Message-Id: <20120917092842.79F4C2388900@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: thomasm
Date: Mon Sep 17 09:28:41 2012
New Revision: 1386527

URL: http://svn.apache.org/viewvc?rev=1386527&view=rev
Log:
OAK-304 Rename ContentSession.getCurrentRoot() - document that changes are usually visible

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=1386527&r1=1386526&r2=1386527&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 Mon Sep 17 09:28:41 2012
@@ -72,7 +72,10 @@ 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.
+     * 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>
      * Please note this method is possibly expensive because it internally reads
      * from the backend to detect if there were any changes (from any session).