JDK-4099527 : javadoc tool: want flag to exit nonzero if there were warnings.
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.1.5
  • Priority: P5
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 1997-12-15
  • Updated: 2002-10-26
  • Resolved: 2002-10-26
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
1.4.2 mantisFixed
Javadoc should exit with a non-zero code if any warning/error messages are 
generated about doc comments defining but not documenting exceptions etc.
This would make it easier to know about such problems in driver programs
like "make", and hence make such javadoc errors be taken more seriously.

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b05

PUBLIC COMMENTS The new javadoc flag -Xwerror causes javadoc to exit with a nonzero status if there were any warnings displayed during the javadoc run. Without this option, only errors cause a nonzero exit.

EVALUATION This would cause make to abort - this is too severe. robert.field@Eng 1998-01-20 Changed from RFE to a bug. doug.kramer@Eng 1998-04-03 javadoc does exit with exit status of one if there are any errors. This request is to add the option of setting the exit status for warnings. This would be fairly easy to do but should not be the default behavior, and is definitely an RFE. Changed back to an RFE. robert.field@Eng 2000-02-10 A reasonable request. neal.gafter@Eng 2001-03-06 The flag -Xwerror will be available in some future version. ###@###.### 2002-10-24