Emmanuel Lecharny ha scritto:
이희승 (Trustin Lee) wrote:
On Fri, 23 May 2008 12:21:43 +0900, Emmanuel Lecharny
Sometime, you just have to use vi or emacs. Make it simple for users
: add a @see tag. Cost almost nothing, and it helps.
I wouldn't bother with vi or emacs. They pay for what they use.
Moreover, it's not 'almost nothing'.
-1.
Please revert the commit.
Thanks.
Emmanuel, are you vetoing the commit because an inherited class (having
full javadocs for the superclass) does not have method comments?
Isn't this a bit hard at this point of the discussion?
FWIW (I'm not committer to mina, but only a developer) I agree with Trustin.
If a @see is useful then the javadoc tools should automatically add the
see to every implementation method having no javadoc. This is about
javadoc tools, not documentation. The documentation is already in the
java source keywords "extends" and "implements".
Stefano