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

[Maurizio Cimadamore]

> 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

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

Changes:
  - all: https://git.openjdk.org/panama-foreign/pull/805/files
  - new: https://git.openjdk.org/panama-foreign/pull/805/files/ca71bcd1..8f1ecded

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=panama-foreign&pr=805&range=01
 - incr: https://webrevs.openjdk.org/?repo=panama-foreign&pr=805&range=00-01

  Stats: 22 lines in 2 files changed: 2 ins; 0 del; 20 mod
  Patch: https://git.openjdk.org/panama-foreign/pull/805.diff
  Fetch: git fetch https://git.openjdk.org/panama-foreign pull/805/head:pull/805

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