This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
the {@inheritDoc} javadoc tag is supposed to inherit the parent method's javadoc for description, parameters, return value, thrown exceptions, etc. The NetBeans warnings for missing javadoc elements (missing @param, @returns, etc.) seems to respect the {@inheritDoc} tag for all cases except for the @throws tag. For example, consider the following code: In the parent class: /** * Gets a key spec for all keys which contain samples with the given value, * for the given band. * @param <E> the band data type * @param band the band * @param value the sample value to return keys for; may be null * @return a key spec * @throws DataAccessException if a data access exception occurred */ public <E> KeySpec getKeySpec(Band<E> band, E value) throws DataAccessException; In the child class: /** * {@inheritDoc} */ @Override public <E> KeySpec getKeySpec(Band<E> band, E value) throws DataAccessException { The child class has exactly one warning: "Missing @throws tag for DataAccessException". This is a false warning since the @throws tag is inherited. As a result of this problem, I have hundreds of false warnings throughout my code, making the warnings virtually useless.
Reassigning to javadoc.
Which build of 6.5 do you use? I cannot reproduce it in 6.5-fcs
BTW, /** {@inheritDoc} */ stands for explicitly inherited main description not for tags. They are inherited automatically if you omit them. You can omit the whole javadoc declaration in case you want to inherit everything. Anyway what you reported is a reproducible bug. Thanks for the report. jiriprox: In order to reproduce this it is necessary to place the exception declaration to another package.
fixed http://hg.netbeans.org/main/rev/ef6e18b0c437
Integrated into 'main-golden', will be available in build *200811191401* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress) Changeset: http://hg.netbeans.org/main/rev/ef6e18b0c437 User: Jan Pokorsky <jpokorsky@netbeans.org> Log: #153352: load context for inherited javadoc to resolve java elements properly
I'm still able to reproduce this problem with NetBeans IDE 8.0 (Build 201403101706) on OSX.
*** This bug has been marked as a duplicate of bug 242857 ***