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 211639 - Java comment should needs improvements - such as - To show warning if the {@link } is invalid and etc
Summary: Java comment should needs improvements - such as - To show warning if the {@l...
Status: NEW
Alias: None
Product: java
Classification: Unclassified
Component: Javadoc (show other bugs)
Version: 7.2
Hardware: PC Windows 7 x64
: P3 normal with 2 votes (vote)
Assignee: Jan Becicka
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-04-24 12:56 UTC by vidhyadharantechdays
Modified: 2012-04-25 13:59 UTC (History)
1 user (show)

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:

Attachments
Screenshot for this issue (23.15 KB, image/png)
2012-04-24 12:56 UTC, vidhyadharantechdays 		Details
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 vidhyadharantechdays 2012-04-24 12:56:44 UTC 
Created attachment 118688 [details]
Screenshot for this issue

i have misspelled in the comment area but IDE doesn't figured it out.

I am suggesting if link or parameter variable is misspelled it should highlight in the line numbers. Please find the attached.
Comment 1 matthies 2012-04-25 12:04:00 UTC 
I agree, this would be very useful.
Comment 2 Jan Becicka 2012-04-25 12:28:07 UTC 
You should see warning "missing param tag for id" ...
Comment 3 javydreamercsw 2012-04-25 12:44:19 UTC 
If you enable the hints for javadoc you'll see it (as a light bulb)
Comment 4 vidhyadharantechdays 2012-04-25 13:16:16 UTC 
Thanks javydreamercsw. But for links it is not indicating balloon simple
Comment 5 Jan Becicka 2012-04-25 13:29:20 UTC 
so parameters *are* highlighted.
Comment 6 matthies 2012-04-25 13:40:00 UTC 
It would be nice to be able to have Javadoc referencing warnings/errors highlighted the same way as compiler errors (e.g. red wave underline).

Note also that warning about a parameter without a @param tag is not the same as warning about a @param tag that doesn't match any parameter. I want the latter, but not the former, because it's okay (YMMV) to not document each and every parameter, but it's not okay to document a non-existent parameter.
Comment 7 Jan Lahoda 2012-04-25 13:42:51 UTC 
(In reply to comment #6)
> It would be nice to be able to have Javadoc referencing warnings/errors
> highlighted the same way as compiler errors (e.g. red wave underline).

Its easy to configure any hint to use the error highlight - simply set the Show As combo in the Tools/Options/Editor/Hints/Java/... to "Error".
Comment 8 vidhyadharantechdays 2012-04-25 13:47:14 UTC 
(In reply to comment #5)
> so parameters *are* highlighted.

Yes Parameters are highlighting , But instead of showing "remove @param tag" warning , it should ask to change the variable name. Because if i choose "remove @param tag" sadly it removes my comment :( .