RFR: JDK-8258602: JavaDoc field summary does not indicate final modifier [v2]

[Hannes Wallnöfer]

On Fri, 30 Apr 2021 03:28:20 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> OK, but we might want to think about the pros and cons of normalizing modifiers.

Thanks for the review; I agree we should think about normalizing modifiers. 

FWIW, the JLS describes methods in final classes as merely "behaving as if they were final" (8.4.3.3.), so at least technically it is still the modifier that decides. Other constructs are actually declared as implicitly final, with some of them allowing the modifier (such as constants in interfaces) and some not (enums). Here I think we usually show modifiers if they are allowed, although I haven't done a systematic review.

-------------

PR: https://git.openjdk.java.net/jdk/pull/3716