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:
>> 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
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk