Author: bdelacretaz
Date: Mon Aug 3 11:42:16 2015
New Revision: 1693880
URL: http://svn.apache.org/r1693880
Log:
comment tweak
Modified:
sling/whiteboard/bdelacretaz/startup-stuff/startup-sequencer/src/main/java/org/apache/sling/startup/sequencer/StartLevelChangeBarrier.java
Modified:
sling/whiteboard/bdelacretaz/startup-stuff/startup-sequencer/src/main/java/org/apache/sling/startup/sequencer/StartLevelChangeBarrier.java
URL:
http://svn.apache.org/viewvc/sling/whiteboard/bdelacretaz/startup-stuff/startup-sequencer/src/main/java/org/apache/sling/startup/sequencer/StartLevelChangeBarrier.java?rev=1693880&r1=1693879&r2=1693880&view=diff
==============================================================================
---
sling/whiteboard/bdelacretaz/startup-stuff/startup-sequencer/src/main/java/org/apache/sling/startup/sequencer/StartLevelChangeBarrier.java
(original)
+++
sling/whiteboard/bdelacretaz/startup-stuff/startup-sequencer/src/main/java/org/apache/sling/startup/sequencer/StartLevelChangeBarrier.java
Mon Aug 3 11:42:16 2015
@@ -31,7 +31,12 @@ public interface StartLevelChangeBarrier
* right after increasing the start level.
*
* @param startLevel the start level that was just switched to
- * @return a latch or null if none is needed for this level
+ * @return a latch or null if none is needed for this level.
+ * The initial value of the latch is meaningless,
+ * it's just the latch reaching zero that is important.
+ * If a client needs complex logic to find out when things
+ * are ready, it can return a latch with an initial value
+ * of 1 and just bring that down to zero when ready.
*/
CountDownLatch getStartLevelLatch(int startLevel);
}