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