On Fri, Feb 10, 2012 at 11:08:12AM +0100, Thomas Neidhart wrote:
> On 02/10/2012 10:58 AM, Sébastien Brisard wrote:
> > Here is a recent thread on this issue (as you can see, this thread was
> > caused by a faulty commit from me...).
> > Best regards,
> > Sébastien
> > 
> > http://mail-archives.apache.org/mod_mbox/commons-dev/201201.mbox/%3C20120113105913.GM6537%40dusk.harfang.homelinux.org%3E
> 
> Thanks,
> 
> the point is, if you want to be able to document all exceptions in the
> javadoc that _can_ be thrown by a method, it is a very tedious process
> if you only advertise them in javadoc.
> 
> The solution from Luc to temporarily change the base exceptions to
> checked ones helps with this (and I usually do it that way), as you see
> immediately which exceptions you have missed.
> 
> Otherwise you have to dig into the code and follow all invoked method
> calls, which can be quite some work and is also error-prone as they
> might change as well, leading to an unmaintainable bunch of exceptions
> in javadoc.

You have to do that only if the doc is wrong or incomplete or there is no
unit test for testing all the preconditions.
Avoiding these is the rule we all agree to try and follow.


Best,
Gilles

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org

Reply via email to