Bug 101139 - [javadoc] Spurious "Javadoc: Invalid reference" error with type names in link
Summary: [javadoc] Spurious "Javadoc: Invalid reference" error with type names in link
Status: VERIFIED WORKSFORME
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.1   Edit
Hardware: Macintosh All
: P5 normal (vote)
Target Milestone: 3.6 M2   Edit
Assignee: Jay Arthanareeswaran CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-06-21 16:21 EDT by Avi Drissman CLA
Modified: 2009-09-16 09:54 EDT (History)
3 users (show)

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 Avi Drissman CLA 2005-06-21 16:21:50 EDT 
On code like:

/**
 * I love {@link java.lang.String short trips}.
 */
public void foo()
{ //...

turning the preference Java > Compiler > Javadoc > Malformed Javadoc comments to Warning causes a 
spurious "Invalid reference" warning on the javadoc. The problem is with the word "short". Using "long", 
"int", "float", or any number of other typenames causes the error; drop the "short" and no complaints.

(On 3.1M7)
Comment 1 Philipe Mulet CLA 2005-06-22 04:42:49 EDT 
Non critical
Comment 2 Frederic Fusier CLA 2005-06-22 05:36:40 EDT 
Defer post 3.1
Comment 3 Frederic Fusier CLA 2005-08-05 04:47:48 EDT 
Reopen for 3.2
Comment 4 Frederic Fusier CLA 2006-03-30 10:07:27 EST 
Defer post 3.2
Comment 5 Frederic Fusier CLA 2007-06-21 09:55:22 EDT 
Reopen as LATER is deprecated...
Comment 6 Eric Jodet CLA 2008-05-22 07:35:02 EDT 
while parsing the qualified reference.
Fixing bug 233428 should prevent the warning to be raised, as 
"short trips"  in {@link java.lang.String short trips} should be considered as the label after the qualified reference.
Comment 7 Eric Jodet CLA 2008-05-22 07:39:22 EDT 
(In reply to comment #6)
> while parsing the qualified reference.
> Fixing bug 233428 should prevent the warning to be raised, as 
> "short trips"  in {@link java.lang.String short trips} should be considered as
> the label after the qualified reference.
> 

(some odd bugzilla behavior within my browser: missing heading text)

The warning is caused by an InvalidInputException being thrown in the AbstractCommentParser#parseQualifiedName(boolean) method, while parsing the qualified reference.

Fixing bug 233428 should prevent the warning to be raised, as 
"short trips"  in {@link java.lang.String short trips} should be considered as
the label after the qualified reference.
Comment 8 Frederic Fusier CLA 2008-09-04 12:13:51 EDT 
Ownership has changed for the javadoc comments bugs, but I surely will not have enough time to fix your bug during the 3.5 development process, hence set its priority to P5.
Please provide a patch if you definitely need the bug to be fixed in this
version and I'll have a look at it...
TIA
Comment 9 Jay Arthanareeswaran CLA 2009-08-21 01:13:05 EDT 
I no longer see this issue (as of build I20090714-0800)
I don't know what fixed the bug, though. Marking it as WORKSFORME.
Comment 10 Olivier Thomann CLA 2009-09-16 09:54:48 EDT 
Verified for 3.6M2 using I20090915-0100.