http://www.gossamer-threads.com/lists/lucene/java-dev/47895 Added javadocs about when to call optimize() method.
lucene/java/trunk/src/java/org/apache/lucene/index/IndexWriter.java