Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4463460
Votes 0
Synopsis stddoclet: Javadoc warnings for main() method do not specify the enclosing clas
Category doclet:tbd
Reported Against 1.3.1
Release Fixed
State 11-Closed, duplicate of 4396665, bug
Priority: 4-Low
Related Bugs 4396665
Submit Date 26-MAY-2001
Description




java version "1.3.0_02"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0_02)
Java HotSpot(TM) Client VM (build 1.3.0_02, mixed mode)

Typically javadoc gives warnings messages that state the full classname from
which the warning originated, like:

javadoc: warning - Method suncertify.db.DataServer.getRecord
        documents that it throws java.io.IOException,
        but does not declare it.

However, when I run it over a class DataServer it gives this warning for the
main method, which doesnt not specify the enclosing class and thus makes it
very diffcult to locater the problem in a large codebase:

javadoc: warning - main: @param tag has no arguments.

The method javadoc showing the @param problem is:
    /**
     * Creates a data delegate, then DataServer, and exports to RMI registry.
     * @param
     */
    public static void main(String[] args) {
       etc, etc
    }
(Review ID: 124879) 
======================================================================
Work Around




Look for such warnings in any classes you know have main() methods.
======================================================================
Evaluation
Will investigate and fix asap.
  xxxxx@xxxxx   2001-05-25
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang