RFR: Add jextract guide [v5]

[Nir Lisker]

On Wed, 10 Apr 2024 14:34:25 GMT, Jorn Vernee <jvernee at openjdk.org> wrote:

>> Add a comprehensive jextract guide under a new `doc/` folder.
>> 
>> This is meant as a comprehensive guide about the features of jextract and the code that it generates (including both examples from header files, the code that jextract generates, and corresponding Java user code). This is a first cut, and I'm anticipating quite a bit of comments.
>> 
>> Some sections of the readme have been moved to the guide (with minor edits here and there), and replaced by a link in the readme.
>
> Jorn Vernee has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Phrasing
>   
>   Co-authored-by: Maurizio Cimadamore <54672762+mcimadamore at users.noreply.github.com>

doc/GUIDE.md line 757:

> 755: 
> 756: To enable the tracing support, just pass the `-Djextract.trace.downcalls=true` flag to the
> 757: launcher used to start the application. Below we show an excerpt of the output when

I would mention that this is passed as a VM argument, not as a program argument.

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

PR Review Comment: https://git.openjdk.org/jextract/pull/231#discussion_r1564920967