RFR: 8335122: Reorganize internal low-level support for HTML in jdk.javadoc [v4]
Jonathan Gibbons
jjg at openjdk.org
Tue Jul 30 18:16:46 UTC 2024
On Tue, 30 Jul 2024 18:02:32 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:
>> I'll look to upgrade these. In the original impl of DocLint, it was something of a conscious decision to avoid supporting input elements.
>>
>> I'm surprised LINK is phrasing content: I thought it could only appear in HEAD elements. I will check.
>>
>> Generally, moving towards HTML 5 names is a good goal, but some of that could/should be part of a DocLint cleanup. This is primarily just a merge, not an upgrade. And, while DocLint is intended to be helpful, it is specifically for doc comments and their likely content, and not a full conformance checker.
>
> I see LINK can be phrasing content under certain conditions.
> I'll adjust the enum accordingly, but I do not think it worth updating DocLint at this time to do any additional checking.
> I'm not sure whether marking it as INLINE content will break DocLint tests.
tools/doclint/html/OtherTagsTest.java needs to be updated
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/19916#discussion_r1697383203
More information about the compiler-dev
mailing list