Re: [Boost-docs] [quickbook] Comments

Subject: Re: [Boost-docs] [quickbook] Comments
From: Joel de Guzman (joel_at_[hidden])
Date: 2007-07-30 07:25:09

Kai Brüning wrote:

>> [/ this is a quickbook comment /]
>> 
>> I think this is the best suggestion so far. However, it is, again,
>> breaking.
>> 
>> Anyway, now that we are talking about breaking code for 1.4 (or 1.5 as John
>> suggests), perhaps it's time to implement it this way?
> 
> One additional aspect: Nestable comments can't be catched by a single regular
> expression.
> 
> I am currently implementing syntax hiliting of quickbook files for the
> Pygments syntax highlighter. Using regular expressions and states, the
> nestable comments in 1.4 forces a lot more states because comments can be
> nearly everywhere.
> 
> I wouldn't rate this important, but everything else being equal, the easier
> handling of non-nestable comments with regular expressions may be of value in
> a variety of cases.

Indeed! This was one of the the reasoning that Rene (and Dave) had
when that comment syntax was suggested. So, could you please state
if you are in favor of the [/ this is a quickbook comment /] syntax
for 1.5 and above?

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net