Update javadocs after comments

Author: minborg

src/java.base/share/classes/java/lang/foreign/MemorySegment.java

@@ -27,6 +27,7 @@
 package java.lang.foreign;
 
 import java.io.UncheckedIOException;
+import java.lang.ref.Cleaner;
 import java.lang.reflect.Array;
 import java.lang.invoke.MethodHandles;
 import java.nio.Buffer;
@@ -1118,7 +1119,7 @@ static MemorySegment ofAddress(long address, long byteSize, MemorySession sessio
      * <p>
      * Clients are responsible for ensuring that the memory session associated with the returned segment is
      * closed when segments are no longer in use. Failure to do so will result in off-heap memory leaks. As an
-     * alternative to explicitly invoke {@link MemorySession#close()}, sessions backed with a Cleaner
+     * alternative to explicitly invoke {@link MemorySession#close()}, sessions backed with a {@link Cleaner}
      * (such as {@linkplain MemorySession#openImplicit()}) can be used, allowing the returned segment to be
      * automatically released some unspecified time after the session is no longer referenced.
      * <p>
@@ -1137,8 +1138,7 @@ static MemorySegment ofAddress(long address, long byteSize, MemorySession sessio
      * @param session the session to which the returned segment is associated.
      * @return a new native segment.
      * @throws IllegalStateException if the {@code session} is not {@linkplain MemorySession#isAlive() alive}.
-     * @throws WrongThreadException  if this method is invoked by a thread other than the
-     *                               {@linkplain MemorySession#ownerThread() owner thread} (if any).
+     * @throws WrongThreadException if this method is called from a thread other than the thread owning {@code session}.
      * @see MemorySession#allocate(MemoryLayout)
      */
     static MemorySegment allocateNative(MemoryLayout layout, MemorySession session) {
@@ -1151,7 +1151,7 @@ static MemorySegment allocateNative(MemoryLayout layout, MemorySession session)
      * <p>
      * Clients are responsible for ensuring that the memory session associated with the returned segment is
      * closed when segments are no longer in use. Failure to do so will result in off-heap memory leaks. As an
-     * alternative to explicitly invoke {@link MemorySession#close()}, sessions backed with a Cleaner
+     * alternative to explicitly invoke {@link MemorySession#close()}, sessions backed with a {@link Cleaner}
      * (such as {@linkplain MemorySession#openImplicit()}) can be used, allowing the returned segment to be
      * automatically released some unspecified time after the session is no longer referenced.
      * <p>
@@ -1173,8 +1173,7 @@ static MemorySegment allocateNative(MemoryLayout layout, MemorySession session)
      * @return a new native memory segment.
      * @throws IllegalArgumentException if {@code byteSize < 0}.
      * @throws IllegalStateException if the {@code session} is not {@linkplain MemorySession#isAlive() alive}.
-     * @throws WrongThreadException  if this method is invoked by a thread other than the
-     *                               {@linkplain MemorySession#ownerThread() owner thread} (if any).
+     * @throws WrongThreadException if this method is called from a thread other than the thread owning {@code session}.
      * @see ByteBuffer#allocateDirect(int)
      * @see MemorySession#allocate(long)
      */
@@ -1188,7 +1187,7 @@ static MemorySegment allocateNative(long byteSize, MemorySession session) {
      * <p>
      * Clients are responsible for ensuring that the memory session associated with the returned segment is
      * closed when segments are no longer in use. Failure to do so will result in off-heap memory leaks. As an
-     * alternative to explicitly invoke {@link MemorySession#close()}, sessions backed with a Cleaner
+     * alternative to explicitly invoke {@link MemorySession#close()}, sessions backed with a {@link Cleaner}
      * (such as {@linkplain MemorySession#openImplicit()}) can be used, allowing the returned segment to be
      * automatically released some unspecified time after the session is no longer referenced.
      * <p>
@@ -1214,8 +1213,7 @@ static MemorySegment allocateNative(long byteSize, MemorySession session) {
      * @throws IllegalArgumentException if {@code byteSize < 0}, {@code byteAlignment <= 0}, or if {@code byteAlignment}
      *                                  is not a power of 2.
      * @throws IllegalStateException    if the {@code session} is not {@linkplain MemorySession#isAlive() alive}.
-     * @throws WrongThreadException     if this method is invoked by a thread other than the
-     *                                  {@linkplain MemorySession#ownerThread() owner thread} (if any).
+     * @throws WrongThreadException if this method is called from a thread other than the thread owning {@code session}.
      * @see MemorySession#allocate(long, long)
      */
     static MemorySegment allocateNative(long byteSize, long byteAlignment, MemorySession session) {

src/java.base/share/classes/java/lang/foreign/package-info.java

@@ -42,7 +42,7 @@
  * and fill it with values ranging from {@code 0} to {@code 9}, we can use the following code:
  *
  * {@snippet lang=java :
- * MemorySegment segment = MemorySegment.allocateNative(10 * 4, session);
+ * MemorySegment segment = MemorySegment.allocateNative(10 * 4, MemorySession.openImplicit());
  * for (int i = 0 ; i < 10 ; i++) {
  *     segment.setAtIndex(ValueLayout.JAVA_INT, i, i);
  * }