Index: BooleanQuery.java
===================================================================
RCS file: /home/cvspublic/jakarta-lucene/src/java/org/apache/lucene/search/BooleanQuery.java,v
retrieving revision 1.26
diff -u -3 -p -r1.26 BooleanQuery.java
--- BooleanQuery.java	19 Oct 2004 19:51:35 -0000	1.26
+++ BooleanQuery.java	23 Nov 2004 19:12:08 -0000
@@ -26,13 +26,18 @@ import org.apache.lucene.index.IndexRead
 public class BooleanQuery extends Query {
   
   /** The maximum number of clauses permitted. Default value is 1024.
-   * Use the <code>org.apache.lucene.maxClauseCount</code> system property to override.
-   * <p>TermQuery clauses are generated from for example prefix queries and fuzzy queries.
-   * Each TermQuery needs some buffer space during search, so this parameter indirectly 
-   * controls the maximum buffer requirements for query search. Normally the buffers
-   * are allocated by the JVM. When using for example
-   * {@link org.apache.lucene.store.MMapDirectory} the buffering is left to the 
-   * operating system.</p>
+   * Use the <code>org.apache.lucene.maxClauseCount</code> system property
+   * to override.
+   * <p>TermQuery clauses are generated from for example prefix queries and
+   * fuzzy queries. Each TermQuery needs some buffer space during search,
+   * so this parameter indirectly controls the maximum buffer requirements for
+   * query search.
+   * <p>When this parameter becomes a bottleneck for a Query one can use a
+   * Filter. For example instead of a {@link RangeQuery} one can use a
+   * {@link RangeFilter}.
+   * <p>Normally the buffers are allocated by the JVM. When using for example
+   * {@link org.apache.lucene.store.MMapDirectory} the buffering is left to
+   * the operating system.
    */
   public static int maxClauseCount =
     Integer.parseInt(System.getProperty("org.apache.lucene.maxClauseCount",