Skip to content

Commit

Permalink
Fix MMapDirectory documentation for Java 20 (apache#12265)
Browse files Browse the repository at this point in the history
  • Loading branch information
uschindler authored and alessandrobenedetti committed May 12, 2023
1 parent 9cb17b0 commit ca5b831
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions lucene/core/src/java/org/apache/lucene/store/MMapDirectory.java
Original file line number Diff line number Diff line change
Expand Up @@ -76,9 +76,9 @@
* <li>{@code permission java.lang.RuntimePermission "accessClassInPackage.sun.misc";}
* </ul>
*
* <p>On exactly <b>Java 19</b> this class will use the modern {@code MemorySegment} API which
* allows to safely unmap (if you discover any problems with this preview API, you can disable it by
* using system property {@link #ENABLE_MEMORY_SEGMENTS_SYSPROP}).
* <p>On exactly <b>Java 19</b> and <b>Java 20</b> this class will use the modern {@code
* MemorySegment} API which allows to safely unmap (if you discover any problems with this preview
* API, you can disable it by using system property {@link #ENABLE_MEMORY_SEGMENTS_SYSPROP}).
*
* <p><b>NOTE:</b> Accessing this class either directly or indirectly from a thread while it's
* interrupted can close the underlying channel immediately if at the same time the thread is
Expand Down Expand Up @@ -123,7 +123,7 @@ public class MMapDirectory extends FSDirectory {
* Default max chunk size:
*
* <ul>
* <li>16 GiBytes for 64 bit <b>Java 19</b> JVMs
* <li>16 GiBytes for 64 bit <b>Java 19</b> and <b>Java 20</b> JVMs
* <li>1 GiBytes for other 64 bit JVMs
* <li>256 MiBytes for 32 bit JVMs
* </ul>
Expand Down Expand Up @@ -198,9 +198,9 @@ public MMapDirectory(Path path, long maxChunkSize) throws IOException {
* files cannot be mapped. Using a lower chunk size makes the directory implementation a little
* bit slower (as the correct chunk may be resolved on lots of seeks) but the chance is higher
* that mmap does not fail. On 64 bit Java platforms, this parameter should always be large (like
* 1 GiBytes, or even larger with Java 19), as the address space is big enough. If it is larger,
* fragmentation of address space increases, but number of file handles and mappings is lower for
* huge installations with many open indexes.
* 1 GiBytes, or even larger with recent Java versions), as the address space is big enough. If it
* is larger, fragmentation of address space increases, but number of file handles and mappings is
* lower for huge installations with many open indexes.
*
* <p><b>Please note:</b> The chunk size is always rounded down to a power of 2.
*
Expand Down

0 comments on commit ca5b831

Please sign in to comment.