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

FULL OPERATING SYSTEM VERSION : customer  Windows 2000 [Version
5.00.2195]




A DESCRIPTION OF THE PROBLEM :
The use of @link tags within javadoc comments that refer to external
javadoc, such as the Sun JDK javadoc, will correctly generate HTML links
when the @link tag refers to a class, but not when it refers to a method
within the class.

Use of the @see tag to refer to external classes
shows the same behavior - class links are generated, but method links are
not.

REGRESSION.  Last worked in version 1.3.1

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1.Use the attached simple test class.
2.Generate javadoc for the
class, using the command line:
"javadoc -link
http://java.sun.com/j2se/1.4/docs/api TestLink.java"
(This behavior also exists with the "-linkoffline" flag.)
3.View
generated JavaDoc for the someMethod() method.


EXPECTED VERSUS ACTUAL BEHAVIOR :
Expected links to both the String class, as well as to the indexOf method
within the String class.

Actual results only generated a link to the
String class, NOT to the indexOf method.

This works correctly in JDK
1.3.1 - both links are generated.
Solaris 8 with JDK 1.4 beta 3 also
works.

This bug can be reproduced always.

---------- BEGIN SOURCE ----------
public class TestLink
{
    /**
     * Test method. This is more comment.
For more information, see the
     * {@link java.lang.String String }
class. It would be better if you
     * could look at the {@link
java.lang.String#indexOf(int) indexOf }
     * method, but maybe that's
asking too much.
     *
     * @param s String to test
     * @return true or
false
     * @see java.lang.String doc for String
     * @see
java.lang.String#indexOf(int) indexOf
     */
    public boolean
someMethod(String s)
    {
        if (s.indexOf('c') == -1)
            return false;
        
else
            return true;
    }

    public static void main(String [] argv)
    
{
        TestLink tl = new TestLink();
        if (tl.someMethod("foo"))
            
System.out.println("got c");
        else
            System.out.println("no got
c");
    }
}
---------- END SOURCE ----------

Release Regression From : 1.3.1
The above release value was the last known release where this 
bug was knwon to work. Since then there has been a regression.

(Review ID: 137471) 
======================================================================

N/A

Important bug.
  xxxxx@xxxxx   2002-01-10

Occurs in 1.4 FCS, too. It is a re-appearance of the bug discussed in "B8" of the Javadoc FAQ 
(http://java.sun.com/j2se/javadoc/faq.html#linksnotgenerated122).

It appears the reference to 1.4.1 in this bug report is 
erroneous. The bug is actually fixed in mantis, which is 1.4.2.

This bug is not fixed in 1.4.1 and should be reopened. The 
release notes even tell you that it is not fixed so why  is it a 
closed bug.

You're correct, this was not fixed in 1.4.1 either.  We have 
finally fixed it in 1.4.2.  I've added this comment to the
bug.

-Doug Kramer 
Javadoc team