Boost logo

Boost :

From: David Abrahams (dave_at_[hidden])
Date: 2003-09-29 18:27:28

I posted this earlier under the wrong thread somehow...

"Philippe A. Bouchard" <philippe_at_[hidden]> writes:

> "David Abrahams" <dave_at_[hidden]> wrote in message
> [...]
>> Yes, I had the same experience. I looked, and decided taking the
>> time to explain in detail the ways in which the documentation was
>> inadequate was just going to be too frustrating. Sorry,
> My apologies for the documentation. I didn't cover some areas like missing
> placement operators, etc. because the solutions are based on theoretical
> extensions: page mapping for heap allocations from which you can quickly
> detect the type of the pointee object (placement new used, global allocator,
> garbage collected object, etc.). This would put an end to allocations
> failures (seg faults).
> I am going to rewrite the documentation, but the main idea was at least
> mentionned ;)

Please try to follow the Boost documentation convention of providing
a narrative introduction, examples, an interface synopsis,
requirements, etc. See the mem_fn library docs for a good example.
I don't think Doxygen will do anything like that unless you really
push it ;-)

Dave Abrahams
Boost Consulting

Boost list run by bdawes at, gregod at, cpdaniel at, john at