git: openjdk/jdk21: 8308645: Javadoc of FFM API needs to be refreshed

[Maurizio Cimadamore]

Changeset: 20371fd9
Author:    Maurizio Cimadamore <mcimadamore at openjdk.org>
Date:      2023-06-12 15:24:51 +0000
URL:       https://git.openjdk.org/jdk21/commit/20371fd918124451a068cb9647deebba7c9b4cba

8308645: Javadoc of FFM API needs to be refreshed
8309398: ValueLayout:: arrayElementVarHandle doesn't throws UnsupportedOperationException - if byteAlignment() > byteSize()
8308812: SequenceLayout::withElementCount(long elementCount) doesn't throw IllegalArgumentException - if elementCount < 0 for some cases

Reviewed-by: jvernee

! src/java.base/share/classes/java/lang/foreign/AddressLayout.java
! src/java.base/share/classes/java/lang/foreign/Arena.java
! src/java.base/share/classes/java/lang/foreign/FunctionDescriptor.java
! src/java.base/share/classes/java/lang/foreign/GroupLayout.java
! src/java.base/share/classes/java/lang/foreign/Linker.java
! src/java.base/share/classes/java/lang/foreign/MemoryLayout.java
! src/java.base/share/classes/java/lang/foreign/MemorySegment.java
! src/java.base/share/classes/java/lang/foreign/SegmentAllocator.java
! src/java.base/share/classes/java/lang/foreign/SequenceLayout.java
! src/java.base/share/classes/java/lang/foreign/SymbolLookup.java
! src/java.base/share/classes/java/lang/foreign/ValueLayout.java
! src/java.base/share/classes/java/lang/foreign/package-info.java
! src/java.base/share/classes/java/lang/foreign/snippet-files/Snippets.java
! src/java.base/share/classes/java/lang/invoke/MethodHandles.java
! src/java.base/share/classes/jdk/internal/foreign/AbstractMemorySegmentImpl.java
! src/java.base/share/classes/jdk/internal/foreign/Utils.java
! src/java.base/share/classes/jdk/internal/foreign/abi/AbstractLinker.java
! src/java.base/share/classes/jdk/internal/foreign/layout/SequenceLayoutImpl.java
! src/java.base/share/classes/jdk/internal/foreign/layout/ValueLayouts.java
! test/jdk/java/foreign/TestArrayCopy.java
! test/jdk/java/foreign/TestDereferencePath.java
! test/jdk/java/foreign/TestIllegalLink.java
! test/jdk/java/foreign/TestLayoutPaths.java
! test/jdk/java/foreign/TestLayouts.java
! test/jdk/java/foreign/TestMemoryAccessInstance.java
! test/jdk/java/foreign/TestSegmentAllocators.java
! test/jdk/java/foreign/TestSegmentCopy.java
! test/jdk/java/foreign/TestSlices.java