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