Public API for programmatic registration of Taglet?

Martin Desruisseaux martin.desruisseaux at geomatys.com
Wed Apr 18 22:24:49 UTC 2018


This is fine, thanks for investigating. Would the following
implementation adjustment be also acceptable?

  * If the Doclet and the Taglet are defined in the same JAR file, then
    they share the same URLClassLoader.

I'm not 100% sure that this is the right thing to do. But it would be
helpful (while not indispensable) in the case that I described (doclet
and taglet sharing common custom data structures).

    Martin


Le 18/04/2018 à 20:39, Jonathan Gibbons a écrit :

> OK, we can't easily accept arbitrary subtypes of DocletEnvironment,
> without embarking on a bunch of changes to other public API.
>
> This means the correct solution here is that Taglet.init should be
> called with the "user doclet" (which we expect people to provide
> subtypes of) and the system-provided DocletEnvironment (which we do
> not expect people to subtype.)
>
> The spec change here (for the @param doclet) is not a material change;
> it is a clarification of the original intent. We just need to think of
> the best words to describe the usage without getting into the internal
> details of StandardDoclet delegating to HtmlDoclet.
>
> -- Jon 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20180419/d8be4d1d/attachment.html>


More information about the javadoc-dev mailing list