Adopt commit 36e8d8f from master: Merge pull request #920 from ameredit/document_unreliable_sharedptr_apis
Adopt commit 36e8d8f from master: Merge pull request #920 from ameredit/document_unreliable_sharedptr_apis

commit 36e8d8fcc25bf54e8a3f21988194a0d6540009f2
Merge: 7e385b9 2fc30b7
Author: Henry Verschell <hverschell@bloomberg.net>
Date:   Fri Dec 23 15:01:23 2016 -0500

    Merge pull request #920 from ameredit/document_unreliable_sharedptr_apis

    Note for shared_ptr ref-count APIs

commit 2fc30b74ed37db932a9adb1cee84abd3baac2806
Author: Alisdair Meredith <ameredith1@bloomberg.net>
Date:   Thu Dec 15 14:05:28 2016 -0500

    Note for shared_ptr ref-count APIs

    The results of 'use_count' and 'unique' are unreliable in a
    multithreaded program.  This is explicitly acknowledged in
    the pending C++17 standard, and well worth a note in the BDE
    function-level contracts.

apaprocki/bde,che2/bde,dharesign/bde,bloomberg/bde,apaprocki/bde,dharesign/bde,bloomberg/bde,apaprocki/bde,che2/bde,dharesign/bde,bloomberg/bde,che2/bde,apaprocki/bde,bloomberg/bde,bloomberg/bde,che2/bde,dharesign/bde,apaprocki/bde