javadoc improvement: clarify impact of IndexWriter's autoCommit flag on IndexReader's isCurrent method

git-svn-id: https://svn.apache.org/repos/asf/lucene/java/trunk@542492 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Michael McCandless 2007-05-29 11:26:09 +00:00
parent 14ba4adfbe
commit 4ef95040cb
1 changed files with 9 additions and 3 deletions

View File

@ -322,9 +322,15 @@ public abstract class IndexReader {
}
/**
* Check whether this IndexReader still works on a current version of the index.
* If this is not the case you will need to re-open the IndexReader to
* make sure you see the latest changes made to the index.
* Check whether this IndexReader is still using the
* current (i.e., most recently committed) version of the
* index. If a writer has committed any changes to the
* index since this reader was opened, this will return
* <code>false</code>, in which case you must open a new
* IndexReader in order to see the changes. See the
* description of the <a href="IndexWriter.html#autoCommit"><code>autoCommit</code></a>
* flag which controls when the {@link IndexWriter}
* actually commits changes to the index.
*
* @throws CorruptIndexException if the index is corrupt
* @throws IOException if there is a low-level IO error