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

[Maurizio Cimadamore]

> 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

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

Changes:
  - all: https://git.openjdk.org/jextract/pull/193/files
  - new: https://git.openjdk.org/jextract/pull/193/files/f3d3fada..c4235674

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jextract&pr=193&range=01
 - incr: https://webrevs.openjdk.org/?repo=jextract&pr=193&range=00-01

  Stats: 3 lines in 2 files changed: 0 ins; 0 del; 3 mod
  Patch: https://git.openjdk.org/jextract/pull/193.diff
  Fetch: git fetch https://git.openjdk.org/jextract.git pull/193/head:pull/193

PR: https://git.openjdk.org/jextract/pull/193