[Boost-commit] svn:boost r86464 - in trunk: boost/asio libs/asio/doc

Subject: [Boost-commit] svn:boost r86464 - in trunk: boost/asio libs/asio/doc
From: chris_at_[hidden]
Date: 2013-10-26 18:39:23

Author: chris_kohlhoff
Date: 2013-10-26 18:39:23 EDT (Sat, 26 Oct 2013)
New Revision: 86464
URL: http://svn.boost.org/trac/boost/changeset/86464

Log:
Add a note to clarify that concurrent invocation is not guaranteed for handlers in different strands.

Text files modified: 
   trunk/boost/asio/strand.hpp       |     3 +++                                     
   trunk/libs/asio/doc/reference.qbk |    10 ++++++++++                              
   2 files changed, 13 insertions(+), 0 deletions(-)

Modified: trunk/boost/asio/strand.hpp
==============================================================================
--- trunk/boost/asio/strand.hpp	Sat Oct 26 18:35:32 2013	(r86463)
+++ trunk/boost/asio/strand.hpp	2013-10-26 18:39:23 EDT (Sat, 26 Oct 2013)	(r86464)
@@ -73,6 +73,9 @@
  * happens-before the other. Therefore none of the above conditions are met and
  * no ordering guarantee is made.
  *
+ * @note The implementation makes no guarantee that handlers posted or
+ * dispatched through different @c strand objects will be invoked concurrently.
+ *
  * @par Thread Safety
  * @e Distinct @e objects: Safe._at_n
  * @e Shared @e objects: Safe.

Modified: trunk/libs/asio/doc/reference.qbk
==============================================================================
--- trunk/libs/asio/doc/reference.qbk	Sat Oct 26 18:35:32 2013	(r86463)
+++ trunk/libs/asio/doc/reference.qbk	2013-10-26 18:39:23 EDT (Sat, 26 Oct 2013)	(r86464)
@@ -61339,6 +61339,11 @@
 the completion of the first async operation will perform `s.dispatch(a)`, and the second will perform `s.dispatch(b)`, but the order in which those are performed is unspecified. That is, you cannot state whether one happens-before the other. Therefore none of the above conditions are met and no ordering guarantee is made.
 
 
+[heading Remarks]
+      
+The implementation makes no guarantee that handlers posted or dispatched through different `strand` objects will be invoked concurrently.
+
+
 [heading Thread Safety]
   
 ['Distinct] ['objects:] Safe.
@@ -93970,6 +93975,11 @@
 the completion of the first async operation will perform `s.dispatch(a)`, and the second will perform `s.dispatch(b)`, but the order in which those are performed is unspecified. That is, you cannot state whether one happens-before the other. Therefore none of the above conditions are met and no ordering guarantee is made.
 
 
+[heading Remarks]
+      
+The implementation makes no guarantee that handlers posted or dispatched through different `strand` objects will be invoked concurrently.
+
+
 [heading Thread Safety]
   
 ['Distinct] ['objects:] Safe.