Re: [boost] [pimpl] No documentation for pointer semantics

Subject: Re: [boost] [pimpl] No documentation for pointer semantics
From: Edward Diener (eldiener_at_[hidden])
Date: 2014-06-05 21:29:38

On 6/5/2014 7:53 PM, Vladimir Batov wrote:
>
> On 06/06/2014 09:27 AM, Edward Diener wrote:
>> The documentation for "Pimpl with Value Semantics" has:
>>
>> "and was deployed in the previous chapter for the Pimpls with pointer
>> semantics..."
>>
>> but there is no previous chapter about Pimpl with pointer semantics.
>> From that point on the documentation of "Pimpl with Value Semantics
>> makes no sense to me and I do not know what is being explained.
>
> Yes, the chapter you are referring to says "/std::shared_ptr/ ... was
> deployed in the previous chapter". The previous chapter is called
> "Getting Started". It says "we would like ... a /Pimpl/-style class with
> the /pointer semantics/. That is:". Then it goes on to explain what
> Pimpl with /pointer semantics /is and how shared_ptr plays a role there.
> Still, I'll try to re-phrase the chapters to clarify. Thank you, Edward.

I think you need to explain what the actual pimpl class template is and 
does before jumping in with examples that use it. I do admit I am a 
person who is nearly incapable of using software based largely on 
examples rather than on actual well-explained concepts and interface 
details.