JDK-4702454 : tool: -quiet should suppress non-error/warning messages in javadoc tool
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.1
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: other
  • CPU: generic
  • Submitted: 2002-06-14
  • Updated: 2004-02-20
  • Resolved: 2004-02-20
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 Availabitlity Release.

To download the current JDK release, click here.
5.0 b40Fixed
Why am I getting the first two lines when I run javadoc -quiet:

Loading source file Access.java...
Constructing Javadoc information...
.\Client.java:11: '.' expected
import Server;
1 error

-quiet just isn't useful (to me, at least), unless it actually 
prevents *all* non-error/warning messages.  The idea is to be 
totally silent unless there is a problem -
that way, an output scraping script (for instance) can tell if the run
was clean (or not).  Without a functionally quiet behavior, such a
script is required to actually parse the output line-by-line to decide
if it is something a human needs to see.  In my case, we build several
branches of a 1MLOC application on an hourly basis continuously - it is
*really* important that the build results analysis tool not complain
about false positives.  Any such long-term leaks end up with the
developers ignoring the messages and thus missing real problems...

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger-beta2 FIXED IN: tiger-beta2 INTEGRATED IN: tiger-b40 tiger-beta2

EVALUATION Because that is an option to the standard doclet. The standard doclet is not printing those messages, the tool is. Part of the problem is the documentation for the -quiet option, which implies that it would suppress messages from the tool, which it cannot. This is not a bug, though perhaps a reasonable feature request. ###@###.### 2002-06-14 Related bugs are: 4714350 where the documentation incorrectly states that all messages are suppressed (which will be true once this bug is fixed) 4431712 an obsolete proposal to move messages to the -verbose option When neither -verbose nor -quiet are specified, the behavior should be unchanged from its current behavior. When both are specified, I suggest we throw an error and do not continue, with an error message such as: error: cannot continue with both options: -verbose -quiet ###@###.### 2002-07-25