Sign Up to our social questions and Answers Engine to ask questions, answer people’s questions, and connect with other people.
Login to our social questions & Answers Engine to ask questions answer people’s questions & connect with other people.
Lost your password? Please enter your email address. You will receive a link and will create a new password via email.
Please briefly explain why you feel this question should be reported.
Please briefly explain why you feel this answer should be reported.
Please briefly explain why you feel this user should be reported.
Does /* (non-javadoc) have a meaning, beyond pointing out to the reader of source code that a comment block is intentionally not a Javadoc comment? Lately I’ve seen a lot of code that looks like this:
/*
* (non-javadoc)
*
* This method converts widgets to gizmos
*/
public Foo bar() {
...
Is this an established convention of some kind? If so, what does it mean (beyond the obvious literal meaning) and when is it used?
According to the info I could find, this was to fix a bug in older versions of the JavaDoc tool (or more likely older version of Eclipse’s processing of JavaDoc comments) that would not display the correct documentation for a method that overrides the method of a parent class.
As noted by Konstantin, Eclipse’s override template includes this text.