Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 111037

Summary: [hovering] JavaDoc2HTMLTextReader confused by TABs before '@' tags
Product: [Eclipse Project] JDT Reporter: Daniel Giribet <dani>
Component: TextAssignee: JDT-Text-Inbox <jdt-text-inbox>
Status: CLOSED WONTFIX QA Contact:
Severity: minor    
Priority: P3    
Version: 3.1   
Target Milestone: ---   
Hardware: Macintosh   
OS: Mac OS X - Carbon (unsup.)   
Whiteboard: stalebug

Description Daniel Giribet CLA 2005-09-29 04:58:23 EDT
DESCRIPTION:

I style my javadoc comments like this (unles stated otherwise, spaces are spaces):

/** foodesc
*<TAB>foodesc2 
*<TAB>@author dgiribet
*<TAB>@version 1.0
*/

This causes the javadoc display to fail to recognize the '@' tags, does not format them in bold (as per 
prefs) nor does tabulate them neatly (one tag per line after the description), as expected.

WORKAROUND1:

/** foodesc
*<TAB>foodesc2
* @author dgiribet
*<TAB>@version 1.0
*/

If the first tag has a space and not a tab, it is parsed correctly and the following tags too, regardless of 
tab usage.

WORKAROUND2:

/** foodesc
*<TAB>foodesc2
*    @author dgiribet
*<TAB>@version 1.0
*/

Hardcoding the first tag with four spaces cures the problem as well.

CONCLUSION:

Strikes me as an odd parsing glitch. Looked up the description of Bug 49619, it might be related but I 
do not think it is the same problem.

SPECS:

JAVA 1.4.2_05, MacOSX 1.3.9
Comment 1 Tom Hofmann CLA 2005-09-29 06:34:15 EDT
JavaDoc2HTMLTextReader case.
Comment 2 Eclipse Genie CLA 2020-01-16 19:20:20 EST
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet. As such, we're closing this bug.

If you have further information on the current state of the bug, please add it and reopen this bug. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.

--
The automated Eclipse Genie.