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

[Maurizio Cimadamore]

On Thu, 1 Jun 2023 19:58:49 GMT, Jorn Vernee <jvernee at openjdk.org> wrote:

>> Maurizio Cimadamore has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Fix wrong link in layout well-formedness doc
>
> src/java.base/share/classes/java/lang/foreign/ValueLayout.java line 71:
> 
>> 69:      *
>> 70:      * @param order the desired byte order.
>> 71:      * @return a value layout with the same characteristics as this layout, but with the given byte order.
> 
> Also seems like a candidate for `{@return ...}`

Possibly. The text is consistent in using different wording between the header and return (as I did a pass in that sense), but perhaps that's a bug.

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

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