archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 14:54:52 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8336039: Doccheck: HTML warnings, broken links and missing files in java.base documentation

Browse source 
Reviewed-by: liach, djelinski
This commit is contained in:
Nizar Benalla 2024-07-22 13:27:12 +00:00 • committed by Chen Liang
parent 7ddd02599c
commit 92de2b2d5f
8 changed files with 19 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

2
src/java.base/share/classes/java/lang/foreign/Arena.java
View file

@ -61,7 +61,7 @@ import java.util.function.Consumer;
* by the garbage collector. The scope of an automatic arena is an automatic scope. As
* such, the regions of memory backing memory segments allocated with the automatic arena
* are deallocated at some unspecified time <em>after</em> the automatic arena (and all
* the segments allocated by it) becomes <a href="../../../java/lang/ref/package.html#reachability">unreachable</a>,
* the segments allocated by it) becomes {@linkplain java.lang.ref##reachability unreachable},
* as shown below:
* {@snippet lang = java:
* MemorySegment segment = Arena.ofAuto().allocate(100, 1); // @highlight regex='ofAuto()'

8
src/java.base/share/classes/java/lang/foreign/MemorySegment.java
View file

@ -517,7 +517,7 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
*
* @apiNote When using this method to pass a segment address to some external
* operation (e.g. a JNI function), clients must ensure that the segment is
* kept <a href="../../../java/lang/ref/package.html#reachability">reachable</a>
* kept {@linkplain java.lang.ref##reachability reachable}
* for the entire duration of the operation. A failure to do so might result
* in the premature deallocation of the region of memory backing the memory
* segment, in case the segment has been allocated with an
@ -785,7 +785,7 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
* backing region of memory is no longer available. Furthermore, if the
* provided scope is the scope of an {@linkplain Arena#ofAuto() automatic arena},
* the cleanup action must not prevent the scope from becoming
* <a href="../../../java/lang/ref/package.html#reachability">unreachable</a>.
* {@linkplain java.lang.ref##reachability unreachable}.
* A failure to do so will permanently prevent the regions of memory
* allocated by the automatic arena from being deallocated.
*
@ -836,7 +836,7 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
* backing region of memory is no longer available. Furthermore, if the
* provided scope is the scope of an {@linkplain Arena#ofAuto() automatic arena},
* the cleanup action must not prevent the scope from becoming
* <a href="../../../java/lang/ref/package.html#reachability">unreachable</a>.
* {@linkplain java.lang.ref##reachability unreachable}.
* A failure to do so will permanently prevent the regions of memory
* allocated by the automatic arena from being deallocated.
*
@ -2662,7 +2662,7 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
* invalidated, either {@link Arena#close() explicitly}, or automatically, by the
* garbage collector. A segment scope that is invalidated automatically is an
* <em>automatic scope</em>. An automatic scope is always {@link #isAlive() alive}
* as long as it is <a href="../../../java/lang/ref/package.html#reachability">reachable</a>.
* as long as it is {@linkplain java.lang.ref##reachability reachable}.
* Segments associated with an automatic scope are:
* <ul>
* <li>Segments obtained from an {@linkplain Arena#ofAuto() automatic arena};</li>

2
src/java.base/share/classes/java/lang/foreign/SymbolLookup.java
View file

@ -219,7 +219,7 @@ public interface SymbolLookup {
* were loaded after this method returned.
* <p>
* Libraries associated with a class loader are unloaded when the class loader becomes
* <a href="../../../java/lang/ref/package.html#reachability">unreachable</a>. The
* {@linkplain java.lang.ref##reachability unreachable}. The
* symbol lookup returned by this method is associated with an automatic
* {@linkplain MemorySegment.Scope scope} which keeps the caller's class loader
* reachable. Therefore, libraries associated with the caller's class loader are