Boost logo

Boost :

Subject: Re: [boost] [Containers Library Review] The review of the Containers library by Ion Gaztanaga starts today
From: Ion Gaztañaga (igaztanaga_at_[hidden])
Date: 2011-08-17 06:02:41


El 17/08/2011 5:12, Edward Diener escribió:

> I think the documentation is good, but it is hard to find overviews of
> the separate containers. They are buried in the reference whereas I
> would like to see them as separate topics in the TOC.

It seems that documentation is the main issue of the review, I hope
tools like autoindex will help me improve this and still maintain
automatic reference documentation.

> For the example in the "Emplace: Placement insertion" topic there is a
> 'non_copy_movable ncm;' in the main function but it is never used, which
> is confusing. I did get the idea of emplacement from the example and
> understand what it is.

Thanks for spotting this.

> There is mention in the Introduction that "Containers support stateful
> allocators" but that appears to be all that is written about that topic.
> I would like to know what that is about.

Ok, this has been already requested, I'll fix it.

> The "Recursive Containers" topic gives a nice example but does not
> explain what a recursive container entails and why a recursive container
> is not guaranteed by the standard. Some further information should be
> given in this topic.

Ok

> For all of the containers which have the same names as the std::
> containers, it should be pointed out what their benefits are. if it is a
> matter of all those containers having move semantics, placement
> insertion, recursive containers, and stateful allocators, that should be
> mentioned. One would like to know why one should use the Containers
> library containers rather than the std:: containers without having to
> read the description of each container.

Ok

Best,

Ion


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