Currently {@value} can only be used in the doc comment of its own field,
to display the value. It would be useful to be able to use it anywhere.
I am looking for a way to customize a series of Javadoc comments. Example:
/**
* Names the property file.
*/
public static final String NAME_OF_PROPERTY_FILE = "db2.properties";
/**
* This method reads the properties out of {@value NAME_OF_PROPERTY_FILE}
*/
public void readProperties() {
...
}
/**
* This method writes the properties into {@value NAME_OF_PROPERTY_FILE}
*/
public void writeProperties() {
...
}
So if I need to change the value of the constant to
"cloudscape.properties" I wouldn't have to redo all the Javadoc
comments. (I came to this while doing a lot of Search/Replace)!