Bug 113266 - [syntax highlighting] javadoc tag names including period is not highlighting correctly
Summary: [syntax highlighting] javadoc tag names including period is not highlighting ...
Status: RESOLVED FIXED
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Text (show other bugs)
Version: 3.1   Edit
Hardware: PC All
: P3 normal (vote)
Target Milestone: 3.3 M2   Edit
Assignee: Tom Hofmann CLA
QA Contact:
URL:
Whiteboard:
Keywords: contributed
Depends on:
Blocks:
 
Reported: 2005-10-20 14:20 EDT by Michel Ishizuka CLA
Modified: 2006-09-07 05:08 EDT (History)
0 users

See Also:

Attachments
patch (616 bytes, patch)
2005-10-20 14:22 EDT, Michel Ishizuka CLA 		no flags Details | Diff
View All 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 Michel Ishizuka CLA 2005-10-20 14:21:00 EDT 
javadoc allows tag names including period.
Eclipse correctly shows it in "javadoc view" and hover text.
However syntax highlight does not consider to such tag names.
Comment 1 Michel Ishizuka CLA 2005-10-20 14:22:27 EDT 
Created attachment 28533 [details]
patch
Comment 2 Tom Hofmann CLA 2005-10-21 04:44:55 EDT 
Can you give the spec of what makes up a tag? I could not find the definition
anywhere? Please reopen when you do.
Comment 3 Michel Ishizuka CLA 2005-10-21 11:50:28 EDT 
I don't know specification of tag names. However I can show you that javadoc
allows tag names including period. 

1. create Taglet
ex) copy ToDoTaglet.java to your directory from
http://java.sun.com/j2se/1.4.2/docs/tooldocs/javadoc/taglet/ToDoTaglet.java


2. compile it 
ex) javac -classpath .;%JAVA_GOME%\lib\tools.jar ToDoTaglet.java

3. create javadoc with it.
ex) javadoc -classpath .;%JAVA_GOME%\lib\tools.jar -taglet ToDoTaglet
ToDoTaglet.java

4. you can read the following message.
----------------
Note: Custom tags that could override future standard tags:  @todo. To avoid pot
ential overrides, use at least one period character (.) in custom tag names.
----------------

this message clearly shows that javadoc allows tag names including period.
Comment 4 Tom Hofmann CLA 2005-10-21 12:17:56 EDT 
Thanks for the info. We should indeed color the entire tag, then.
Comment 5 Tom Hofmann CLA 2006-08-14 08:15:18 EDT 
released patch > 20060814 - thanks for the patch.