RFR: JDK-8246712 doclint incorrectly reports some HTML elements as empty
Pavel Rappo
pavel.rappo at oracle.com
Tue Jun 9 17:52:48 UTC 2020
Jon,
Having in mind my extremely limited experience with jdk.compiler, the code change looks okay. However, the test could be even better: it would be cleaner if the test were built around actual tags rather than tag trees. Otherwise, the proposed test is of "grey-box" kind as it uses the fact that {@code} and {@literal}, {@link} and {@linkplain} are implemented using the same constructs.
Now the question is: where to get an exhaustive, always-up-to-date list of inline tags? (Yes, I read and understood the below comment
* Since there is not yet any mapping between DocTree.Kind and
* the corresponding subtype DocTree (see javac Tree.Kind, Tree)
* the list of all current inline tag classes is determined by
* scanning DocTreeVisitor.)
-Pavel
> On 8 Jun 2020, at 21:29, Jonathan Gibbons <jonathan.gibbons at oracle.com> wrote:
>
> Please review a simple change to ensure that inline tags are taken into account when checking if an HTML element is empty.
>
> As well as testing all existing inline tags, the test also tries to avoid future instances of this problem, by testing all subtypes of InlineTagTree, and ensuring that each have a corresponding test case.
>
> -- Jon
>
> JBS: https://bugs.openjdk.java.net/browse/JDK-8246712
> Webrev: http://cr.openjdk.java.net/~jjg/8246712/webrev.00
>
More information about the javadoc-dev
mailing list