#23 JavaStyle javadoc comment error

[Anonymous]

JavaStyle can erroneously insert parameters into a
JavaDoc description when you comment out the method
underneath the comment. This is because it goes and
searches down for the next available uncommented out
method and uses that method to update the javadoc.

Example. If you have this code snippet:

/**
* Constructor for the AdapterInfo object
*
*/
public AdapterInfo() { }

/**
* Construct an instance of this class with
the given field values.
*
* @param protocolName The name of the
protocol the adapter supports (i.e., FTP).
* @param adapter A reference to the
adapter itself (i.e., this).
* @param isServer True if the adapter
is a server adapter, false if not.
* @param processId Description of the
Parameter
*/
public AdapterInfo(
String protocolName,
AdapterActionListener adapter,
boolean isServer,
int processId)

and then you comment out the constructor at the top,
it changes the JavaDoc of the commented out
constructor as follows:

/**
* Constructor for the AdapterInfo object
*
* @param protocolName Description of the
Parameter
* @param adapter Description of the
Parameter
* @param isServer Description of the
Parameter
* @param processId Description of the
Parameter
*/
//public AdapterInfo() { }

If you then uncomment out the constructor, it removes
the non-existent parameters, restoring the javadoc to
its original state. However, it would be nicer if it
never inserted the non-existent parameter information
in the first place.

[Mike Atkinson]

Logged In: YES
user_id=476481

Fixed in Version 2.7.01 of JRefactory.