[External] : Re: Javadoc for API

[Jorn Vernee]

 > There is no need for a dump.

But, do you think you could do the things you're doing, using 
JextractTool::parse, by using --dump-includes instead?

I'm trying to assess if we even need the API at all, or if we can just 
have the ToolProvider.

Jorn

On 28-1-2025 15:12, Nir Lisker wrote:
> I use
> JextractTool.parse(List<String> arg0, String... arg1)
> to inspect given header files. Then I use
> ToolProvider.run(PrintStream out, PrintStream err, String... args)
> which is not Jextract-specific to run the tool with the user's 
> configuration. There is no need for a dump.
>
> I want to release an alpha soon so you'll be able to see how it works.
>
> On Tue, Jan 28, 2025 at 2:28 PM Jorn Vernee <jorn.vernee at oracle.com> 
> wrote:
>
>     Hey Nir,
>
>     The jextract API has been neglected for a while (as you've found).
>     Initially it was a way of avoiding adding many flags to jextract,
>     to do
>     things like filtering, renaming, and other things. The idea being
>     that
>     if users wanted more control of what jextract did, they could use the
>     API. But, now it seems like we're moving in that direction any
>     way, with
>     the JSON based configuration:
>     https://bugs.openjdk.org/browse/CODETOOLS-7903788
>
>     I think we need to re-asses which use cases the jextract API
>     addresses,
>     and whether using jextract through the ToolProvider interface,
>     with the
>     extended configuration options, is also an option.
>
>     IIRC your use case is filtering the jextract output, right? Do you
>     think
>     it would be possible to use the ToolProvider interface with a
>     combination of --dump-includes, and automatically generated
>     --include-XXX flags, to achieve the same level of functionality?
>
>     Jorn
>
>     On 26-1-2025 08:51, Nir Lisker wrote:
>     > Hi,
>     >
>     > There are several public methods the JextractTool exposes. Please
>     > javadoc to these methods so tool users will know what they do
>     and how
>     > to use them.
>     >
>     > Thanks,
>     > - Nir
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/jextract-dev/attachments/20250128/2a2f76a8/attachment.htm>