Re: [boost] Re: Re: Boost preprocessor library

From: Beman Dawes (bdawes_at_[hidden])
Date: 2003-01-14 16:12:39

At 11:15 AM 1/14/2003, David Abrahams wrote:

 >  "The Boost PP lib is a (mostly) functional programming system built
 >  around the C/C++ preprocessor.  The result of evaluating a Boost PP
 >  program is some new sequence of tokens, i.e. source code.
 >  ...
 >
 >This is very coarse, and also very short.

Perhaps, but it is that coarse-grained description that is often missing at 
the beginning of documentation.

The stuff that let's people who know nothing about a library classify it in 
their minds as "solves problems in the x domain".

 >  However, even something
 >like that on the front page of the documentation would be a big help.
 >I think the biggest missing piece in what's currently there is the
 >section on repetition above.

Can the library do this? "Generate brace initialization for char array of 
values 0-127 to avoid having to hand write 0,1,2,...,127"

Can the library do this? "Generate function declarations and definitions 
for up to 24 arguments to avoid having to write the 24 functions by hand."

Those are the kind of simple questions for which your introduction seems a 
good start.

--Beman