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
>>> 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",
> 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.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk