RFR: JDK-8309566: Migrate away from TagletWriter and TagletWriterImpl

Jonathan Gibbons jjg at openjdk.org
Mon Jul 10 21:03:11 UTC 2023


On Mon, 10 Jul 2023 16:00:21 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/LinkTaglet.java line 38:
>> 
>>> 36: import jdk.javadoc.internal.doclets.toolkit.Content;
>>> 37: 
>>> 38: public abstract class LinkTaglet extends BaseTaglet {
>> 
>> `{@link}` has finally got its own taglet. However, I note that `{@code}` has lost its taglet.
>> 
>> In the markup sense, `{@link}` is to `{@code}` as `{@linkplain}` is to `{@literal}`. If you agree with this, then I think we should leave `{@code}`, rather than `{@literal}`.
>
> I agree, but may do that separately, or as part of subsequent cleanup

I may leave the types as-is but try and fix it in the doc comments.   The problem is in the class names and the crossed-over functionality.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14793#discussion_r1258909667


More information about the javadoc-dev mailing list