Re: [boost] Re: Preprocessor Docs Comments

From: Joel de Guzman (joel_at_[hidden])
Date: 2003-10-14 18:21:20

Brock Peabody <brock.peabody_at_[hidden]> wrote:
>> -----Original Message-----
> 
> [...]
> 
>> I have made this point before, and I know it is work for you, but if the
>> preprocessor library is worthy to be distributed to the masses as I am
>> sure
>> it is, it needs explanations which even non-metaprogramming programmers
>> can
>> understand. I think your level of explanation is pitched pretty high, for
>> the experts, and you need to consider an alternate mode of explanation for
>> everybody else.
> 
> A non-expert real-life user testimonial: I had never written a single macro
> in my life (besides include guards) before I started using
> Boost.Preprocessor and I didn't have any trouble figuring out how to use it
> from the documentation.  In fact, I was intimidated by macros until then but
> now I'm pretty comfortable with them.

Same here. I used to hate macros. But, it somehow grows on you ;-)

For beginners using the library, I think a better tutorial will ease the learning
curve a lot. I would suggest a "cook book" style tutorial that demos the facilities
stepwise.

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