JDK-4213968 : stddoclet: Want default (i.e. unnamed) package to appear in package list
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.1.7,1.2.0
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • OS: generic
  • CPU: generic
  • Submitted: 1999-02-23
  • Updated: 2014-05-05
  • Resolved: 2001-08-21
Related Reports
Duplicate :  
Description

Name: vi73552			Date: 02/23/99


The problem is that the documentation of the classes of the default package are
not easely accessible. They appear in the index and in the class hierarchy, but
if you don't know the name of the class it is almost impossible to find them.

The default package does not appear in the package list. This is logical from a
certain point of view, since it is not a package, however it would be practical
to include it in order to know what classes are in the default package and have
access to their documentation in an easy way. It can be included in italics or
between brackets to make it clear that is not a "real" package.

I think it would be nice to have such a feature in 1.2 or any
later version of javadoc.
(Review ID: 43441) 
======================================================================

Name: krT82822			Date: 05/30/99


Javadoc (a great tool) has good support for packages,
with the "PackageListFrame" etc.  This is fine for everything
except classes that are in no packages, i.e. that are
in the "unnamed package".  Those appear only in the complete
"class list", scattered among classes that are in packages.
This feature request is to add a way to include the
"unnamed" package in the package list, with an associated
list of classes that aren't in a package.
(Review ID: 83660)
======================================================================

Comments
WORK AROUND Name: vi73552 Date: 02/23/99 None (that I know). ======================================================================
11-06-2004

PUBLIC COMMENTS This is a duplicate of bug 4359386, which has been fixed. ###@###.### 2001-08-20
20-08-2001

EVALUATION Yes, to find out un-named package classes can be a pain. We definitely need a way to figure out such classes from the all-classes list or class hierarchy. atul.dambalkar@eng 1999-02-23 I'm in favor of having a way to do this. The default package could appear in the package list as: [unnamed] or: [nopackage] We should get other opinions on this. doug.kramer@Eng 2001-02-27 I'm all in favor of it. I will note that since you can't specify the unnamed package as one of the packages you want to document, the javadoc tool can't correctly return it in the list of packages specified on the command line. Nevertheless, when you ask javadoc for the containing package of a class that is in the unnamed namespace, javadoc does correctly return a PackageDoc that refers to a package with an empty name. The standard doclet can do anything it wants with that. neal.gafter@Eng 2001-03-05 This is a duplicate of bug 4359386, which has been fixed. There is now a link to an index for classes in the unnamed package. ###@###.### 2001-08-20
05-03-2001