Supressing XDoclet tags in Javadoc (from Ant)

An article by Glen    1 Comment

If your project uses XDoclet and you’re sick of seeing those warnings like:

warning - @web.servlet is an unknown tag.

then what you’re after is the new Ant 1.6
<tag> element of the <javadoc> task. You can use this bad boy by embedding something like:

   <tag name="web.servlet" scope="all" enabled="false"/>

in your source. Be warned, though, if you’re trying to ignore a hyphen separated tag, (say web.servlet-mapping), you’re out of luck. It will interpret it without the hyphen. This is apparently a known bug with javadoc on JDK 1.4.

I’m thinking that this tag is just a wrapper of the -tag commandline arg (more info) of the javadoc executable, and that javadoc.exe internally has issues with parsing it’s own commandline. Those pesky embedded hyphens…