[foreign-memaccess+abi] Integrated: Refresh FFM documents

[Maurizio Cimadamore]

On Tue, 19 Dec 2023 14:29:21 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

> This PR brings the FFM documents in sync with the finalized API in JDK 22. The most obvious changes are:
> 
> * in the foreign memory document, the section on structured access has been rectified, to take into account the extra offset parameter that is added to memory access var handles;
> * in both documents, several calls to `allocateArray` and `allocateUtf8String` have been replaced with `allocateFrom`
> * the section introducing the `Linker` in the ffi document has been revamped; it now talks more at length about the mapping between layouts and C types. The table with Linux/x64 mappings has been moved to a section in the appendix, and I have also added a mention of `Linker::canonicalLayouts`

This pull request has now been integrated.

Changeset: f75fbac0
Author:    Maurizio Cimadamore <mcimadamore at openjdk.org>
URL:       https://git.openjdk.org/panama-foreign/commit/f75fbac0dd2f8a7861cd349872a27b86ddb53f35
Stats:     780 lines in 3 files changed: 39 ins; 706 del; 35 mod

Refresh FFM documents

Reviewed-by: pminborg, jvernee

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

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