Re: [Boost-docs] Changes to syntax_highlight.hpp

Subject: Re: [Boost-docs] Changes to syntax_highlight.hpp
From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-08-09 14:16:44

>-----Original Message-----
>From: boost-docs-bounces_at_[hidden] 
>[mailto:boost-docs-bounces_at_[hidden]] On Behalf Of 
>Andreas Pokorny
>Sent: 08 August 2007 22:42
>To: boost-docs_at_[hidden]
>Subject: [Boost-docs] Changes to syntax_highlight.hpp
>
>Hello,
>I joined the group of people helping to improve the boost
>documentation. I started adding three new color schemes,
>because I was not happy with the results I modified
>syntax_highlight.hpp:
>
>1) Support for multiline macros and C-comments inside macros
>2) #include "files" and <files> are treated as "preprocessor" and
>"string" tokens
>3) separation of "keyword" in four groups:
> a) "types-keywords": builtin types, also some C99/boost-stdint types
>and typical typedef keywords
> b) "control-flow": keywords controling the program flow like 
>for break return
> c) "operators": and or xor.. and C++ casts
> d) "keyword":  the remaining keywords: virtual class union asm struct
>template private public...
>
>Can I commit that?
>Do you have objections regarding the keyword groups?
>Because I have :). I dont think that grouping them like that
>is very wise. I just had the feeling that at least two different
>groups should look at lot better than just one. Somehow
>there are now four different groups.

I'd also like to see what you are proposing.  I'm pretty estatic about the syntax colors we have now in the math toolkit :-)

I would comment that there are a limited number of colors that can effectively be used because most are not saturated enough (think
yellow & line green!)

So producing more keyword sub-types may not be so useful as you hope, because one can't have another color for them.  But perhaps
some subtle tone changes, like a red-sh blue and a greener blue can be enough to usefully distinguish keyword subtypes.

the proof of the pudding is in the viewing (both on screen and on paper) (to mix my metaphors ;-)

Paul

---
Paul A Bristow
Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB
[phone] & SMS, Mobile [phone] & SMS
pbristow_at_[hidden]