Description Andrey Loskutov 2005-05-30 13:11:34 EDT

Consider this code:

public class A implements Comparable<String> {
    public int compareTo(String s) {
        return 0;
    }
}

This comment is generated actually by quick fix "Add javadoc comment" for 
compareTo() method:

public class A implements Comparable<String> {

    /* (non-Javadoc)
     * @param s
     * @return
     * @see java.lang.Comparable#compareTo(T)
     */
    public int compareTo(String s) {
        return 0;
    }
}

The "(T)" in java.lang.Comparable#compareTo(T) should be "(Object)", otherwise 
if I change the (non-Javadoc) comment to the javadoc comment, a warning:  
"Javadoc: T cannot be resolved to a type" appear.

See also probably related (not - quick-fix) discussion in the bug 83127.