[foreign-jextract] RFR: Update memory access and linker documents

[Maurizio Cimadamore]

On Thu, 25 Mar 2021 12:36:00 GMT, Jorn Vernee <jvernee at openjdk.org> wrote:

>> This patch updates the two documents describing usage of the foreign memory access and foreign linker API.
>
> doc/panama_ffi.md line 135:
> 
>> 133:     MemorySegment upcallStub(MethodHandle target, FunctionDescriptor function, ResourceScope scope);
>> 134:     MemorySegment upcallStub(MethodHandle target, FunctionDescriptor function);
>> 135:     ...
> 
> We also now have the downcallHandle overload that takes a SegmentAllocator

yeah - since the examples never mention it, I didn't want to dive too much into that. I think I will simplify this further and just keep two methods (but then say that there are other overloads available).

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

PR: https://git.openjdk.java.net/panama-foreign/pull/475