Should I use a “non-Javadoc” comment?

Question

I implemented my own method defined in an interface. However when I try to add Javadoc to this method Eclipse gave me a comment like this:

/* (non-Javadoc)
 * @s         


        

Answer 1

Eclipse gave you something, but you can feel free to change it. Change it into a javadoc comment by adding the second star to make it a /** at the beginning, then write whatever you want just like you do with the other javadoc comments. Eclipse won't get in your way or insist you change things back -- it's just giving you some boilerplate to work with.