[foreign-memaccess+abi] RFR: Refresh FFM API documents [v2]

[Jorn Vernee]

On Tue, 14 Mar 2023 11:12:46 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> This patch refreshes the FFM API documents to reflect the latest API changes. There has been some reshuffling: I realized that we had two sections on unsafe memory segments, one at the end of the memory document, another at the beginning of the FFI document. Since unsafe segments are more common when interacting with native functions, I just kept the latter (and enhanced to explain the options in more details).
>> 
>> I also moved (and rewrote) the segment allocator section from the FFI doc to the memory document, as I think working with allocators and using custom arenas is more generally useful, even outside FFI support.
>> 
>> I also cleaned up a lot of minor incongruences in the code snippets, text and footnotes which still referred to old API names and concepts.
>
> Maurizio Cimadamore has updated the pull request incrementally with two additional commits since the last revision:
> 
>  - Update document date
>  - Address review comments

Marked as reviewed by jvernee (Committer).

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

PR: https://git.openjdk.org/panama-foreign/pull/805