SLING-2128 : Provide plain Repository services as SlingRepository services

git-svn-id: https://svn.apache.org/repos/asf/sling/trunk@1143680 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/sling/jcr/base/AbstractNamespaceMappingRepository.java b/src/main/java/org/apache/sling/jcr/base/AbstractNamespaceMappingRepository.java
index da5dd8b..f5b04b5 100644
--- a/src/main/java/org/apache/sling/jcr/base/AbstractNamespaceMappingRepository.java
+++ b/src/main/java/org/apache/sling/jcr/base/AbstractNamespaceMappingRepository.java
@@ -28,13 +28,9 @@
 import org.osgi.util.tracker.ServiceTracker;
 
 /**
- * The <code>AbstractSlingRepository</code> is an abstract implementation of
+ * The <code>AbstractNamespaceMappingRepository</code> is an abstract implementation of
  * the {@link SlingRepository} interface which provides default support for
- * attached repositories as well as ensuring live repository connection,
- * reconnecting if needed. Implementations of the <code>SlingRepository</code>
- * interface may wish to extend this class to benefit from a default
- * implementation.
- *
+ * namespace mapping.
  */
 public abstract class AbstractNamespaceMappingRepository implements SlingRepository {
 
@@ -81,6 +77,9 @@
         }
     }
 
+    /**
+     * Return a namespace aware session.
+     */
     protected Session getNamespaceAwareSession(final Session session) throws RepositoryException {
         if ( session == null ) {  // sanity check
             return null;
diff --git a/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryProvider.java b/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryProvider.java
index 5ef10fe..8ac2e3c 100644
--- a/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryProvider.java
+++ b/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryProvider.java
@@ -36,6 +36,10 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+/**
+ * The repository provider listens for javax.jcr.Repository services and wraps
+ * them as SlingRepository services (if required)
+ */
 @Component(specVersion="1.1")
 @Reference(name="repository",
            referenceInterface=Repository.class,
diff --git a/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryWrapper.java b/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryWrapper.java
index c0b473e..64c773b 100644
--- a/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryWrapper.java
+++ b/src/main/java/org/apache/sling/jcr/base/internal/SlingRepositoryWrapper.java
@@ -32,7 +32,7 @@
 import org.osgi.framework.BundleContext;
 
 /**
- *
+ * Repository wrapper
  */
 public class SlingRepositoryWrapper
     extends AbstractNamespaceMappingRepository