Name: gm110360 Date: 11/13/2002 FULL PRODUCT VERSION : C:\Java>java -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 : Windows ME A DESCRIPTION OF THE PROBLEM : @param tag in the sub class is ignored. STEPS TO FOLLOW TO REPRODUCE THE PROBLEM : 1. Try to generate a javadoc with the sample above 2. 3. EXPECTED VERSUS ACTUAL BEHAVIOR : @param tag in the sub class should be reflected in a generated HTML file. But @para tag in the base class is copied into the generated HTML files. REPRODUCIBILITY : This bug can be reproduced always. ---------- BEGIN SOURCE ---------- abstract class InheritDocBase { /** * Return the last name of persons whose first name is matched. * * @param firstName firstName to be searched * @return array of last names * @throws java.lang.Exception name not found */ public abstract String[] geLastName(String firstName) throws Exception; } class InheritDocSub extends InheritDocBase { /** * Based on the address book, {@inheritDoc} * * @param firstName first Name to be searched from the address book. */ public abstract String[] geLastName(String firstName) throws Exception; } ---------- END SOURCE ---------- (Review ID: 166857) ====================================================================== Name: rmT116609 Date: 02/27/2003 DESCRIPTION OF THE PROBLEM : Using {@inheritDoc} in a method comment overrides the @param tag. The {@inheritDoc} should only add text, not override any, and it shouldn't affect tags that don't contain it. STEPS TO FOLLOW TO REPRODUCE THE PROBLEM : 1. javadoc SuperClass.java SubClass.java EXPECTED VERSUS ACTUAL BEHAVIOR : SubClass METHOD DETAIL contents: expected: Parameters: bar - subclass doc bar actual: Parameters: bar - superclass doc bar REPRODUCIBILITY : This bug can be reproduced always. ---------- BEGIN SOURCE ---------- public class SuperClass { /** * First sentence from superclass. Second sentence from superclass. * @param bar superclass doc bar */ public void foo( int bar ) {} } public class SubClass extends SuperClass { /** * {@inheritDoc} First sentence from subclass. Second sentence from subclass. * @param bar subclass doc bar */ public void foo( int bar ) {} } ---------- END SOURCE ---------- (Review ID: 181838) ======================================================================
|