[dahvyd]

Consider the standard Java cough paradigm used by multitudes of developers, and on by default in many Java IDEs:

    /* Gets the person's name
       @returns the person's name */
    public String getName() {
       return name;
    }

That is insane. The comment adds nothing to anyone's day and helps no one better understand the method than after simply reading the method signature.

[flatline3]

It generates auto-docs, which are useful. It's just a ridiculously verbose way to do it, and it would be preferable if the documentation could be generated without the repetitive comment.