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

[Maurizio Cimadamore]

On Fri, 24 Feb 2023 16:42:02 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.

I've addressed the comments and also fixed some other issues:
* minor typos
* double whitespaces
* missing `java` in some code blocks

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

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