Bug 125676 - [javadoc] @category should not read beyond end of line
Summary: [javadoc] @category should not read beyond end of line
Status: VERIFIED FIXED
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.2   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: 3.2 M5   Edit
Assignee: Frederic Fusier CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-01-30 04:42 EST by Philipe Mulet CLA
Modified: 2006-02-14 12:23 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 Philipe Mulet CLA 2006-01-30 04:42:53 EST 
Version: 3.2.0
Build id: I20060125-0800

The following javadoc yields "@category When" which feels inappropriate.
I would expect category reading to not continue on next line.

	/**
	 * @category 
	 * When searching for field matches, it will exclusively find read accesses, as
	 * opposed to write accesses. Note that some expressions are considered both
	 * as field read/write accesses: for example, x++; x+= 1;
	 * 
	 * @since 2.0
	 */
	int READ_ACCESSES = 4;
Comment 1 Frederic Fusier CLA 2006-01-31 05:03:33 EST 
Fixed and released in HEAD.

SourceJavadocParser does no longer read words on next line for categories identifiers. However, in your example following lines are still associated with @category tag...

Test cases added in ASTConverterJavadocTest, ClassFileTest (testGetCategories07-09) and CompilationUnitTest (testGetCategories14-15).
Comment 2 David Audel CLA 2006-02-14 12:23:05 EST 
Verified for 3.2 M5 using build I20060214-0010