Index: oak-mk-api/src/main/java/org/apache/jackrabbit/mk/api/MicroKernel.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>MacRoman
===================================================================
--- oak-mk-api/src/main/java/org/apache/jackrabbit/mk/api/MicroKernel.java	(revision 1354857)
+++ oak-mk-api/src/main/java/org/apache/jackrabbit/mk/api/MicroKernel.java	(revision )
@@ -48,11 +48,20 @@
  * <p>
  * The <b>Retention Policy for Revisions</b>:
  * <p>
- * TODO specify retention policy for old revisions, i.e. minimal guaranteed retention period (OAK-114)
- * </p>
- * <p>
+ * A MicroKernel API consumer can expect that a revision id returned by
+ * {@link #getHeadRevision()}
+ * <ul>
+ * <li>stays <i>valid</i> for at least as long as there's no <i>more recent</i>
+ * head revision,</li>
+ * <li>otherwise stays <i>valid</i> for at least <b>10 minutes</b>.
+ * </li>
+ * </ul>
+ * (<i>valid</i> meaning the respective revision is guaranteed to be available
+ * for the specified period).
+ * <p/>
+ * MicroKernel implementations however are free to support longer retention periods.
+ * <p/>
  * The <b>Retention Policy for Binaries</b>:
- * </p>
  * <p>
  * The MicroKernel implementation is free to remove binaries if both of the
  * following conditions are met:
@@ -72,7 +81,10 @@
     //---------------------------------------------------------< REVISION ops >
 
     /**
-     * Return the id of the current head revision.
+     * Returns the id of the current head revision.
+     * <p/>
+     * The respective revision is guaranteed to be available for at least
+     * <i>10 minutes</i>.
      *
      * @return the id of the head revision
      * @throws MicroKernelException if an error occurs