Whooo, Javadoc

[afuna]

The one thing I love about JavaDoc is that it starts with two stars. Makes it look special (and, in Eclipse, blue).

The things I don't like about JavaDoc are too many to count! But the list includes annotations! Why are you letting comments define behavior? That's just freaky.

On the flip side, documentation is a good warm up to the day, so!

Comments

Re: Annotations

[afuna]

Oh true. I don't mind them as much when they're in that format, oddly. It's when they're in a comment, that they're annoying

(I was only editing a comment, so I didn't think to rebuild/retest the project before committing a patch. Turns out I'd deleted one line in the comment which actually had an effect on the code.

ARGH)

And +1 to autogenerate accessor methods. Objective-C and Ruby have spoiled me in that regard.