Bugzilla – Full Text Bug Listing
| Summary: | [javadoc] Unexpected warning about missing parameter doc in case of @inheritDoc | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Product: | [Eclipse Project] JDT | Reporter: | Dani Megert <daniel_megert> | ||||||
| Component: | Core | Assignee: | Frederic Fusier <frederic_fusier> | ||||||
| Status: | VERIFIED FIXED | QA Contact: | |||||||
| Severity: | normal | ||||||||
| Priority: | P3 | CC: | david_audel | ||||||
| Version: | 3.4 | ||||||||
| Target Milestone: | 3.5 M2 | ||||||||
| Hardware: | All | ||||||||
| OS: | All | ||||||||
| Whiteboard: | |||||||||
| Attachments: |
|
||||||||
Look same as bug 246715... >Look same as bug 246715...
Almost. However, in case of {@inheritDoc} you must check whether there's indeed a comment that can be inherited.
*** Bug 246715 has been marked as a duplicate of this bug. *** (In reply to comment #2) > >Look same as bug 246715... > Almost. However, in case of {@inheritDoc} you must check whether there's indeed > a comment that can be inherited. > This is a real duplicate. This bug summary and description was about the unexpected warning... {@inheritDoc} check is another point and needs to be treated in a separate bug. Created attachment 112119 [details]
Proposed patch
Released for 3.5M2 >This bug summary and description was about the
>unexpected warning... {@inheritDoc} check is another point and needs to be
>treated in a separate bug.
Is there a bug for it? Really, what I expect is that @inheritDoc is handled correctly - that's all. I didn't expect that just because there are too many warning it isn't handled correctly at all.
Created attachment 112174 [details]
Additional patch to fix same issue on other tags
Previous patch fixes the problem only for @param, @throws and @exception tags. This additional one, released in HEAD, fixes it for all standard tags...
Verified that the initially reported issue is fixed running on latest code. Thanks for the fast fix! Verified for 3.5M2 using I20080914-2000 |
N20080909-2000. A wrong warning is issued about missing parameter doc in case of @inheritDoc: /** * Do something more. * * {@inheritDoc} * * @param monitor {@inheritDoc} * @return {@link Status#OK_STATUS} */ ==> warns that monitor has missing doc. NOTE: warning must be enabled for all tags.