Name: rmT116609 Date: 01/02/2002
FULL PRODUCT VERSION :
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 :
Windows NT Version 4.0
A DESCRIPTION OF THE PROBLEM :
The {@inheritDoc} does not copy comments from superclasses
as it's supposed to do. It just puts '{@inheritDoc}' in the
output html file.
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Create two files:
SuperClass.java:
/**
* A SuperClass comment.
*/
public class SuperClass {
/**
* The comment for the superclass method.
*/
public void method() {}
}
and SubClass.java:
/**
* A SubClass comment.
*/
public class SubClass extends SuperClass {
/**
* {@inheritDoc}
*/
public void method() {}
}
2. Call javadoc ('javadoc SuperClass.java SubClass.java')
with the two files
EXPECTED VERSUS ACTUAL BEHAVIOR :
Actual result for the html code for the method method() in
SubClass.html:
<A NAME="method()"><!-- --></A><H3>method</H3>
<PRE>public void <B>method</B>()</PRE>
<DL>
<DD>{@inheritDoc}
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A
HREF="SuperClass.html#method()">method</A></CODE> in class
<CODE><A HREF="SuperClass.html">SuperClass</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
Expected result for the html code for the method method()
in SubClass.html:
<A NAME="method()"><!-- --></A><H3>method</H3>
<PRE>public void <B>method</B>()</PRE>
<DL>
<DD>The comment for the superclass method.
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A
HREF="SuperClass.html#method()">method</A></CODE> in class
<CODE><A HREF="SuperClass.html">SuperClass</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
This bug can be reproduced always.
(Review ID: 137746)
======================================================================