RFR: 8295044: Implementation of Foreign Function and Memory API (Second Preview) [v22]

[Per Minborg]

On Tue, 15 Nov 2022 12:34:43 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> This PR contains the API and implementation changes for JEP-434 [1]. A more detailed description of such changes, to avoid repetitions during the review process, is included as a separate comment.
>> 
>> [1] - https://openjdk.org/jeps/434
>
> Maurizio Cimadamore has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Add `since` tag in Module/ModuleLayer preview methods

src/java.base/share/classes/java/lang/foreign/Arena.java line 89:

> 87: 
> 88:     /**
> 89:      * Returns a native memory segment with the given size (in bytes) and alignment constraint (in bytes).

It is noted that the current documentation does not require a **new** native memory segment to be returned. Would it not be better with:

Creates a new native memory segment ...

The new shared segment might share actual backing memory though.

-------------

PR: https://git.openjdk.org/jdk/pull/10872