Summary
-------

Add `@throws NonWritableChannelException` to the `tryLock()` and `write()` methods of `java.nio.channels.FileChannel`.

Problem
-------

If a `tryLock()` or `write()` method is invoked on a `java.nio.channels.FileChannel` which has been opened with read-only access, then a `java.nio.channels.NonWritableChannelException` is thrown but the documentation does not indicate this.

Solution
--------

Add `@throws NonWritableChannelException` to the indicated methods.

Specification
-------------
Note that for `tryLock(long,long,boolean)`, the `boolean` parameter `shared` is referred to. The other `@throws` are all the same and do not mention any parameter.

    @@ -403,6 +406,9 @@ public abstract class FileChannel
          * with the number of bytes actually written.  Otherwise this method
          * behaves exactly as specified by the {@link WritableByteChannel}
          * interface. </p>
    +     *
    +     * @throws  NonWritableChannelException
    +     *          If this channel was not opened for writing
          */
         public abstract int write(ByteBuffer src) throws IOException;
     
    @@ -417,6 +423,9 @@ public abstract class FileChannel
          * with the number of bytes actually written.  Otherwise this method
          * behaves exactly as specified in the {@link GatheringByteChannel}
          * interface.  </p>
    +     *
    +     * @throws  NonWritableChannelException
    +     *          If this channel was not opened for writing
          */
         public abstract long write(ByteBuffer[] srcs, int offset, int length)
             throws IOException;
    @@ -431,6 +440,9 @@ public abstract class FileChannel
          * with the number of bytes actually written.  Otherwise this method
          * behaves exactly as specified in the {@link GatheringByteChannel}
          * interface.  </p>
    +     *
    +     * @throws  NonWritableChannelException
    +     *          If this channel was not opened for writing
          */
         public final long write(ByteBuffer[] srcs) throws IOException {
             return write(srcs, 0, srcs.length);
    @@ -1030,7 +1042,7 @@ public abstract class FileChannel
          *          region
          *
          * @throws  NonReadableChannelException
    -     *          If {@code shared} is {@code true} this channel was not
    +     *          If {@code shared} is {@code true} but this channel was not
          *          opened for reading
          *
          * @throws  NonWritableChannelException
    @@ -1148,6 +1160,14 @@ public abstract class FileChannel
          *          blocked in this method and is attempting to lock an overlapping
          *          region of the same file
          *
    +     * @throws  NonReadableChannelException
    +     *          If {@code shared} is {@code true} but this channel was not
    +     *          opened for reading
    +     *
    +     * @throws  NonWritableChannelException
    +     *          If {@code shared} is {@code false} but this channel was not
    +     *          opened for writing
    +     *
          * @throws  IOException
          *          If some other I/O error occurs
          *
    @@ -1180,6 +1200,9 @@ public abstract class FileChannel
          *          blocked in this method and is attempting to lock an overlapping
          *          region
          *
    +     * @throws  NonWritableChannelException
    +     *          If this channel was not opened for writing
    +     *
          * @throws  IOException
          *          If some other I/O error occurs
          *