RFR: 8346109: Create JDK taglet for additional preview notes
Hannes Wallnöfer
hannesw at openjdk.org
Thu Apr 10 09:29:32 UTC 2025
On Wed, 9 Apr 2025 17:55:26 GMT, Roger Riggs <rriggs at openjdk.org> wrote:
> It would, IMHO, look better if it was a BOLD prefix of the first sentence.
I partly agree, but I also think the stamp-like nature serves a purpose. Note that deprecated members and restricted methods use the same format, sometimes adding a full sentence:
https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/lang/Runtime.html#method-summary
https://docs.oracle.com/en/java/javase/24/docs/api/java.desktop/java/applet/Applet.html#method-summary
So I think it could be improved, but should be part of an effort to improve marking of "special" elements in general.
-------------
PR Comment: https://git.openjdk.org/jdk/pull/23395#issuecomment-2792128552
More information about the build-dev
mailing list