[LUCENE-3926] Improve Javadocs of RAMDirectory to document its limitations

• Type: Sub-task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.5, 4.0-ALPHA
• Fix Version/s: 3.6, 4.0-ALPHA
• Component/s: core/store
• Lucene Fields: New
• Assignee: Uwe Schindler
• Reporter: Uwe Schindler
• Created: 26/Mar/12 15:39
• Updated: 27/Aug/24 15:38
• Resolved: 27/Mar/12 11:49

Description

Spinoff from several dev@lao issues:

• http://mail-archives.apache.org/mod_mbox/lucene-dev/201112.mbox/%3C001001ccbf1c%2471845830%24548d0890%24%40thetaphi.de%3E
• issue LUCENE-3653

The use cases for RAMDirectory are very limited and to prevent users from using it for e.g. loading a 50 Gigabyte index from a file on disk, we should improve the javadocs.