javadocs

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1503759 13f79535-47bb-0310-9956-ffa450edef68

lucene/core/src/java/org/apache/lucene/index/IndexDeletionPolicy.java

@@ -78,6 +78,8 @@ public abstract class IndexDeletionPolicy implements Cloneable {
    * @param commits List of current 
    * {@link IndexCommit point-in-time commits},
    *  sorted by age (the 0th one is the oldest commit).
+   *  Note that for a new index this method is invoked with
+   *  an empty list.
    */
   public abstract void onInit(List<? extends IndexCommit> commits) throws IOException;