> Like e.g. in Java it was common to have a comment on a simple (!) setter, telling you "this sets X" This has never been common in any sensible environment. O

> Like e.g. in Java it was common to have a comment on a simple (!) setter, telling you "this sets X" This has never been common in any sensible environment. Only on projects with project leads who had zero clue about anything, and with silly catch-all rules such as "EVERY METHOD MUST BE DOCUMENTED!". This predictably leads to shitty documentation. /** * Sets foo to <code>foo</code> * @param foo new foo value */ public void setFoo(int foo) { this.foo = foo; } No one sensible does this. Some IDEs might auto generate this garbage. In which case that should be disabled.