Here is a simple test class to demonstrate the problem:
/**
* A valid, handwritten class comment
*/
// @see thie comment will cause Jalopy to replace the
one above
public class JalopyTest{
}
When Jalopy is run with comment generation turned on,
the comments will be replaced, resulting in this:
/**
* DOCUMENT ME!
*
* @version $Revision: 1.1 $
* @author $author$
*/
public class JalopyTest {
}
It's the line beginning with "// @see" that causes the
problem. Remove that & the handwritten comment will be
left alone.
I found this after running Jalopy on an EJB that had
XDoclet tags in it. I wanted to temporarily remove an
XDoclet tag so I moved it into a // comment. XDoclet &
javadoc both correctly ignored it after that.
-Steve
Logged In: YES
user_id=44430
Fix will appear with the next release (Working CVS repository
should be online in a week or so).
Thanks.
Logged In: YES
user_id=495393
Please note, that a JavaDoc comment must immediately precede
the class that it describes. Blank lines (and // comments)
between the class declaration and the JavaDoc comment are
not allowed. This also applies to methods and variables of
course.
Odi