LUCENE-3866: Add some JavaDocs to prevent modification of the array containing the sequential subreaders. This is a trap! We should maybe change getSequentialSubReaders and similar methods in IndexReaderContext to return List<R extends IndexReader>. I will open issue for discussion.
lucene/dev/trunk/lucene/core/src/java/org/apache/lucene/index/BaseCompositeReader.java