RFR: 8308645: Javadoc of FFM API needs to be refreshed [v4]

[Maurizio Cimadamore]

On Thu, 1 Jun 2023 21:04:27 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> src/java.base/share/classes/java/lang/foreign/Linker.java line 473:
>> 
>>> 471: 
>>> 472:     /**
>>> 473:      * Creates a method handle which is used to call a foreign function with the given signature and symbol.
>> 
>> I always think of a function "symbol" mostly as the _name_ of the function, so it seems that "address" would be more correct here. Though, I might be wrong on that. It's hard to find a clear definition of "symbol" that applies to this specific use case.
>
> the idea behind this is to connect with the javadoc of `SymbolLookup` which defines and then uses symbol all over the place.

Maybe a linkplan could help?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14098#discussion_r1213679476