RFR: 8286735: (fc) FileChannel#map should document behavior when using custom file systems

[Brian Burkhalter]

On Wed, 18 May 2022 16:37:18 GMT, Uwe Schindler <uschindler at openjdk.org> wrote:

> If you don't agree that the spec should be changed for the old API spec, let's remove that statement and only fix the new method's documentation.

If we were to add the proposed `@implSpec`, then I don't think the `@throws UnsupportedOperationException` verbiage for `map(MapMode, long, long, MemorySession)` would need to be tweaked as the UOE is always thrown. If that would be acceptable, then perhaps the present issue could be revised and another separate issue created to address the optionality concerns that Alan raised, if that is something which it is desirable to investigate separately.

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

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