United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4099527 : javadoc tool: want flag to exit nonzero if there were warnings.

Details
Type:
Enhancement
Submit Date:
1997-12-15
Status:
Resolved
Updated Date:
2002-10-26
Project Name:
JDK
Resolved Date:
2002-10-26
Component:
tools
OS:
generic
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P5
Resolution:
Fixed
Affected Versions:
1.1.5
Fixed Versions:
1.4.2 (mantis)

Related Reports

Sub Tasks

Description
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.

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
mantis

FIXED IN:
mantis

INTEGRATED IN:
mantis
mantis-b05


                                     
2004-06-14
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.
                                     
2004-06-10
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
                                     
2000-02-10



Hardware and Software, Engineered to Work Together