JDK-4817396 : javadoc does not generate a link for a method from a foreign package
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.1
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • OS: windows_2000
  • CPU: x86
  • Submitted: 2003-02-12
  • Updated: 2014-05-05
  • Resolved: 2003-02-15
Related Reports
Duplicate :  
Description

Name: rmT116609			Date: 02/12/2003


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

FULL OS VERSION :
Microsoft Windows 2000 [Version 5.00.2195]

A DESCRIPTION OF THE PROBLEM :
Javadoc does not produce a link for a method in a foreign package.


STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Execute:

javadoc -link "http://java.sun.com/j2se/1.4/docs/api/" -sourcepath . cat.java



EXPECTED VERSUS ACTUAL BEHAVIOR :
<dt><b>See Also:</b><dd>
<code>
  <a HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/System.html#getProperties()">System.getProperties()</a>
</code></dl>
<dt><b>See Also:</b><dd><code>System.getProperties()</code></dl>

ERROR MESSAGES/STACK TRACES THAT OCCUR :
no messages

REPRODUCIBILITY :
This bug can be reproduced always.

---------- BEGIN SOURCE ----------
public class cat
{
  /**
   * @see java.lang.System#getProperties()
   */
  public static void main(String[] args)
  {
  }
}
---------- END SOURCE ----------


(Review ID: 181164) 
======================================================================

Comments
EVALUATION The link fail to external classes that are not imported. This is a duplicate of the following bug that was fixed in 1.4.2: 4652655: Fixed @link to link to external -link'd classes This fix greatly simplifies the ability to link to external classes and members. Previously, an external class needed to be either imported or fully qualified in a declaration in order for @see or {@link} to possibly link to its documentation. Now, it is only required that the class be fully qualified; it no longer needs to be imported (which was the previous recommended workaround). ###@###.### 2003-02-14
14-02-2003