[Boost-commit] svn:boost r50795 - sandbox/thread_safe_signals/trunk/libs/signals2/doc

Subject: [Boost-commit] svn:boost r50795 - sandbox/thread_safe_signals/trunk/libs/signals2/doc
From: fmhess_at_[hidden]
Date: 2009-01-26 17:04:59

Author: fmhess
Date: 2009-01-26 17:04:59 EST (Mon, 26 Jan 2009)
New Revision: 50795
URL: http://svn.boost.org/trac/boost/changeset/50795

Log:
Added paragraph on non-intrusiveness of new automatic
connection management scheme.

Text files modified: 
   sandbox/thread_safe_signals/trunk/libs/signals2/doc/rationale.xml |     8 ++++++++                                
   1 files changed, 8 insertions(+), 0 deletions(-)

Modified: sandbox/thread_safe_signals/trunk/libs/signals2/doc/rationale.xml
==============================================================================
--- sandbox/thread_safe_signals/trunk/libs/signals2/doc/rationale.xml	(original)
+++ sandbox/thread_safe_signals/trunk/libs/signals2/doc/rationale.xml	2009-01-26 17:04:59 EST (Mon, 26 Jan 2009)
@@ -103,6 +103,14 @@
       all of a slot's tracked objects prior to invoking the slot.  This
       insures none of the tracked objects destruct in mid-invocation.
     </para>
+    <para>The new connection management scheme has the advantage of being
+      non-intrusive.  Objects of any type may be tracked using the
+      <classname>shared_ptr/weak_ptr</classname> scheme.  The old
+      <code><classname>boost::signals::trackable</classname></code>
+      scheme requires the tracked objects to be derived from the <code>trackable</code>
+      base class, which is not always practical when interacting
+      with classes from 3rd party libraries.
+    </para>
   </section>
 
   <section>