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.
It would be nice if there was a coloring scheme for JavaDoc block comments. Vim is the other editor I commonly use and it's syntax highlighting is such that: 1: The first sentence is in a slightly lighter color then the rest of the comment block so it's easy to see what will be in the summary lines of the JavaDoc output. 2: The @tags are shown in a slightly darker color. 3: The @tags variable name if it exists is a slightly lighter color with the description the normal comment block color. vim will also color html tags a different color but personally I don't care as much about that.
Set target milestone to TBD
Changing subcomponent to syntax coloring
*** Issue 35679 has been marked as a duplicate of this issue. ***
*** Issue 22390 has been marked as a duplicate of this issue. ***
See issue #22390 for additional requirements on javadoc coloring.
*** Issue 23474 has been marked as a duplicate of this issue. ***
As mentioned in #23474, the color of javadoc comments could differ from non-javadoc comments. Take this into account when working on this RFE.
We have already colorings for javadoc tags and html tags in javadoc comments. Still need first sentence highlighting and parameter names highlighting. There is contrib/JavadocFirstSentence which shows first sentence in bold, but it should be incorporated in javadoc module and exposed as a proper coloring in Tools-Options, so that users could customize it.
I did some improvements, see attached snapshots
Created attachment 108252 [details] Original javadoc
Created attachment 108253 [details] Improved coloring html tags are bold and in different color (153,153,255) first javadoc sentence is bold Parameters are still not highlighted. BTW I think, that Javadoc lexer does not work correctly. Regular javadoc text is JavadocTokenId.IDENT which is wrong imo. Regular comment should be OTHER_TEXT and IDENT can be used for instance for parameters (single word behind @param tag) or for words inside {@link some words}. So we can use different colors for it.
Honzo L, what do you think about my lexer issue?
Created attachment 108254 [details] patch
Created attachment 108383 [details] First sentence in bold via new highliting layer. Parameters highlighted (via modified lexer and lexer based highlighting.
Changeset: http://hg.netbeans.org/jet-main/rev/a131af4aee42 Author: Jan Becicka <jbecicka@netbeans.org> Date: 2011-05-31 11:34 Message: Issue #25509 - JavaDoc comments syntax coloring
Changeset: http://hg.netbeans.org/jet-main/rev/c46fedce0c56 Author: Jan Becicka <jbecicka@netbeans.org> Date: 2011-05-31 11:39 Message: Issue #25509 - JavaDoc comments syntax coloring
Integrated into 'main-golden', will be available in build *201106010401* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress) Changeset: http://hg.netbeans.org/main/rev/a131af4aee42 User: Jan Becicka <jbecicka@netbeans.org> Log: Issue #25509 - JavaDoc comments syntax coloring