@sealedGraph showing exhaustiveness of hierarchy

Per-Ake Minborg per-ake.minborg at oracle.com
Mon Oct 23 07:14:12 UTC 2023


I think that would be a good improvement.

Note that non-sealed classes are indicated as <any> as in https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/invoke/CallSite.html
CallSite (Java SE 21 & JDK 21)<https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/invoke/CallSite.html>
declaration: module: java.base, package: java.lang.invoke, class: CallSite
docs.oracle.com
/Per
________________________________
From: liangchenblue at gmail.com <liangchenblue at gmail.com>
Sent: Friday, October 20, 2023 7:15 PM
To: javadoc-dev at openjdk.org <javadoc-dev at openjdk.org>; Per Minborg <pminborg at openjdk.org>
Subject: @sealedGraph showing exhaustiveness of hierarchy

Hello Per-Ake and developers,
The @sealedGraph javadoc taglet that renders sealed classes hierarchy currently does not indicate the exhaustiveness of a hierarchy; for example, MethodHandleDesc may have non-DirectMethodHandleDesc implementations while StringTemplate.Processor.Linkage only has FormatProcessor implementations.

Currently, javadoc distinguishes by adding a "(not exhaustive)" note after the permits list. Should @sealedGraph find a similar way to indicate non-exhaustiveness?

Chen Liang
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20231023/3d836e73/attachment-0001.htm>


More information about the javadoc-dev mailing list