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