RFR: JDK-8189591: No way to locally suppress doclint warnings [v2]

[Jonathan Gibbons]

> Please review a moderately simple change, to have DocLint check for relevant `@SuppressWarnings` annotations before reporting any messages.

Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:

  Address review comments

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/5870/files
  - new: https://git.openjdk.java.net/jdk/pull/5870/files/6938a7ac..6e736b69

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

  Stats: 35 lines in 2 files changed: 9 ins; 3 del; 23 mod
  Patch: https://git.openjdk.java.net/jdk/pull/5870.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/5870/head:pull/5870

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