Boost logo

Boost :

From: David Abrahams (dave_at_[hidden])
Date: 2004-04-20 20:46:11


"Robert Ramey" <ramey_at_[hidden]> writes:

> There's another point that has me a little bit stumped. Most of the boost
> libraries are code that one invokes with a documented signature. The list
> of invocations, syntax and semantics is what I think Vladimir is referring
> to here with "reference documentation". However, the serialization library
> is more "upside down" in that using it consists almost entirely of filling
> in stubs called by the serialization algorithm. So its not clear to me how
> the "reference documentation" would look compared to the current documents.

That's usually done by describing concept requirements of the
parameters to the serialization algorithm. See
http://www.boost.org/libs/iterator/doc/iterator_facade.html#iterator-facade-requirements
for an example.

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com

Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk