How to filter HTML javadoc output ?

Question

Hi all,
I would like to create a specific HTML javadoc output for a given source code tree.
Each class or method to be displayed is tagged with a specific (proprietary) tag, and I would like to create a Javadoc HTML tree with ONLY these classes and methods. The other ones should not be available in the HTML output.
Is is possible simply ? or do I have to modify the original Javadoc sources, as I saw in many replies, and use directly this modified "standard" doclet ?
Last question, but not so simple : i would like my doclet to be compiled under both JDK 1.4 and 1.5.
Do I have to modify both original sources and create 2 different "tools.jar" files, one for each JDK ?
thanx in advance for any tips !
brgds,
Philippe

Answer 1

Yes, if your code depends on the standard doclet code, and not just the
Doclet API, some of it would need to be rewritten between 1.4 and 1.5.
The standard doclet was refactored to create a "toolkit" -- much of the code
was moved around in order for this toolkit to be used by the MIF doclet.
Javadoc 1.5 contains the following check in AbstractDoclet.java that
prevents any doclet other than the standard HTML doclet from running.
This check was added because the toolkit has not been developed
enough, and the Java team did not want the toolkit API to be available
yet.
private static final String TOOLKIT_DOCLET_NAME = new   
    com.sun.tools.doclets.formats.html.HtmlDoclet().getClass().getName();
private boolean isValidDoclet(AbstractDoclet doclet) {
    if (! doclet.getClass().getName().equals(TOOLKIT_DOCLET_NAME)) {
        configuration.message.error("doclet.Toolkit_Usage_Violation",
            TOOLKIT_DOCLET_NAME);
        return false;
    return true;
}So you could modify this source file to accept your doclet and compile and
replace it with the one in tools.jar
Alternatively, you could run your doclet using "java" rather than "javadoc",
placing the 1.4 tools.jar file ahead of (or instead of) the 1.5 tools. jar file in
the classpath. I do something like this:
$ java -classpath "1.4tools.jar:1.5tools.jar" com.sun.tools.javadoc.Main <doclet_options>Please let us know if this works.
-Doug