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

[Hannes Wallnöfer]

> I found that adding the `final` modifier does not add too much visual noise to the documentation. I didn't find any occurrence where there were more than two modifiers on a member summary (usually either `static final` or `protected final`). 
> 
> On the other hand, I do think the `final` modifier adds important information about the member. Although this is more true for fields than for other members, for reasons of consistency I decided to show it for all kinds of members except for those where it is not allowed (such as for enums).
> 
> To my surprise I also noticed that there weren't any test cases for field summaries, so I added a new test.

Hannes Wallnöfer has refreshed the contents of this pull request, and previous commits have been removed. The incremental views will show differences compared to the previous content of the PR. The pull request contains one new commit since the last revision:

  JDK-8258602: JavaDoc field summary does not indicate final modifier

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/3716/files
  - new: https://git.openjdk.java.net/jdk/pull/3716/files/074b7326..a6a9d202

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=3716&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=3716&range=00-01

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk/pull/3716.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/3716/head:pull/3716

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