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