On Wed, 9 Apr 2025 17:55:26 GMT, Roger Riggs <rri...@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
