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

[Daniel Fuchs]

On Fri, 30 Apr 2021 09:46:08 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> 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.

I would be concerned that adding (or removing) a redundant `final` keyword could be perceived as a specification change if it's reflected in the API documentation. But I am happy for the normalization issue to be revisited later.

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

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