Re: [Boost-docs] stl mini-review

Subject: Re: [Boost-docs] stl mini-review
From: Michael Marcin (mmarcin_at_[hidden])
Date: 2007-08-30 19:59:31

Andrew Sutton wrote:
>> Examples are VITAL - without this most peoples reaction is "Huh"?
>>
>> And there needs to be LOTS of examples, and LOTS of comments saying  
>> what the examples show, however obvious it may seem to those who
>> write the C++ Standard ;-)
>>
>> What about examples of user defined types?
>>
>> Perhaps discuss How would you tell if something is default  
>> constructible?  By Test?  By examining code?
> 
> I completely rewrote the DefaultConstructible concept doc this  
> morning - it's taken 3 this morning. Please, re-review that one page:  
> it's here (and it's committed this time).
> 
> http://tinyurl.com/2rb477
> 
> Changes include:
> 	1. Mostly rewriting the entire concept to get rid of the word  
> 'instance' and it derivatives.
> 	2. Added lots of stuff about initialization - it's probably wrong.
> 	3. Examples.
> 
> There are some other changes.
> 
> I do have a concern that the idea of default-initialized, zero- 
> initialized, value-initialized, and uninitialized may dominate the  
> concept more than the notion of default construct-ability. My  
> experience is that algorithms requiring default construction will do  
> so without actual regard for the initial value because they assign  
> values later, and so an in-depth discussion of initialization within  
> this concept may be out of place. My gut feeling is that construction  
> is actually a subtly, different set of concepts than initialization.  
> For example, there are sets of types that are zero-initialized which  
> is possibly disjoint from the set that are default-initialized under  
> some construction syntax. Eh... I don't know. It's all very abstract.
> 
> Again, please re-review that one page... Back to graph docs for me.
> 

Small typo for the Default Constructible concept.

"The folllowing expressions are used in this document:"

should be

"The following expressions are used in this document:"

Nice docs. I hope they get fleshed out.

Thanks,

Michael Marcin