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/