FileChannel doc

[Jeff Hain]

>1. Typo in the @throws NonReadableChannelException as "but" is missing.


I didn't catch it, you did :)

>2. tryLock methods don't specify
    NonReadableChannelException/NonWritableChannelException - yes, this
    is a known issue, see 4510562.

ok

>We don't want to deliberately break anyone.

I was only 25 percents serious. The JDK is not supposed to be a chaos monkey,
but I was thinking that this sort of "clean-up" could be done along with a big release
breaking binary compatibility etc.

>Are you concerned with
    cases where more than one exception is possible?

Yes, the order consideration is for these cases. I know in general exceptions
order is not specified, but having it homogeneous makes it easier to think
about exceptional cases, and also makes mocks/tests easier, with more
factored code and less specific cases.


-Jeff
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.openjdk.java.net/pipermail/nio-dev/attachments/20121002/7c7d862f/attachment.html