Index: src/java/org/apache/lucene/index/IndexReader.java
===================================================================
--- src/java/org/apache/lucene/index/IndexReader.java	(revision 834790)
+++ src/java/org/apache/lucene/index/IndexReader.java	(working copy)
@@ -121,7 +121,19 @@
   
   private int refCount;
 
-  static int DEFAULT_TERMS_INDEX_DIVISOR = 1;
+  /**
+   * Term index divisor sub-samples which indexed terms are loaded into RAM.
+   * When set to N, then one in every N*termIndexInterval terms in the index is
+   * loaded into memory. By setting this to a value > 1 you can reduce memory
+   * usage, at the expense of higher latency when loading a TermInfo. The
+   * default value is 1. Set this to -1 to skip loading the terms index
+   * entirely.
+   * 
+   * @see {@link IndexWriter#setTermIndexInterval}
+   * @see #open(Directory, IndexDeletionPolicy, boolean, int)
+   * @see #open(IndexCommit, IndexDeletionPolicy, boolean, int)
+   */
+  public static final int DEFAULT_TERMS_INDEX_DIVISOR = 1;
 
   /** Expert: returns the current refCount for this reader */
   public synchronized int getRefCount() {