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.

Thomas

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

Reply via email to