RFR: 7903639: Add javadoc to all jextract generated API points [v2]

[Jorn Vernee]

On Tue, 23 Jan 2024 19:09:04 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> This PR adds simple javadoc text to all the helper functions generated by jextract:
>> * struct allocation methods
>> * struct slicing methods
>> * struct reinterpret methods
>> * function pointer allocation method
>> * function pointer invoke method
>> 
>> Following some offline discussions, I've decided to keep the comments very dry and simple (to avoid copying reams and reams of text into multiple classes). Also, the javadoc does not contain any `@param` or `@return` tag.
>
> Maurizio Cimadamore has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Address review comments

Marked as reviewed by jvernee (Committer).

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

PR Review: https://git.openjdk.org/jextract/pull/193#pullrequestreview-1840141878