RFR: 8252980: comment only changes extracted from JDK-8247281

[Daniel D.Daugherty]

This sub-task is tracking comment only changes extracted
from Erik's work on JDK-8247281. This extraction is done
to ease the code review for the JDK-8247281 changes.

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

Commit messages:
 - 8252980: comment only changes extracted from JDK-8247281

Changes: https://git.openjdk.java.net/jdk/pull/98/files
 Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=98&range=00
  Issue: https://bugs.openjdk.java.net/browse/JDK-8252980
  Stats: 10 lines in 2 files changed: 0 ins; 3 del; 7 mod
  Patch: https://git.openjdk.java.net/jdk/pull/98.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/98/head:pull/98

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