Bug 69272

Summary: [Javadoc] Invalid malformed reference (missing separator)
Product: [Eclipse Project] JDT Reporter: David Pérez <dperezcar>
Component: CoreAssignee: Frederic Fusier <frederic_fusier>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: P3    
Version: 3.0   
Target Milestone: 3.0.1   
Hardware: PC   
OS: Windows 2000   
Whiteboard:

Description David Pérez CLA 2004-07-05 03:21:22 EDT
I have the following source

	/**@see org.apache.avalon.excalibur.pool.Recyclable#recycle()*/
	public void recycle() {
		super.recycle();
	}

The following warning is reported:

Javadoc: Malformed reference (missing separator after method reference closing
brace)

If I add a space after the #recycle() no warning is reported:

	/**@see org.apache.avalon.excalibur.pool.Recyclable#recycle() */

I think this warning shouldn't be issued.
Comment 1 Frederic Fusier CLA 2004-07-05 07:41:55 EDT
There must be a white space character after the @see reference otherwise Javadoc
will generate a warning...
But of course compiler should not complain when there's comment end characters
even if there are stuck to reference...
Comment 2 Frederic Fusier CLA 2004-07-08 09:42:13 EDT
Fixed.

Compiler does not longer complain on this syntax.

[jdt-core-internal]
Change done in AbstractCommentParser.parseComment(int,int).
Test cases added in JavadocTestMixed and ASTConverterJavadocTest.
Comment 3 Frederic Fusier CLA 2004-07-08 09:42:21 EDT
Released in HEAD.
Comment 4 David Audel CLA 2004-09-06 10:28:16 EDT
Verified for 3.0.1 RC1