New guide --include-dir clarifications

[Sundararajan Athijegannathan]

Or should we just say that this is equivalent Clang compiler's -I option rather than repeating the specification in the jextract doc(s)/help?

BTW, even Clang's command line reference does not seem to specify/commit to the precise behavior seen/you mentioned...

https://clang.llvm.org/docs/ClangCommandLineReference.html

-Sundar
________________________________
From: jextract-dev <jextract-dev-retn at openjdk.org> on behalf of Nir Lisker <nlisker at gmail.com>
Sent: 17 April 2024 09:51
To: jextract-dev at openjdk.org <jextract-dev at openjdk.org>
Subject: New guide --include-dir clarifications

Hi,

A couple of points regarding --include-dir in the guide that I think are worth mentioning:
1. The directories are searched in order, so if the same header is found in more than one included dirs, only the first one is taken. (I think this is correct.)
2. The directories are *not* searched recursively. Nested directories need to be added one by one if required.

If you agree that these should be added, I don't mind making a pull request. I think it's best to add this info in the "Running jextract" section.

- Nir
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/jextract-dev/attachments/20240417/6ee13e6e/attachment.htm>