Name: nt126004			Date: 01/28/2003


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) 
======================================================================