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: 4809652
Votes 0
Synopsis @see doesn't create a link to external references
Category doclet:tbd
Reported Against 1.4.1
Release Fixed
State 11-Closed, duplicate of 4652655, bug
Priority: 3-Medium
Related Bugs 4652655
Submit Date 29-JAN-2003
Description




FULL PRODUCT VERSION :
java version "1.4.1_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_01-b01)
Java HotSpot(TM) Client VM (build 1.4.1_01-b01, mixed mode)


FULL OPERATING SYSTEM VERSION :
> rpm --query glibc
glibc-2.2.5-164
> uname -a
Linux jupiter 2.4.19-4GB #1 Fri Sep 13 13:19:15 UTC 2002
i686 unknown


ADDITIONAL OPERATING SYSTEMS :
This bug is probably independant of the operating system

A DESCRIPTION OF THE PROBLEM :
@see does not create links to external references.

Try using @see and -link. @see does not get a href anchor
("link") in the html output.

Don't be confused by the warnings in the output. These are
another bug I already reported. Even if javadoc warns about
javax-references, the java.awt-references still should work.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Type in the source code below
2. javadoc it using javadoc -link URI-TO-API-DOC sourcefilename
3. Look at the generated documentation.

EXPECTED VERSUS ACTUAL BEHAVIOR :
Excpected Results:
The documentation should not just contain See also sections,
but the entries in the See also sections should be href
anchors ("links") to the corresponding items in the
referenced documentation.

Actual Results:
The documentation contains See also sections but the entries
aren't hyperlinks to the referenced documentation.

ERROR MESSAGES/STACK TRACES THAT OCCUR :
No error messages available

REPRODUCIBILITY :
This bug can be reproduced always.

---------- BEGIN SOURCE ----------
import java.awt.event.ActionListener;
import java.awt.event.KeyListener;

/** A simple interface TextComponents should implement.
 * It is used by History to capture commons between {@link java.awt.TextField}
and {@link javax.swing.JTextField}.
 * @author $Author$
 * @version $Revision$
 * @see java.awt.TextField
 * @see javax.swing.JTextField
 */
public interface TextComponent {

    /** Version information */
    static String revision = "$Revision$";

    /** Returns the text contained in this TextComponent.
     * If this TextComponent works with documents and the underlying document is
null, will give a NullPointerException.
     * @see java.awt.TextComponent#getText()
     * @see javax.swing.text.JTextComponent#getText()
     * @return the text
     * @throws NullPointerException if the document is <code>null</code>
     */
    String getText() throws NullPointerException;

    /** Sets the text contained in this TextComponent.
     * @see java.awt.TextComponent#setText(String)
     * @see javax.swing.text.JTextComponent#setText(String)
     * @param t the new text
     */
    void setText(String t);

    // ...
}
---------- END SOURCE ----------
(Review ID: 180354) 
======================================================================
Work Around
N/A
Evaluation
This bug has been fixed for mantis.
  xxxxx@xxxxx   2003-01-30
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang