Bug 73995 - [Javadoc] Wrong warning for missing return type description for @return {@inheritDoc}
Summary: [Javadoc] Wrong warning for missing return type description for @return {@inh...
Status: VERIFIED FIXED
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.0   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: 3.0.2   Edit
Assignee: Frederic Fusier CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-09-15 12:57 EDT by Olivier Thomann CLA
Modified: 2005-03-10 05:12 EST (History)
0 users

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Olivier Thomann CLA 2004-09-15 12:57:16 EDT 
Using latest integration build, the following warnings are reported, but they
should not.
Severity	Description	Resource	In Folder	Location	Creation Time
1	Javadoc: Missing return type description	ASTNode.java
org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom	line 2298	15 septembre 2004
09:55:30
1	Javadoc: Missing return type description	IBinding.java
org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom	line 193	14 septembre 2004
10:29:59
1	Javadoc: Missing return type description	StructuralPropertyDescriptor.java
org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom	line 118	15 septembre 2004
09:06:34

This is done for code that looks like this:
	/**
	 * Returns a string suitable for debug purposes.
	 * @return {@inheritDoc}
	 */
The @return is tagged with the warning.
Comment 1 Frederic Fusier CLA 2004-09-19 11:40:41 EDT 
Fixed and released in HEAD.

Warning is no longer displayed when inline tag just follows @return tag.

[jdt-core-internal]
Changes done in JavadocParser.parseTag(int) method.
Test cases added in JavadocTestMixed
Comment 2 Frederic Fusier CLA 2004-09-20 05:07:42 EDT 
Fixed and released in R3_0_maintenance stream.
Bug Target needs to be set to 3.0.2 when it will be available...
Comment 3 Frederic Fusier CLA 2004-09-21 09:27:22 EDT 
Setting target to 3.1 M2 while waiting for 3.0.2 one...
Comment 4 David Audel CLA 2004-09-23 11:30:00 EDT 
Verified in I200409230100.
Comment 5 Frederic Fusier CLA 2004-09-24 05:18:07 EDT 
Finally set status as VERIFIED.
We'll only change target when fix will be definitely put in R3_0_maintenance
stream...
Comment 6 Frederic Fusier CLA 2005-01-26 12:48:17 EST 
Candidating fix for 3.0.2 release (not committed yet)
Comment 7 David Audel CLA 2005-03-10 05:12:41 EST 
Verified with M20050216