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

Subject: Re: [boost] [pimpl] No documentation for pointer semantics
From: Vladimir Batov (Vladimir.Batov_at_[hidden])
Date: 2014-06-05 22:08:15

On 06/06/2014 11:29 AM, Edward Diener wrote:
> 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. 

Thanks, Edward. I'll try to re-do the relevant parts as you suggest. 
Won't do in in a hurry though remembering my experience with "convert", 
right? :-)

> 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.

Aha, I suspect you are over 20y.o., aren't you? :-) Down here I sometime 
deal with uni students (practice placement) -- they expect everything to 
be explained in the Introduction. I kid you not, I had a case when a 
student (well, a young employee) need to lean C++, was given a C++ book 
to read and then he came back saying -- "I read the Intro, I 
more/less(?) understand what it's about. Where do I go from here?" :-) 
Anyway, I'll re-work the docs.