HTML Formatting Tags in @param Argument No Longer Work
For java 1.4.0-b92, wrapping the parameter name in HTML, like '<EM>...</EM>' completely ignores the @param command and Javadoc issues no warnings or errors. I also found nothing in any of the writeups, such as the "What's New in Javadoc 1.4" mentioning this behavior. This worked perfectly well under Javadoc 1.3.1_02.
Is this a feature, a bug, or what?
Example:
///////// snip...BEGIN ParamBug.java.....///////////
public class ParamBug
{
/**
* Demonstrates a bug parsing '@param' that worked under Java 1.3.1.
* @param <EM>firstParam</EM> the first parameter of the bug example.
*/
public void paramBugExample (String firstParam)
{
}
}
///////// snip...END ParamBug.java.....///////////
INSTRUCTIONS:
1) place ParamBug.java in some directory and have location of javadoc on PATH.
2) cd <location of ParamBug.java>
3) execute javadoc -breakiterator -d . ParamBug.java
4) Check the ParamBug.html file and notice the missing param!
This bug is reproducable under Win2000 and Win98.
