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.