Joel de Guzman wrote:
> David Abrahams wrote:
>> Joel de Guzman <[EMAIL PROTECTED]> writes:
>>
>>>> IMO if we want to be able to reliably comment out regions, we either
>>>> need to actually parse the interior of the comment just as though it
>>>> was regular QBK (in which case you can't comment out
>>>> syntactically-invalid stuff) or we need a region terminator that's
>>>> reasonably distinctive. IOW, ']' doesn't cut it.
>>> This will not be a problem once we make unescaped [ and ]
>>> illegal in Qbk (including inside simple style markups).
>> You still won't be able to easily comment out syntactically-invalid
>> stuff.
>
> Right. I didn't quite read that properly. We do indeed need
> a proper terminator if that is important. How about:
>
> [/ stuff with invalid stuff /]
I like that... But I would like it more as:
[/NOT_WORKING
some stuff which is broken [' sdf sdfg'[
NOT_WORKING/]
With the "NOT_WORKING" part being optional. Idea is from here-docs of
shell, and Perl. The most important aspect is that one doesn't need to
keep track of nesting comments, correct syntax inside the comments, and
of course it's self documenting why one is commenting out a large chunk
of text.
--
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys - and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
