On Tue, 27 Apr 2021 19:00:10 GMT, Hannes Wallnöfer <hann...@openjdk.org> wrote:
> > Hi Hannes, out of curiosity - for a final class, will all members (or none) > > appear final in the generated documentation? Or will it depend on whether a > > redundant `final` keyword appears in the code or not? From your code > > changes, I guess it will be the latter - which makes me wonder whether we > > want to go that far in the API documentation. Maybe `final` should be > > omitted for members of a final class. > > Yes, `final` will appear as it is used in the source code for method > summaries of final classes. In my mind this is acceptable, analogous to both > ways being allowed in the source code. This seems surprising and maybe questionable, since in other places, javadoc tries to present a normalized view of modifiers. But, I agree it is in line with existing behavior, and this issue is not about changing that behavior at this time. ------------- PR: https://git.openjdk.java.net/jdk/pull/3716
