Boost logo

Boost :

Subject: Re: [boost] [review] Review of PolyCollection starts today (May 3rd)
From: Edward Diener (eldiener_at_[hidden])
Date: 2017-05-06 03:53:20


On 5/2/2017 7:46 PM, Ion Gaztañaga via Boost wrote:
> Hi everyone,
>
> The formal review of Joaquín M. López Muñoz's PolyCollection library
> starts today.
>
> I'd like to encourage your participation as the proposed library is
> small and focused, and reviewers don't need to be domain experts to
> appreciate the potential usefulness of the library and propose
> improvements.
>
> PolyCollection implements fast containers of polymorphic objects.
> Typically, polymorphic objects cannot be stored directly in regular
> containers and need be accessed through an indirection pointer, which
> introduces performance problems related to CPU caching and branch
> prediction. Boost.PolyCollection implements a novel data structure that
> is able to contiguously store polymorphic objects without such
> indirection, thus providing a value-semantics user interface and better
> performance. Three polymorphic collections are provided:
>
> * boost::base_collection
> * boost::function_collection

I could not understand from the documentation what it is I am supposed
to be inserting into a function_collection. The tutorial did not explain
this to me and the reference's technical explanation on this eluded me.

As usual the tutorial-reference form of documentation befuddles me
whereas a simple explanation of the main topics of a library would
probably make it easy for me to understand a library.

> * boost::any_collection
>
> dealing respectively with classic base/derived or OOP polymorphism,
> function wrapping in the spirit of std::function and so-called duck
> typing as implemented by Boost.TypeErasure.
>
> The library can be found here:
>
> Incubator:
> http://blincubator.com/bi_library/polycollection/?gform_post_id=1643
>
> Github:
> https://github.com/joaquintides/poly_collection
>
> and the documentation here:
>
> http://rawgit.com/joaquintides/poly_collection/website/doc/html/index.html
>
> Please post your comments and review to the boost mailing list
> (preferably), the Boost Library Incubator. or privately to the Review
> Manager (to me ;-). Here are some questions you might want to answer in
> your review:
>
> - What is your evaluation of the design?
>
> - What is your evaluation of the implementation?
>
> - What is your evaluation of the documentation?
>
> - What is your evaluation of the potential usefulness of the library?
>
> - Did you try to use the library? With what compiler? Did you have any
> problems?
>
> - How much effort did you put into your evaluation? A glance? A quick
> reading? In-depth study?
>
> - Are you knowledgeable about the problem domain?
>
> And most importantly:
>
> - Do you think the library should be accepted as a Boost library?
>
> For more information about Boost Formal Review Process, see:
> http://www.boost.org/community/reviews.html
>
> Waiting your reviews!


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