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: 4359889
Votes 0
Synopsis stddoclet: Option to omit fully-qualified package name from ahead of class names
Category doclet:tbd
Reported Against 1.2 , 1.3 , 1.2beta3
Release Fixed 1.4(merlin-beta2)
State 10-Fix Delivered, Verified, request for enhancement
Priority: 4-Low
Related Bugs 4145493 , 4419799
Submit Date 05-AUG-2000
Description
This is a request to allow the user to determine to show or hide the
package name as a prefix to class/interface names.  Here is one
request to show less, and another to show more:

.................
Is there a way to keep a class from showing up with a fully qualified name? 
For example, the method section of one particular javadoc page has 2 methods: 
(1) java.lang.String method1() 
(2) void method2(java.lang.String s) 

It would be much easier to read the documentation if it referred to
String           rather than java.lang.String, and
FileInputStream  rather than java.io.FileInputStream, 
etc.

Javadoc currently includes the fully qualified name if the
class is not in the package of the current class.
Details are at:

http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#shortened

(This feature may be more important for MIF doclet than the standard doclet,
because printed books are more space conscious than online books.)

....................
Another developer has asked for the opposite -- to display 

I'm trying to get javadoc to be package explicit about the "Implemented 
Interfaces", "Direct Known Subclasses", "Implements", and the "See Also" list.

Right now with 1.3 (for example) my javadoc html says a class implements 
"Destination".  I want it to say it implements javax.jms.Destination

It does what I want for things it cannot hyper-link to on the "All Implemented 
interfaces" list - eg. java.io.Serializable - I'd like it to do so even for 
things it can link to.
Work Around
N/A
Evaluation
Also see related RFE 4145493, for external references only.  Perhaps both 
should be combined into a single RFE.
  xxxxx@xxxxx   2001-01-31

The option "-exclucequalifier" was added to the standard doclet.  It works as described in #3 in the suggested fix.  For example:

-excludequalifier java.*:com.*

Location of fix:

MethodSubWriter.java
HtmlStandardWriter.java
FieldSubWriter.java
standard.java
Configuration.java

  xxxxx@xxxxx   2001-06-18

option has been renamed to -noqualifier.

  xxxxx@xxxxx   2001-06-18
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang