From: Egon W. <e.w...@sc...> - 2005-06-24 07:27:54
|
Hi all, I just spend 30 minutes cleaning up bad JavaDoc, which is still autogenerated by some IDE's !!!! Just to be able to see wether JavaDoc two bugs are still present! I've must have asked several times now, and this is the last time I will do it. Please do not use your IDE to create these bloody JavaDoc fragments: - @created - and JavaDoc descriptions like: Documentation of this class/method etc... Again: @created is NOT a valid JavaDoc tag; and those autogenerated descriptorns completely mess up quality control ! Next time I will have to do this I'll seriously explore setting up a commit block for commits having these characteristics, instead of having to manually clean up this issues and having to write once more to the mailing list. I know documentation is of lowest priority to most, but please do not make it more difficult to those who do care at least a bit... Thanx Egon PS. If I sound a bit pissed off, I am... partly caused by the bloody hot room I'm working in :( |