JDK-4431712 : javadoc without '-verbose' flag is still too verbose
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • OS: generic
  • CPU: generic
  • Submitted: 2001-03-29
  • Updated: 2014-05-05
  • Resolved: 2001-03-29
Related Reports
Duplicate :  
JDK-4217345 - stddoclet: -quiet option to shut off non-error processing/generating messages
Description

Name: dm26566			Date: 03/29/2001


When we generate the javadocs in the j2sdk build (build target 'docs'), a
series of javadoc commands are issued. Even though the '-verbose' flag is
not set, there seems to be a _lot_ of the following types of statements
generated:

  Generating
./../build/solaris-sparc/doc/api/javax/imageio/plugins/JPEGHuffmanTable.html...

and

  Copying file
./../src/share/classes/javax/imageio/metadata/doc-files/standard_metadata.html
to directory
./../build/solaris-sparc/doc/api/javax/imageio/metadata/doc-files...

and I mean LOTS:
  over 15,000 "Generating " comments
  over 18,000 "Copying file " comments

There is a lot of important info (warnings), that I want to get - is there
any way to move the "Generating" and "Copying file" output to verbose mode
only?

======================================================================
Comments
EVALUATION This is a dupe of 4217345. We need to decide whether to break "compatibility" and offer a new option, such as -quiet (suggested by an outside developer), or modify -verbose so the default is not to show those "processing" and "generating" messages. What do other tools in the J2SE SDK do? Do they only show warnings and errors in the default mode and processing messages in the -verbose mode? doug.kramer@Eng 2001-03-29
29-03-2001