Range documentation

[deadalnix]

On Sunday, 24 March 2013 at 05:12:49 UTC, Walter Bright wrote:
> On 3/23/2013 8:03 PM, Manu wrote:
>> I'm trying to write some ranges with strictly controlled sets 
>> of features, but
>> the docs on ranges are either very poor, or illusive (I can't 
>> find any).
>>
>> Suggest: Add a category under Language -> Language Reference 
>> about ranges, and
>> all the stuff that defines their use/limitations. With some 
>> examples.
>>
>> I'm just copying from the std libs and hope I catch all the 
>> details.
>
> I agree that the documentation on ranges is lame at best. At 
> worst, it is incomprehensible without looking at the source 
> code. This is unacceptable.

I think the documentation is the reflect of the state of range. 
They have been made in an ad hoc manner, and many part are blurry.

For instance, passing a range by value is unspecified.