[LUCENE-793] Javadocs should explain possible causes for IOExceptions

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 2.2
• Component/s: general/javadocs
• Lucene Fields: New
• Assignee: Michael McCandless
• Reporter: Michael McCandless
• Created: 02/Feb/07 10:17
• Updated: 28/Aug/22 11:34
• Resolved: 21/Feb/07 20:02

Description

Most methods in Lucene reserve the right to throw an IOException. This can occur for nearly all methods from low level problems like wrong permissions, transient IO errors, bad hard drive or corrupted file system, corrupted index, etc, but for some methods there are also more interesting causes that we should try to document.

Spinoff of this thread:

http://www.gossamer-threads.com/lists/lucene/java-user/44929