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.