RFR: 8304265: Implementation of Foreign Function and Memory API (Third Preview) [v5]

[Per Minborg]

On Tue, 21 Mar 2023 00:54:10 GMT, Paul Sandoz <psandoz at openjdk.org> wrote:

>> Per Minborg has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Add example for Option::captureStateLayout
>
> src/java.base/share/classes/java/lang/foreign/Linker.java line 621:
> 
>> 619:          *          to a downcall handle linked with {@link #captureCallState(String...)}}
>> 620:          *
>> 621:          * @see #captureCallState(String...)
> 
> How does a caller know what the structure may contain? Should we document the platform specific structures?

I've added an example of how to print the platform-dependent structure. Should we document anyhow?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13079#discussion_r1143055969