Re: [Boost-users] [range] questions about documentation and usage

Subject: Re: [Boost-users] [range] questions about documentation and usage
From: Robert Ramey (ramey_at_[hidden])
Date: 2012-11-02 14:38:56

Vicente J. Botet Escriba wrote:

>> My concern is very simple:
>>
>> The page
>> http://www.boost.org/doc/libs/1_51_0/libs/range/doc/html/range/concepts/single_pass_range.html
>> is crystal clear.  It says that any SinglePassRange must implement
>> the expression boost::begin(a) where a is a model of a
>> SinglePassRange. This is not actually a requirement on any model of a 
>> SinglePassRange
>> but rather a requirement on boost::begin. But boost::begin is not
>> supplied by the user!  This documentation doesn't tell me what
>> operation the type argument has to support in order to be used as
>> argument to a range. It's just non-sensical and therefore confusing.
>> There is nothing on this page which would indicate to me that
>> something like <vector> would satisify the concept.  The page is
>> does not document a "concept" in the C++ manner.

> I disagree here. The requirement is on the expression boost::begin(a)
> not on how this expression can be provided.

Ahhh - this is the crux of my complaint.  I would be curious to hear
the opinions of some of our well know "concept gurus" on this
page and the question I've raised about it.

Robert Ramey