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: 4673565
Votes 0
Synopsis -noqualifier with {@link} should suppress package names
Category customdoclets:mifdoclet
Reported Against 1.2beta1
Release Fixed 1.2beta2
State 10-Fix Delivered, bug
Priority: 3-Medium
Related Bugs
Submit Date 24-APR-2002
Description
(This is split off from bug 4647370)

All package names in @link tags should be suppressed when using -noqualifier.
They all seem to be ignored.  This should affect all @link tags, whether 
the class is included or included. 

Example sources:

package foo;

/**
 * Foo class.
 * Here are links to {@link foo.Foo#THREE}, {@link bar.Bar#FOUR} and
 * {@link java.lang.Integer#MAX_VALUE} constants.
 * Here are links to {@link foo.Foo#foo}, {@link bar.Bar#bar} and
 * {@link java.lang.Integer#intValue} methods.
 * Here are links to {@link foo.Foo}, {@link bar.Bar} and
 * {@link java.lang.Integer} classes.
*/
public class Foo {
    public static final int THREE = 3;
    public void foo() {}
}

package bar;

/**
 * Bar class.
 * Here are links to {@link foo.Foo#THREE}, {@link bar.Bar#FOUR} and
 * {@link java.lang.Integer#MAX_VALUE} constants.
 * Here are links to {@link foo.Foo#foo}, {@link bar.Bar#bar} and
 * {@link java.lang.Integer#intValue} methods.
 * Here are links to {@link foo.Foo}, {@link bar.Bar} and
 * {@link java.lang.Integer} classes.
 */
public class Bar {
    public static final int FOUR = 4;
    public void bar() {}
}

Run the command:
% javadoc -noqualifier java.lang -sourcepath . foo


RESULT:

Class Foo

Foo class. Here are links to THREE, bar.Bar.FOUR  and java.lang.Integer.MAX_VALUE constants. Here are links to foo(), 
bar.Bar.bar() and java.lang.Integer.intValue()  methods. Here are 
links to Foo, Bar and java.lang.Integer  classes.

Class Bar

Bar class. Here are links to foo.Foo.THREE, FOUR and 
java.lang.Integer.MAX_VALUE constants. Here are links to 
foo.Foo.foo(), bar() and java.lang.Integer.intValue()  
methods. Here are links to Foo, Bar and java.lang.Integer classes.

Work Around
N/A
Evaluation
Requested for 1.2beta3
  xxxxx@xxxxx   2002-04-23

I have fixed this bug in MIFObject.java.  This bug was located in method  getDocXRef().  That method now checks the noqualifier list before generating a label for the XRef.  I feel that this is a temporary fix.  The correct fix is  to convert ALL XRefs to Hypertext links.  We will fix that bug soon.

  xxxxx@xxxxx   2002-05-04
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang