Xavier Hanin wrote:
Mmm, I'm not a big fan of doing things manually. Ivy has about 270
classes,
I don't know the number of attributes, but I think we should better spend
time on adding javadoc than renaming the fields. So for the moment I
suggest
we keep this code convention (which seems to be pretty well accepted
among
committers).
If you manage to add meaningful javadoc, which is much more time
consuming than a manual operation, the time spent to do a combination
key remove the _ and type enter is probably a 100:1 ratio at best. This
is why it is worth spending a couple extra minutes documenting code when
writing it rather than doing it afterwards because it's never done as
the task seems so big. :)
A feature that I like about Idea is that it also shows me out of sync
javadoc. It does not have any intelligence on the comment of course, but
@param matching is enough to detect all the autogenerated code that is
often generated by Eclipse and rendered obsolete by a param change. I
don't know if there is any way to have this sort of warning in Eclipse,
but that's really really useful and force you to pay more attention to
the comments. Us, humans, being pretty sloppy, a little subliminal
reminder like 'I'm not sure you really finished your job' is appreciated
and a saver.
-- stephane
