...one more thing, the sun.reflect.generics.reflectiveObjects.NotImplementedException's should be replaced by java.lang.UnsupportedOperationException's. My IDE refuse the compilation because the NotImplementedException is not public API (access restriction).
On Sun, Nov 27, 2011 at 10:05 PM, Christian Schwarz < chriss....@googlemail.com> wrote: > On Sat, Nov 26, 2011 at 1:39 AM, Emmanuel Lecharny <elecha...@gmail.com>wrote: > >> Hi guys, >> > > Hi Emmanuel, > > >> Feel free to comment... >> > > ...here we go! Using the 2 MINA IoBuffer is difficult for us because the > documentation of it is too hard to reach. JavaDoc's like "@see # xy > ByteBuffer (..)" only makes sense if the IDE displays the linked API docu > immediately, otherwise it's far from fun. I think the most of us don't like > to lookup the ByteBuffer docu, we want it first hand! We look into the > JavaDoc because we need it, just in this moment. > So what is more expressive: > > /** > * @see Buffer#hasRemaining() > */ > > vs. > > /** > * Tells whether there are any elements between the current position and > the limit. > * > * @returns true if, and only if, there is at least one element remaining > in this buffer > */ > > WDYT? > > Best regards > Christian >