RFR: 8266631: StandardJavaFileManager: getJavaFileObjects() impl violates the spec [v2]

[Jan Lahoda]

> This improves javadoc/specification of several StandardJavaFileManager methods, as requested in these bugs:
> https://bugs.openjdk.java.net/browse/JDK-8266631
> https://bugs.openjdk.java.net/browse/JDK-8266596
> https://bugs.openjdk.java.net/browse/JDK-8266591
> https://bugs.openjdk.java.net/browse/JDK-8266590
> 
> The CSR is here:
> https://bugs.openjdk.java.net/browse/JDK-8268260

Jan Lahoda has updated the pull request incrementally with one additional commit since the last revision:

  Improving javadoc as suggested on the review.

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/4360/files
  - new: https://git.openjdk.java.net/jdk/pull/4360/files/eeb976f0..3136b328

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

  Stats: 15 lines in 1 file changed: 6 ins; 1 del; 8 mod
  Patch: https://git.openjdk.java.net/jdk/pull/4360.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/4360/head:pull/4360

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