|
Boost : |
Subject: Re: [boost] [AFIO] Review (or lack of it)
From: Niall Douglas (s_sourceforge_at_[hidden])
Date: 2015-08-29 10:50:23
On 29 Aug 2015 at 10:31, Glen Fernandes wrote:
> For me, long #if 0 blocks or /* commented out code are create a feeling of:
> - Inconvenience: It may as well not even be code in there; it could be
> a giant wall of text that starts with "Call me Ishmael." I just want
> to skip past it.
> - Doubt: About the quality or state of completeness. As if I was
> reading a paper with the author's annotations about things that yet
> need to be changed or fixed.
>
> The feelings are stronger still if it's in the documentation examples
> since they're more visible than the implementation.
I definitely can see the point in the documentation examples, and
there is an issue logged to have a script preprocess out all the #if
0 blocks.
Niall
-- ned Productions Limited Consulting http://www.nedproductions.biz/ http://ie.linkedin.com/in/nialldouglas/
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk