svn commit: r1325662 - /jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Connection.java

[an...@apache.org]

Author: angela
Date: Fri Apr 13 08:48:59 2012
New Revision: 1325662

URL: http://svn.apache.org/viewvc?rev=1325662&view=rev
Log:
javadoc

Modified:
    jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Connection.java

Modified: jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Connection.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Connection.java?rev=1325662&r1=1325661&r2=1325662&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Connection.java (original)
+++ jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Connection.java Fri Apr 13 08:48:59 2012
@@ -22,7 +22,7 @@ import java.io.Closeable;
  * The {@code Connection} interface ...
  *
  * - retrieving information from persistent layer (MK) that are accessible to
- *   a given session
+ *   a given JCR session
  *
  * - validate information being written back to the persistent layer. this includes
  *   permission evaluation, node type and name constraints etc.
@@ -43,6 +43,7 @@ import java.io.Closeable;
  *   {@link RepositoryService#login(Object, String)} are bound to the workspace
  *   passed to the login method. Connections acquired by
  *   {@link Connection#getRepositoryConnection()} are bound to the whole repository.
+ *   TODO: check if that is really necessary, desirable and feasible.
  *
  * TODO: describe how this interface is intended to handle validation: nt, names, ac, constraints...
  */