[LUCENE-4164] Improve IndexWriter.addIndexes(IndexReader) javadocs

• Type: Improvement
• Status: Closed
• Priority: Trivial
• Resolution: Fixed
• Fix Version/s: 4.0-ALPHA, 6.0
• Component/s: core/index
• Lucene Fields: New, Patch Available
• Assignee: Shai Erera
• Reporter: Shai Erera
• Created: 25/Jun/12 07:02
• Updated: 28/Aug/22 13:20
• Resolved: 26/Jun/12 07:31

Description

IndexWriter.addIndexes(IndexReader) needs some improvements:

• It falsely states that this method blocks any add/delete documents attempts.

• It merges all input IndexReaders at once, and not e.g. like MergePolicy does at mergeFactor steps. Therefore I think it'd be good to clarify it to the user, and also encourage him to call this method several times if he has many IndexReaders to merge.
  • And while at it, mentioning that the IR can be opened with termIndexInterval=-1 since we don't need it during merge will be good – saves RAM.

I'll attach a patch shortly.