.Tested in JDK1.2Beta4-E.

Run javadoc command with custom doclets using option -doclet, error exit status from doclets is not reflected by javadoc:

$ javadoc -doclet Test Test.java
Loading source file Test.java...
Constructing Javadoc information...

$ echo $?
0

$ more Test.java
import com.sun.javadoc.*;

public class Test extends Doclet {
  
  public static boolean start(RootDoc root) {
    return false;
  }
}
$ 

Use printError() this will increment the error count and cause a 
non-zero exit status.
 xxxxx@xxxxx  1998-05-08

Okay.
 xxxxx@xxxxx  1998-05-14

Check with Robert on how to properly implement this before actually doing it.
 xxxxx@xxxxx  1998-05-18

In Main.main, the return value from the doclet is ignored. 
	// pass off control to the doclet
	docletInvoker.start(root);
I think what should happen is, if nerrors is 0, that is if the doclet 
did not call printError to generate their own error, one should be 
printed for them - "Doclet failed".  Then, when Main.exit is called
the exit status will be correct.
 xxxxx@xxxxx  1999-06-24

No diagnostic is required - the doclet can print its own error messages.
I have fixed javadoc to use the exit status of the doclet.

 xxxxx@xxxxx  2001-02-26