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

Maurizio Cimadamore mcimadamore at openjdk.org
Tue Dec 19 16:13:25 UTC 2023


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`

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

Commit messages:
 - Fix tab
 - Update Linker document
 - Refresh foreign memory API doc

Changes: https://git.openjdk.org/panama-foreign/pull/914/files
 Webrev: https://webrevs.openjdk.org/?repo=panama-foreign&pr=914&range=00
  Stats: 779 lines in 3 files changed: 39 ins; 705 del; 35 mod
  Patch: https://git.openjdk.org/panama-foreign/pull/914.diff
  Fetch: git fetch https://git.openjdk.org/panama-foreign.git pull/914/head:pull/914

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


More information about the panama-dev mailing list