Re: [boost] [Boost.Parameter] questions and advice

From: David Abrahams (dave_at_[hidden])
Date: 2007-07-11 12:20:50

on Wed Jul 11 2007, Andrew Sutton <asutton-AT-cs.kent.edu> wrote:

>> Heh, heh:
>> http://boost.org/libs/parameter/doc/html/index.html#documentation
>>
>> I would proably invent a hypothetical C++ declaration syntax (as
>> though named/deduced paramters were built-in features), document that,
>> and then document the functions in terms of it.
>
> That's why I asked :) I was wondering if there had been any recent  
> developments along those lines. Maybe I'll adopt some kind of python- 
> esque model for documentation. Those guys do a pretty good job  
> getting the point across.

Yeah, well, their documentation also tends to lack crucial detail.
I've seen lots of Python docs that talk about "File-like" objects
without defining what that is precisely.  They don't seem to have
gotten Concepts yet.

So, Python might make a good starting point... just make sure you
don't end there, too ;-)

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com
The Astoria Seminar ==> http://www.astoriaseminar.com