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

Bug 86077

Summary: Docs incomplete, out of date with respect to syntax highlighting
Product: [Eclipse Project] JDT Reporter: Allan Pratt <apratt>
Component: DocAssignee: JDT-Doc-Inbox <jdt-doc-inbox>
Status: RESOLVED WONTFIX QA Contact:
Severity: enhancement    
Priority: P3 CC: daniel_megert, deepakazad
Version: 3.1Keywords: helpwanted
Target Milestone: ---   
Hardware: All   
OS: All   
Whiteboard:

Description Allan Pratt CLA 2005-02-21 18:52:12 EST 
I expected to find a help page which described the default syntax coloring, so 
I could tell what the editor was trying to tell me when it italicized something 
and drew it in blue. There is no help page that describes this.

The closest I found was Java Development User Guide > Reference > Prefences > 
Java > Java Editor. This page shows the preferences that one can set, and it 
has a section about syntax coloring.

But the "default" column just says "Default colors" for all colorable items, 
and the list of colorable items doesn't match what's actually available when 
you go to the corresponding Preferences page.

I'd expect this help page to list all the syntax elements that the JDT edior 
knows how to format, and the default color and style for those items which have 
a color and style enabled by default. It would also be useful for the user if 
the table were presented in the other order: style on the left, meaning on the 
right.

Of course the static, HTML-based help can't keep up with customizations, but it 
can keep up with defaults.

I have Eclipse 3.1.0 build 200412162000.
Comment 1 Dani Megert CLA 2010-06-07 10:38:35 EDT 
You can see all this in the preview.
Comment 2 Deepak Azad CLA 2011-05-29 10:26:09 EDT 
(In reply to comment #0)
> I expected to find a help page which described the default syntax coloring, so 
> I could tell what the editor was trying to tell me when it italicized something 
> and drew it in blue. There is no help page that describes this.

The default syntax coloring can be see at Java > Editor > Syntax Coloring preference page, and this preference page can be opened directly from the help page 'Java development user guide > Reference > Preferences > Java > Editor > Syntax Coloring'.

Hence no point in adding the description for each color to help. Closing as WONTFIX.