Unable to see Java 5 features from Doclet API

Question

The Doclet API was extended in Java 5 for getting information in generics, but I have been unable to get it to work. For example, calling ClassDoc.typeParameters and typeParamTags always returns an empty array.
* @param <X> The X
public class Test<X> {
}And the Doclet is:
import com.sun.javadoc.*;
public class TestDoc extends Doclet {
    public static boolean start(RootDoc root) {
        for (ClassDoc cd : root.classes()) {
            System.out.println();
            System.out.println(cd);
            TypeVariable[] tv = cd.typeParameters();
         if (tv.length == 0) {
          System.out.println("No type parameters");
         } else {
          for (TypeVariable t : tv) {
              System.out.println("tv: " + t);
         ParamTag[] pt = cd.typeParamTags();
         if (pt.length == 0) {
          System.out.println("No type parameter tags");
         } else {
          for (ParamTag t : pt) {
              System.out.println("pt: " + t);
        return true;
}For the Test class, it always prints out:
No type parameters
No type parameter tagsI'm running version 1.5.0_05. Is there some magic flag that needs to get passed? I have been unable to see any evidence that the new Java 5 API does anything at all.

Answer 1

Implementing
     public static LanguageVersion languageVersion() {
          return LanguageVersion.JAVA_1_5;
in my extension doclet solved the problem. Is part of the transition documentation from javadoc 1.2 to javadoc 1.5, but can not easily be found, not even a useful hint link.