Simple Getter/Setter comments
Absolutely pointless - you're better off without this kind of crap cluttering your code:
/**
* Sets the foo.
*
* @param foo the foo to set
*/
public void setFoo(float foo);
Very useful, if warranted:
/**
* Foo is the adjustment factor used in the Bar-calculation. It has a default
* value depending on the Baz type, but can be adjusted on a per-case base.
*
* @param foo must be greater than 0 and not greater than MAX_FOO.
*/
public void setFoo(float foo);
Especially the explanation of what the property actually means can be crucial in domain models. Whenever I see a bean full of properties with obscure names that only investment bankers, biochemists or quantum physicists understand, and the comments explain that the setGobbledygook() method "sets the gobbledygook.", I want to strangle someone.
I usually just fill the param part for setters, and the @return part for getters:
/**
*
* @param salary salary to set (in cents)
*/
public void setSalary(float salary);
/**
* @return current salary (in cents, may be imaginary for weird employees)
*/
public float getSalary();
That way javadoc checking tools (such as Eclipse's warnings) will come out clean, and there's no duplication.