This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 85230 - Every '@' beginning word inside javadoc emphasized as a javadoc tag
Summary: Every '@' beginning word inside javadoc emphasized as a javadoc tag
Status: REOPENED
Alias: None
Product: java
Classification: Unclassified
Component: Source (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: Miloslav Metelka
URL:
Keywords:
: 120267 133322 143113 (view as bug list)
Depends on:
Blocks:
 
Reported: 2006-09-19 12:54 UTC by Max Sauer
Modified: 2011-01-11 05:13 UTC (History)
2 users (show)

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:


Attachments
screenshot (6.87 KB, image/png)
2006-09-19 12:59 UTC, Max Sauer
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Max Sauer 2006-09-19 12:54:45 UTC
Inside javadoc blocks inside editor, every word leaded with '@' is emphasized as
a javadoc tag. See attached screenshot.  

We should probably emphasize only tags from following list:
http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/javadoc.html#javadoctags

---   
NetBeans IDE Dev (Build 060919)   
1.5.0_05; Java HotSpot(TM) Server VM 1.5.0_05-b05   
Linux version 2.6.12-1.1390_FC4smp running on i386   
en_US (nb); UTF-8   
NetBeans-dev-060919
Comment 1 Max Sauer 2006-09-19 12:59:22 UTC
Created attachment 34149 [details]
screenshot
Comment 2 Jan Lahoda 2007-03-23 14:40:07 UTC
Hm, I think that the list of tags is not very static, so we should recognize all
words that fulfill the tags requirements (as specified on the above page).
Comment 3 Jan Becicka 2007-09-11 14:18:40 UTC
"Every '@' beginning word inside javadoc emphasized as a javadoc tag"
And this is exactly how it should work. Because everything starting with @ is javadoc tag. List you mentioned is list of
standard tags, but users can use their own custom tags with their own doclets.
Comment 4 Jiri Prox 2007-10-29 10:58:16 UTC
*** Issue 120267 has been marked as a duplicate of this issue. ***
Comment 5 Vitezslav Stejskal 2007-10-29 14:57:35 UTC
Well, while it's true that technically every @ denotes a tag in javadoc the way how this feature is working right now
makes it pretty much useless. Generally, using different colors or fonts for different parts of text helps reducing
typos. IMO 99% of users only use javadoc tags from standard doclet, so showing only these tags in bold comparing to
anything after @ would really help most of us who write javadoc.

If the javadoc support wants to be really smart it could check what doclet it's using and get the list of tags from
there or it could let users add extra tags manually. I'm inclined to reopen this as RFE, but will leave the decision on
the module owners.
Comment 6 Jan Pokorsky 2007-10-29 15:31:49 UTC
I agree, it is a valid RFE. Others solve this with a custom tags manager.
Comment 7 Jiri Prox 2008-05-03 16:05:30 UTC
*** Issue 133322 has been marked as a duplicate of this issue. ***
Comment 8 Jiri Prox 2008-08-07 13:37:21 UTC
*** Issue 143113 has been marked as a duplicate of this issue. ***