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: 4359386
Votes 0
Synopsis stddoclet: Include package info when passing in source filenames (*.java)
Category doclet:tbd
Reported Against 1.2 , 1.1.7a , 1.2fcs
Release Fixed 1.4(merlin-beta2)
State 10-Fix Delivered, Verified, bug
Priority: 4-Low
Related Bugs 4162653 , 4213968
Submit Date 03-AUG-2000
Description
When passing in source filenames (rather than package names) on the command
line, the generated web pages do not contain a list of packages, a package page,
or package.html.  This request is to include this information, the same as if 
the user had passed in a list of package names.  Only the specified classes 
would be documented with their own class pages -- unspecified classes would
not be documented.  

For example, say class C belongs to package p, and C.java is passed in with
"javadoc C.java".  Package p and class p.C would be documented.  
Unspecified classes that belong to package p would remain undocumented.

(See the email trail in "Comments")
Work Around
N/A
Evaluation
I feel this is an important enhancement, and many developers have requested it.
  xxxxx@xxxxx   2000-12-08

Updated the synopsis and description to be more accurate, in that it should include all the package info, not just the package list.
  xxxxx@xxxxx   2001-06-29

Note that this possibly requires us to handle the unnamed package
when you pass in a .java file with no package declaration.
How about if we just add the word "<unnamed>" to the top (or bottom)
of the list of packages?

Changed from an RFE to a bug.
  xxxxx@xxxxx   2001-06-29

This bug has been fixed.  Location of fix:

IndexBuilder.java
AbstractPackageWriter.java
HtmlStandardWriter.java
PackageIndexFrameWriter.java

  xxxxx@xxxxx   2001-06-29

I have refined this fix to handle classes in unnamed packages.  A link with the lable <unnamed package>  now appears at the top of the packge list when classes in unnamed packages are specified on the command line. 
  xxxxx@xxxxx   2001-07-05
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang