To those who implemented the JavaDoc API: I am unclear on a few things about
how JavaDoc works.
Apparently, the user can specify either packages or classes on the command
line, or even a mixture of the two.
Well, from the RootDoc object you get, you can find out exactly which
packages and classes the user specified, and you can find out the full list
of classes that need to be implemented.
But what I need is the full list of packages that need to be written out.
Can JavaDoc give me that? I didn't see it.
The basic problem:
If the user only specifies he wants class java.lang.Character, then I need
to write out the package-java_lang.html document as well as
class-java_lang_Character.html (or whatever naming convention we use), which
means I need to detect that java.lang is one of the packages to be written
out. It seems like this information should be in the API somewhere, but I
can't find it. I can grab it from the ClassDoc with some convolutions, but
I'd rather not if it is in RootDoc somewhere.
(Oh, that's the other problem. There's no getPackageDoc() in ClassDoc, and
no getRootDoc in PackageDoc.)
I am going to write out an architecture that will allow Doclets to be
written a little easier that allows this sort of thing, but I want to make
sure I'm not reinventing the wheel here.
--John Keiser
