CharBuffer.put is listed as an optional operation, suggesting that programmers
should not depend on it working in portable code. In fact, it is only optional
because you can't use it unless you know you have a writable buffer. That
should be documented more clearly so programmers can use it in portable code.

The same comment applies to many other methods in java.nio