Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r54286 - in sandbox/task/libs/task: . doc doc/html doc/html/boost_task doc/html/images doc/html/images/accumulators doc/html/images/callouts
From: oliver.kowalke_at_[hidden]
Date: 2009-06-23 14:17:00

Next message: oliver.kowalke_at_[hidden]: "[Boost-commit] svn:boost r54287 - sandbox/task/libs/task/examples"
Previous message: john_at_[hidden]: "[Boost-commit] svn:boost r54285 - branches/release/boost/math/special_functions"

Author: olli
Date: 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
New Revision: 54286
URL: http://svn.boost.org/trac/boost/changeset/54286

Log:
*documentation

Added:
   sandbox/task/libs/task/boost.png (contents, props changed)
   sandbox/task/libs/task/doc/html/
   sandbox/task/libs/task/doc/html/boost_task/
   sandbox/task/libs/task/doc/html/boost_task/appendices.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/as_sub_task.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/async.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/handle.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/meta_functions.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/motivation.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/new_thread.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/own_thread.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/pool.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/reference.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/task.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boost_task/utilities.html (contents, props changed)
   sandbox/task/libs/task/doc/html/boostbook.css (contents, props changed)
   sandbox/task/libs/task/doc/html/docutils.css (contents, props changed)
   sandbox/task/libs/task/doc/html/images/
   sandbox/task/libs/task/doc/html/images/accumulators/
   sandbox/task/libs/task/doc/html/images/accumulators/doxygen.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_0.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_1.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_10.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_100.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_11.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_12.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_13.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_14.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_15.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_16.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_17.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_18.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_19.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_2.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_20.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_21.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_22.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_23.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_24.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_25.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_26.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_27.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_28.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_29.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_3.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_30.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_31.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_32.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_33.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_34.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_35.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_36.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_37.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_38.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_39.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_4.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_40.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_41.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_42.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_43.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_44.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_45.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_46.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_47.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_48.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_49.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_5.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_50.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_51.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_52.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_53.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_54.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_55.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_56.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_57.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_58.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_59.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_6.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_60.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_61.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_62.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_63.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_64.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_65.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_66.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_67.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_68.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_69.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_7.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_70.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_71.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_72.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_73.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_74.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_75.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_76.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_77.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_78.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_79.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_8.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_80.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_81.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_82.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_83.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_84.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_85.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_86.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_87.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_88.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_89.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_9.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_90.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_91.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_92.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_93.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_94.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_95.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_96.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_97.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_98.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/accumulators/form_99.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/alert.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/blank.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/
   sandbox/task/libs/task/doc/html/images/callouts/1.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/10.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/11.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/12.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/13.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/14.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/15.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/2.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/3.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/4.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/5.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/6.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/7.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/8.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/callouts/9.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/caution.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/draft.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/home.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/important.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/next.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/next_disabled.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/note.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/prev.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/prev_disabled.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/smiley.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/tip.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/toc-blank.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/toc-minus.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/toc-plus.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/up.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/up_disabled.png (contents, props changed)
   sandbox/task/libs/task/doc/html/images/warning.png (contents, props changed)
   sandbox/task/libs/task/doc/html/index.html (contents, props changed)
   sandbox/task/libs/task/doc/html/minimal.css (contents, props changed)
   sandbox/task/libs/task/doc/html/reference.css (contents, props changed)
Text files modified:
   sandbox/task/libs/task/doc/acknowledgements.qbk | 2
   sandbox/task/libs/task/doc/async.qbk | 2
   sandbox/task/libs/task/doc/boost_task.xml | 2819 +++++++++++++++++++++++++--------------
   sandbox/task/libs/task/doc/fork_join.qbk | 18
   sandbox/task/libs/task/doc/introduction.qbk | 57
   sandbox/task/libs/task/doc/meta_functions.qbk | 8
   sandbox/task/libs/task/doc/new_thread.qbk | 6
   sandbox/task/libs/task/doc/overview.qbk | 34
   sandbox/task/libs/task/doc/pool.qbk | 8
   sandbox/task/libs/task/doc/processor_binding.qbk | 3
   sandbox/task/libs/task/doc/ref_static_pool.qbk | 2
   sandbox/task/libs/task/doc/scheduler.qbk | 31
   sandbox/task/libs/task/doc/shutdown.qbk | 10
   sandbox/task/libs/task/doc/static_pool.qbk | 16
   sandbox/task/libs/task/doc/task.qbk | 42
   15 files changed, 1953 insertions(+), 1105 deletions(-)

Added: sandbox/task/libs/task/boost.png
==============================================================================
Binary file. No diff available.

Modified: sandbox/task/libs/task/doc/acknowledgements.qbk
==============================================================================
--- sandbox/task/libs/task/doc/acknowledgements.qbk (original)
+++ sandbox/task/libs/task/doc/acknowledgements.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -8,7 +8,7 @@

[section:acknowledgements Appendix B: Acknowledgments]

-I'd like to thank Vicente J. Botet Escriba for his contributions (this_task::reschedule_until, this_task::delay, this_task::yield) an comments and Anthony Williams and Braddock Gaskill for their future libraries.
+I'd like to thank Vicente J. Botet Escriba for his comments and contributions (this_task::reschedule_until, this_task::delay, this_task::yield) as well Anthony Williams and Braddock Gaskill for their future libraries.

[endsect]

Modified: sandbox/task/libs/task/doc/async.qbk
==============================================================================
--- sandbox/task/libs/task/doc/async.qbk (original)
+++ sandbox/task/libs/task/doc/async.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -31,7 +31,7 @@

 void main()
 {
- // task -> compute fibonacci(10)
+ // task computing fibonacci(10)
 boost::task< long > t( fibonacci, 10);

 // move the task to executor

Modified: sandbox/task/libs/task/doc/boost_task.xml
==============================================================================
--- sandbox/task/libs/task/doc/boost_task.xml (original)
+++ sandbox/task/libs/task/doc/boost_task.xml 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<library id="boost_task" name="Boost.Task" dirname="boost_task" last-revision="$Date: 2009/06/08 19:40:03 $"
+<library id="boost_task" name="Boost.Task" dirname="boost_task" last-revision="$Date: 2009/06/23 18:15:41 $"
 xmlns:xi="http://www.w3.org/2001/XInclude">
 <libraryinfo>
 <authorgroup>
@@ -26,21 +26,17 @@
 <section id="boost_task.overview">
 <title><link linkend="boost_task.overview"> Overview</link></title>
 <para>
- <emphasis role="bold">Boost.Task</emphasis> provides an framework for parallel
+ <emphasis role="bold">Boost.Task</emphasis> provides a framework for parallel
 execution of tasks (a task is a small unit of code that can be executed independently).
 </para>
 <itemizedlist>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase></code>, <emphasis>callable</emphasis> representing
+ role="identifier">task</phrase></code>, a <emphasis>callable</emphasis> representing
 a fine-grained work-item:
 <itemizedlist>
 <listitem>
- <code><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase></code>
- returning an identifier
- </listitem>
- <listitem>
 <code><phrase role="keyword">operator</phrase><phrase role="special">()()</phrase></code>
 to execute the fine-grained work-item
 </listitem>
@@ -54,19 +50,16 @@
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">handle</phrase></code>, <emphasis>asynchronous-completion-token</emphasis>
- of the asynchronously executed task:
+ role="identifier">handle</phrase></code>, works as a <emphasis>asynchronous-completion-token</emphasis>
+ of executed task:
 <itemizedlist>
 <listitem>
- <code><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase></code>
- for identifying associated task
- </listitem>
- <listitem>
 <code><phrase role="identifier">interrupt</phrase><phrase role="special">()</phrase></code>,
- interrupt_and_wait() allow to cancel an cooperative task
+ <code><phrase role="identifier">interrupt_and_wait</phrase><phrase role="special">()</phrase></code>,
+ ... allow to cancel an cooperative task
 </listitem>
 <listitem>
- interface of <emphasis>asynchronous-completion-token</emphasis>:
+ interface of the <emphasis>asynchronous-completion-token</emphasis>:
 <itemizedlist>
 <listitem>
 <code><phrase role="identifier">get</phrase><phrase role="special">()</phrase></code>
@@ -86,7 +79,8 @@
 </listitem>
 <listitem>
 <code><phrase role="identifier">get_future</phrase><phrase role="special">()</phrase></code>
- returns reference to internal future
+ returns reference to internal <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">shared_future</phrase></code>
 </listitem>
 <listitem>
 functions <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
@@ -103,7 +97,7 @@
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">async</phrase><phrase role="special">()</phrase></code>,
- executes a task on behalf of <emphasis>execution-policies</emphasis> asynchronously
+ executes a task by means of <emphasis>execution-policies</emphasis>
 </listitem>
 <listitem>
 <emphasis>execution-policy</emphasis> models:
@@ -112,36 +106,31 @@
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">own_thread</phrase></code>: executes task in current
- thread.
- </listitem>
- <listitem>
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">new_thread</phrase></code>: executes task in a newly
- created thread (thread will be destroyed after)
+ thread
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">default_pool</phrase></code>: task gets executed by
- a <emphasis>worker-thread</emphasis> of the default <emphasis>thread-pool</emphasis>
+ role="identifier">new_thread</phrase></code>: executes task in a newly-created
+ thread (thread will be destroyed after completion)
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">as_sub_task</phrase></code>: executes task in newly
- created thread or in a pool of <emphasis>worker-threads</emphasis> depending
- on whether current task is already executed in a pool
+ role="identifier">as_sub_task</phrase></code>: executes task in newly-created
+ thread or in a pool of <emphasis>worker-threads</emphasis> depending
+ on whether the parent-task is already executed in a <emphasis>thread-pool</emphasis>
 </listitem>
 <listitem>
- custom pool: task gets executed by a <emphasis>worker-thread</emphasis>
+ <emphasis>thread-pool</emphasis>: task gets executed by a <emphasis>worker-thread</emphasis>
 of a custom <emphasis>thread-pool</emphasis> (for instance with priority
- scheduling)
+ or smart scheduling)
 </listitem>
 </itemizedlist>
 </listitem>
 <listitem>
- <emphasis>thread-pools</emphasis> with work-stealing algorithm
+ <emphasis>thread-pools</emphasis> with work-stealing algorithm and for/join
+ semantics
 </listitem>
 <listitem>
 support of forking and joining sub-tasks
@@ -153,8 +142,8 @@
 no deadlock because of inline-execution of sub-tasks
 </listitem>
 <listitem>
- automatically detects if code runs in a <emphasis>thread-pool</emphasis>
- so the appropriate mechanism for executing the sub-tasks is choosen
+ detects if parent-task runs in a <emphasis>thread-pool</emphasis> - the
+ appropriate mechanism for executing the sub-tasks is choosen
 </listitem>
 </itemizedlist>
 </listitem>
@@ -203,28 +192,43 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
+ <phrase role="comment">// create a thread-pool
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase>
+ <phrase role="special">></phrase>
+ <phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// create two tasks, computing fibonacci numbers
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute tasks in thread-pool
+</phrase> <phrase role="comment">// move tasks ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h1: id == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h2: id == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h1: is ready == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h2: is ready == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">h1</phrase><phrase role="special">,</phrase> <phrase role="identifier">h2</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// wait for completion of both tasks
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">h1</phrase><phrase role="special">,</phrase> <phrase role="identifier">h2</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h1: is ready == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h2: is ready == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h1: has value == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">has_value</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h2: has value == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">has_value</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h1: has exception == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">has_exception</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"h2: has exception == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">has_exception</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+
+ <phrase role="comment">// get results
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(5) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
@@ -267,6 +271,12 @@
 role="bold">Boost.Thread</emphasis></ulink>).
 </para>
 </note>
+ <note>
+ <para>
+ Please note that <emphasis role="bold">Boost.Task</emphasis> is not optimized
+ yet.
+ </para>
+ </note>
 <anchor id="boost_task.overview.tested_platforms"/>
 <bridgehead renderas="sect3">
 <link linkend="boost_task.overview.tested_platforms">Tested Platforms</link>
@@ -286,29 +296,28 @@
 FreeBSD 7.2 (x86), GCC 4.2.1
 </listitem>
 <listitem>
+ OpenSolaris 2009.06 (x86_64), GCC 4.3.2
+ </listitem>
+ <listitem>
 Windows XP Professional (x86), MSVC 9.0
 </listitem>
 </itemizedlist>
- <anchor id="boost_task.overview.how_to_build"/>
+ <anchor id="boost_task.overview.how_to_build_and_install"/>
 <bridgehead renderas="sect3">
- <link linkend="boost_task.overview.how_to_build">How to build</link>
+ <link linkend="boost_task.overview.how_to_build_and_install">How to build and
+ install</link>
 </bridgehead>
 <itemizedlist>
 <listitem>
- download the sources form <ulink url="http://www.boostpro.com/vault/index.php">boost-vault</ulink>
- (section <emphasis>Concurrent Programing</emphasis>) or the latest development
- version from <ulink url="https://svn.boost.org/svn/boost/sandbox/task/">boost-sandbox</ulink>
+ download the sources form <ulink url="http://www.boost-consulting.com/vault/index.php?directory=Concurrent%20Programming">Boost
+ Vault</ulink> or the latest development version from <ulink url="https://svn.boost.org/svn/boost/sandbox/task/">boost-sandbox</ulink>
 </listitem>
 <listitem>
 extract the archive into the boost-source directory
 </listitem>
 <listitem>
- change directory to <boost-source>/libs/task/build
- </listitem>
- <listitem>
- call <code><phrase role="identifier">bjam</phrase> <phrase role="identifier">toolset</phrase><phrase
- role="special">=<</phrase><phrase role="identifier">compiler</phrase><phrase
- role="special">-</phrase><phrase role="identifier">name</phrase><phrase role="special">></phrase></code>
+ call <emphasis>'bjam toolset=<compiler-name> --with-task install'</emphasis>
+ in order to build and install <emphasis role="bold">Boost.Task</emphasis>
 </listitem>
 </itemizedlist>
 </section>
@@ -353,19 +362,22 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="comment">// dispatchs task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// task, to be executed asynchronously
-</phrase> <phrase role="identifier">print</phrase><phrase role="special">,</phrase>
- <phrase role="string">"Hello World!"</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// task, to be executed asynchronously
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">print</phrase><phrase role="special">,</phrase> <phrase role="string">"Hello World!"</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task in newly-created thread
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 <para>
 In order to manage the task <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">async</phrase><phrase role="special">()</phrase></code> returns
- a handle <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase></code>
 (associated with the submitted task). It functions as a <emphasis>asynchronous-completion-token</emphasis>
 - that means it transfers the result of the execution back to the caller thread.
@@ -377,14 +389,19 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// get handle associated with the task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// task, to be executed asynchronously
-</phrase> <phrase role="identifier">echo</phrase><phrase role="special">,</phrase>
- <phrase role="string">"Hello World!"</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// wait until task is finished and return the result
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// task returning the submitted string
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">echo</phrase><phrase role="special">,</phrase> <phrase role="string">"Hello World!"</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task in newly-created thread
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// wait until task has finished and return the result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 <para>
@@ -400,28 +417,35 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// get handle associated with the task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// long runing task, to be executed asynchronously
-</phrase> <phrase role="identifier">long_running</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">millisec</phrase><phrase role="special">(</phrase> <phrase role="number">500</phrase><phrase role="special">)</phrase> <phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">interrupt</phrase><phrase role="special">();</phrase> <phrase role="comment">// interrupt execution of task
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// wait until task is finished, will throw an exeception
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// create a long runing task
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">long_running</phrase><phrase role="special">,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">millisec</phrase><phrase role="special">(</phrase> <phrase role="number">500</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task in newly-created thread
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// requests interruption of task
+</phrase> <phrase role="comment">// returns immediately
+</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">interrupt</phrase><phrase role="special">();</phrase>
+
+ <phrase role="comment">// access the result
+</phrase> <phrase role="comment">// task_interrupted exeception will be thrown
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 <para>
 Beside <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase></code>
- (which creates a new task for each submitted task) <emphasis role="bold">Boost.Task</emphasis>
- provides <link linkend="boost_task.pool"><emphasis>thread-pools</emphasis></link>
- to prevent the overhead of thread creation and destruction for each task.
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase></code>
- submitts the tasks to the default <emphasis>thread-pool</emphasis> which contains
- a fixed number of pre-spawned <emphasis>worker-threads</emphasis> (custom
- <emphasis>thread-pools</emphasis> are supported too).
+ (which creates a new task for each submitted task - the thread will be joined
+ by <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase></code>)
+ <emphasis role="bold">Boost.Task</emphasis> provides <link linkend="boost_task.pool"><emphasis>thread-pools</emphasis></link>
+ to prevent the overhead of thread creation and destruction of threads for each
+ task (<emphasis>thread-pools</emphasis> can be customized).
 </para>
 <para>

@@ -436,21 +460,26 @@
 <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special"><</phrase> <phrase role="identifier">cutof</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="identifier">serial_fib</phrase><phrase role="special">(</phrase> <phrase role="identifier">n</phrase><phrase role="special">);</phrase>
 <phrase role="keyword">else</phrase>
 <phrase role="special">{</phrase>
- <phrase role="comment">// fork a sub-task calculating fibonacci(n-1)
-</phrase> <phrase role="identifier">h1</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">1</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">cutof</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_task</phrase><phrase role="special">::</phrase><phrase role="identifier">get_pool</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
-
- <phrase role="comment">// fork a sub-task calculating fibonacci(n-2)
-</phrase> <phrase role="identifier">h2</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">2</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">cutof</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_task</phrase><phrase role="special">::</phrase><phrase role="identifier">get_pool</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
+ <phrase role="comment">// create a sub-task calculating fibonacci(n-1)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">1</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">cutof</phrase><phrase role="special">);</phrase>
+ <phrase role="comment">// create a sub-task calculating fibonacci(n-2)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">2</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">cutof</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// fork two sub-tasks
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_task</phrase><phrase role="special">::</phrase><phrase role="identifier">get_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_task</phrase><phrase role="special">::</phrase><phrase role="identifier">get_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>

 <phrase role="comment">// join the results of both sub-tasks
</phrase> <phrase role="keyword">return</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special">+</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">();</phrase>
@@ -459,14 +488,28 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// handle for fibonacci calculation
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// calculate fibonacci number 10
-</phrase> <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase> <phrase role="comment">// for numbers < 5 do inline recursive calculation
-</phrase> <phrase role="number">10</phrase><phrase role="special">,</phrase>
- <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// access the default thread-pool
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+ <phrase role="comment">// create a thread-pool with five worker-threads
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase>
+ <phrase role="special">></phrase>
+ <phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// create task computing fibonacci-number for 10
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="number">10</phrase><phrase role="special">,</phrase>
+ <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task in a thread-pool
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// access the result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
 </para>
@@ -485,13 +528,18 @@
 </para>
 <para>

-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// the thread-pool depending upon the parent
-</phrase> <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase> <phrase role="comment">// task is executed inside a thread-pool or not
-</phrase> <phrase role="number">10</phrase><phrase role="special">,</phrase>
- <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">as_sub_task</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// sub-task executed in a new thread or inside
-</phrase></programlisting>
+<programlisting><phrase role="comment">// create a long runing task
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="number">10</phrase><phrase role="special">,</phrase>
+ <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
+<phrase role="comment">// move task ownership to executor
+</phrase><phrase role="comment">// sub-task executed in a new thread or inside the thread-pool
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">as_sub_task</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
+</programlisting>
 </para>
 </section>
 <section id="boost_task.task">
@@ -508,75 +556,9 @@
 role="identifier">get_future</phrase><phrase role="special">()</phrase></code>
 returns a <emphasis>asynchronous-completion-token</emphasis> allowing to wait
 for the completion of the computation of the task, for getting the result of
- a computation or for transfering exceptions. Each <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase></code> has a unique identifier.
- </para>
- <anchor id="boost_task.task.creation"/>
- <bridgehead renderas="sect3">
- <link linkend="boost_task.task.creation">Creation</link>
- </bridgehead>
- <para>
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase
- role="special">()</phrase></code> can be used to create <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase></code> by passing free-functions or member-functions
- of objects and its arguments: <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">make_task</phrase><phrase role="special">()</phrase></code>
- accepts up to ten arguments per default (can be overriden by defining BOOST_TASK_MAKE_TASK_MAX_ARITY
- with the new value).
- </para>
- <itemizedlist>
- <listitem>
- create task from free-function with arguments:
- </listitem>
- </itemizedlist>
- <para>
-
-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-</programlisting>
- </para>
- <itemizedlist>
- <listitem>
- create task from member-function with arguments:
- </listitem>
- </itemizedlist>
- <para>
-
-<programlisting><phrase role="keyword">struct</phrase> <phrase role="identifier">X</phrase>
-<phrase role="special">{</phrase>
- <phrase role="keyword">void</phrase> <phrase role="identifier">f</phrase><phrase role="special">(</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">i</phrase><phrase role="special">);</phrase>
-<phrase role="special">};</phrase>
-
-<phrase role="identifier">X</phrase> <phrase role="identifier">x</phrase><phrase role="special">;</phrase>
-<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="special">&</phrase> <phrase role="identifier">X</phrase><phrase role="special">::</phrase><phrase role="identifier">f</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">x</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-</programlisting>
- </para>
- <para>
- It is possible to create <code><phrase role="identifier">boost</phrase><phrase
+ a computation or for transfering exceptions. <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase></code> from a <emphasis>callable</emphasis>
- too:
- </para>
- <para>
-
-<programlisting><phrase role="keyword">struct</phrase> <phrase role="identifier">Y</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="keyword">operator</phrase><phrase role="special">()();</phrase>
-<phrase role="special">};</phrase>
-
-<phrase role="identifier">Y</phrase> <phrase role="identifier">y</phrase><phrase role="special">;</phrase>
-<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">y</phrase><phrase role="special">);</phrase>
-</programlisting>
+ role="identifier">task</phrase></code> supports move semantics (moving ownership).
 </para>
 <anchor id="boost_task.task.cooperative_task_and_interruption"/>
 <bridgehead renderas="sect3">
@@ -658,36 +640,49 @@

<programlisting><phrase role="keyword">long</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">(</phrase> <phrase role="keyword">long</phrase> <phrase role="identifier">n</phrase><phrase role="special">)</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_thread</phrase><phrase role="special">::</phrase><phrase role="identifier">interruption_point</phrase><phrase role="special">();</phrase> <phrase role="comment">// interruption point
-</phrase>
+ <phrase role="comment">// interruption point
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_thread</phrase><phrase role="special">::</phrase><phrase role="identifier">interruption_point</phrase><phrase role="special">();</phrase>
+
 <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special">==</phrase> <phrase role="number">0</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
 <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special">==</phrase> <phrase role="number">1</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="number">1</phrase><phrase role="special">;</phrase>
 <phrase role="keyword">long</phrase> <phrase role="identifier">k1</phrase><phrase role="special">(</phrase> <phrase role="number">1</phrase><phrase role="special">),</phrase> <phrase role="identifier">k2</phrase><phrase role="special">(</phrase> <phrase role="number">0</phrase><phrase role="special">);</phrase>
 <phrase role="keyword">for</phrase> <phrase role="special">(</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">i</phrase><phrase role="special">(</phrase> <phrase role="number">2</phrase><phrase role="special">);</phrase> <phrase role="identifier">i</phrase> <phrase role="special"><=</phrase> <phrase role="identifier">n</phrase><phrase role="special">;</phrase> <phrase role="special">++</phrase><phrase role="identifier">i</phrase><phrase role="special">)</phrase>
 <phrase role="special">{</phrase>
- <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_thread</phrase><phrase role="special">::</phrase><phrase role="identifier">interruption_requested</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="comment">// check if interruption was requested
-</phrase> <phrase role="keyword">return</phrase><phrase role="special">;</phrase>
+ <phrase role="comment">// check if interruption was requested
+</phrase> <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_thread</phrase><phrase role="special">::</phrase><phrase role="identifier">interruption_requested</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase>
+ <phrase role="keyword">return</phrase><phrase role="special">;</phrase>

 <phrase role="keyword">long</phrase> <phrase role="identifier">tmp</phrase><phrase role="special">(</phrase> <phrase role="identifier">k1</phrase><phrase role="special">);</phrase>
 <phrase role="identifier">k1</phrase> <phrase role="special">=</phrase> <phrase role="identifier">k1</phrase> <phrase role="special">+</phrase> <phrase role="identifier">k2</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">k2</phrase> <phrase role="special">=</phrase> <phrase role="identifier">tmp</phrase><phrase role="special">;</phrase>
 <phrase role="special">}</phrase>

- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_thread</phrase><phrase role="special">::</phrase><phrase role="identifier">interruption_point</phrase><phrase role="special">();</phrase> <phrase role="comment">// interruption point
-</phrase>
+ <phrase role="comment">// interruption point
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">this_thread</phrase><phrase role="special">::</phrase><phrase role="identifier">interruption_point</phrase><phrase role="special">();</phrase>
+
 <phrase role="keyword">return</phrase> <phrase role="identifier">k1</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// get handle associated with the task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// task, to be executed asynchronously
-</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// throws boost::task::task_interrupted
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// task for computing fibonacci-number
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task in new thread
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// interrupt task an wait until
+</phrase> <phrase role="comment">// the task is removed by the worker-thread
+</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">interrupt_and_wait</phrase><phrase role="special">();</phrase>
+
+ <phrase role="comment">// access the result
+</phrase> <phrase role="comment">// throws boost::task::task_interrupted
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 <anchor id="boost_task.task.exceptions"/>
@@ -710,13 +705,20 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// get handle associated with the task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// task, to be executed asynchronously
-</phrase> <phrase role="identifier">throwing</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">wait</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// throws std::domain_error
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// create task throwing std::domain_error
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">throwing</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task asynchron
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// wait for task completion
+</phrase> <phrase role="comment">// throws std::domain_error
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">wait</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 <para>
@@ -782,15 +784,15 @@
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">future_already_set</phrase></code>
+ role="identifier">exception</phrase></code>
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">future_cancel</phrase></code>
+ role="identifier">future_already_set</phrase></code>
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">exception</phrase></code>
+ role="identifier">future_cancel</phrase></code>
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
@@ -802,12 +804,36 @@
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">broken_task</phrase></code>
+ </listitem>
+ <listitem>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
+ </listitem>
+ <listitem>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_already_executed</phrase></code>
+ </listitem>
+ <listitem>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>
+ </listitem>
+ <listitem>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_moved</phrase></code>
+ </listitem>
+ <listitem>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task_interrupted</phrase></code>
 </listitem>
 <listitem>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">broken_task</phrase></code>
+ role="identifier">task_task_rejected</phrase></code>
+ </listitem>
+ <listitem>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_unitialized</phrase></code>
 </listitem>
 </itemizedlist>
 <anchor id="boost_task.task.parent_task"/>
@@ -838,35 +864,56 @@
 <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special"><</phrase> <phrase role="identifier">cutof</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="identifier">serial_fib</phrase><phrase role="special">(</phrase> <phrase role="identifier">n</phrase><phrase role="special">);</phrase>
 <phrase role="keyword">else</phrase>
 <phrase role="special">{</phrase>
- <phrase role="comment">// submit a sub-task to pool calculating fibonacci(n-1)
-</phrase> <phrase role="identifier">h1</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">1</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">cutof</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
- <phrase role="comment">// submit a sub-task to pool calculating fibonacci(n-2)
-</phrase> <phrase role="identifier">h2</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">2</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">cutof</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="comment">// sub-task for computing fibonacci(n-1)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">1</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">cutof</phrase><phrase role="special">);</phrase>
+ <phrase role="comment">// sub-task for computing fibonacci(n-2)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">2</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">cutof</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// submit a sub-tasks to thread-pool
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>

- <phrase role="comment">// calculate fibonacci(n) from the results of both sub-tasks
+ <phrase role="comment">// computing fibonacci(n) by
+</phrase> <phrase role="comment">// joining results of both sub-tasks
</phrase> <phrase role="keyword">return</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special">+</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">();</phrase>
 <phrase role="special">}</phrase>
<phrase role="special">}</phrase>

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// handle for fibonacci calculation
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// calculate fibonacci number 10
-</phrase> <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase> <phrase role="comment">// for numbers < 5 do inline recursive calculation
-</phrase> <phrase role="number">10</phrase><phrase role="special">,</phrase>
- <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// access the default thread-pool
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+ <phrase role="comment">// create thread-pool with five worker-threads
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase>
+ <phrase role="special">></phrase>
+ <phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// create task computing fibonacci-number for 10
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="number">10</phrase><phrase role="special">,</phrase>
+ <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// execute task asynchron in thread-pool
+</phrase> <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// access result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
 </para>
@@ -910,10 +957,6 @@
 </para>
 <itemizedlist>
 <listitem>
- <code><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase></code>:
- return id of the associated <emphasis>task-id</emphasis>
- </listitem>
- <listitem>
 <code><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase></code>:
 test if result is set
 </listitem>
@@ -960,18 +1003,25 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="comment">// create task
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// move task ownership to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"id == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"is ready == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">wait</phrase><phrase role="special">();</phrase>
+
+ <phrase role="comment">// wait for task completion
+</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">wait</phrase><phrase role="special">();</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"has value == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">has_value</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"has exception == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">has_exception</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+
+ <phrase role="comment">// return result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
 </para>
@@ -1067,25 +1117,33 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// get handle associated with the task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// task, to be executed asynchronously
-</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// asynchronous executor
+ <phrase role="comment">// task, to be executed asynchronously
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// move task to async. executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// interrupt task and wait until task is removed by worker-thread
</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">interrupt_and_wait</phrase><phrase role="special">();</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"id == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"is ready == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"has value == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">has_value</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"has exception == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">has_exception</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// throws boost::task::task_interrupted
-</phrase><phrase role="special">}</phrase>
+
+ <phrase role="comment">// access result
+</phrase> <phrase role="comment">// throws boost::task::task_interrupted
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 <note>
 <para>
- If the task is still pending when an interruption is requested - the task
- is not removed from the queue, it is marked to be interrupted instead.
+ If the task is still pending (not executed yet) when an interruption is requested
+ - the task is not removed from the queue, it is marked to be interrupted
+ instead.
 </para>
 </note>
 <anchor id="boost_task.handle.waiting_for_handles"/>
@@ -1107,11 +1165,13 @@
 <phrase role="identifier">results</phrase><phrase role="special">.</phrase><phrase role="identifier">reserve</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>

 <phrase role="keyword">for</phrase> <phrase role="special">(</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">i</phrase> <phrase role="special">=</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase> <phrase role="identifier">i</phrase> <phrase role="special"><</phrase> <phrase role="number">10</phrase><phrase role="special">;</phrase> <phrase role="special">++</phrase><phrase role="identifier">i</phrase><phrase role="special">)</phrase>
+ <phrase role="special">{</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="identifier">i</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">results</phrase><phrase role="special">.</phrase><phrase role="identifier">push_back</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="special">}</phrase>

 <phrase role="comment">// wait until all tasks are ready
</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">results</phrase><phrase role="special">.</phrase><phrase role="identifier">begin</phrase><phrase role="special">(),</phrase> <phrase role="identifier">results</phrase><phrase role="special">.</phrase><phrase role="identifier">end</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
@@ -1136,23 +1196,19 @@

<programlisting><phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase> <phrase role="number">7</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t3</phrase><phrase role="special">(</phrase> <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase>
- <phrase role="number">7</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h3</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">cooperative</phrase><phrase role="special">,</phrase>
- <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t3</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>

 <phrase role="comment">// wait for any task becomes ready
</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">h1</phrase><phrase role="special">,</phrase> <phrase role="identifier">h2</phrase><phrase role="special">,</phrase> <phrase role="identifier">h3</phrase><phrase role="special">);</phrase>
@@ -1170,9 +1226,9 @@
 <section id="boost_task.async">
 <title><link linkend="boost_task.async"> Asynchronous execution</link></title>
 <para>
- The function <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ Function <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase
- role="special">()</phrase></code> passes the <code><phrase role="identifier">boost</phrase><phrase
+ role="special">()</phrase></code> applies the moved <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase></code> to the <emphasis>execution-policy</emphasis>
 which executes the <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
@@ -1183,20 +1239,21 @@
 <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase>
 <phrase role="identifier">task</phrase><phrase role="special"><</phrase>
 <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">tsk</phrase><phrase role="special">)</phrase></code>).
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase
- role="special">()</phrase></code> accepts two arguments - the first is an
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase></code>
- object and the second an <emphasis>execution-policy</emphasis>. For the second
- argument <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">as_sub_task</phrase></code>
- is used per default. The function returns a <code><phrase role="identifier">boost</phrase><phrase
+ <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase
+ role="special">)</phrase></code>). <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">handle</phrase></code> which controls the submitted <code><phrase
- role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase></code>.
+ role="identifier">async</phrase><phrase role="special">()</phrase></code> accepts
+ two arguments - the first is an <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase></code> object and the second an <emphasis>execution-policy</emphasis>.
+ For the second argument <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">as_sub_task</phrase></code> is used per default. The function
+ returns a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase></code>
+ which controls the submitted <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase></code>.
 </para>
 <para>

@@ -1216,14 +1273,17 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// get handle associated with the task
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// compute fibonacci(10) asynchron
-</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"id == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// throws boost::task::task_interrupted
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// task computing fibonacci(10)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// move the task to executor
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// access the result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 </section>
@@ -1254,12 +1314,13 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">own_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
@@ -1276,8 +1337,7 @@
 should be addressed). The returned <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">handle</phrase></code> joins the thread in its destructor
- (if the last reference gets out of scope) and thus provides one possible solution
- of <ulink url="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2880.html">N2880</ulink>.
+ (if the last reference gets out of scope) .
 </para>
 <para>

@@ -1297,12 +1357,13 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
@@ -1319,19 +1380,26 @@
 <para>
 In the example below both <code><phrase role="identifier">a_function</phrase><phrase
 role="special">()</phrase></code> and <code><phrase role="identifier">another_function</phrase><phrase
- role="special">()</phrase></code> are executed synchron (see <link linkend="boost_task.own_thread"><code><phrase
- role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase
- role="special">::</phrase><phrase role="identifier">own_thread</phrase></code></link>
- for synchronous execution)!
+ role="special">()</phrase></code> are executed synchron because the returned
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase></code>
+ is not stored in a variable. Thatswhy the <emphasis>worker-thread</emphasis>
+ is joined after return from <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">async</phrase><phrase role="special">()</phrase></code>!
 </para>
 <para>

-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">a_function</phrase><phrase role="special">),</phrase>
+<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase> <phrase role="identifier">a_function</phrase><phrase role="special">);</phrase>
+<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase> <phrase role="identifier">another_function</phrase><phrase role="special">);</phrase>
+
+<phrase role="comment">// handles are not retrieved
+</phrase><phrase role="comment">// both task executed in sequence
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">another_function</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">new_thread</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
</programlisting>
 </para>
@@ -1355,11 +1423,7 @@
 role="identifier">async</phrase><phrase role="special">()</phrase></code> with
 support of executing an <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase></code> in <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">default_pool</phrase></code> (using <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">default_pool</phrase><phrase role="special">()</phrase></code>):
+ role="identifier">task</phrase></code> in <emphasis>thread-pool</emphasis>:
 </para>
 <para>

@@ -1368,42 +1432,28 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">echo</phrase><phrase role="special">,</phrase>
- <phrase role="string">"Hello World!"</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- <para>
- and a custom <emphasis>thread-pool</emphasis> (passing pool instance as an
- argument to <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase
- role="special">()</phrase></code>):
- </para>
- <para>
-
-<programlisting><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="identifier">echo</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">msg</phrase><phrase role="special">)</phrase>
-<phrase role="special">{</phrase> <phrase role="keyword">return</phrase> <phrase role="identifier">msg</phrase><phrase role="special">;</phrase> <phrase role="special">}</phrase>
+ <phrase role="comment">// create a thread-pool with
+</phrase> <phrase role="comment">// five worker-threads
+</phrase> <phrase role="comment">// FIFO schduling of queued tasks
+</phrase> <phrase role="comment">// and unlimited size of internal queue
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase>
+ <phrase role="special">></phrase>
+ <phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>

-<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase>
- <phrase role="special">></phrase>
-<phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="comment">// create task
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">echo</phrase><phrase role="special">,</phrase> <phrase role="string">"Hello World!"</phrase><phrase role="special">);</phrase>

-<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="comment">// move task to executor
+</phrase> <phrase role="comment">// let the task be executed by the thread-pool
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">echo</phrase><phrase role="special">,</phrase>
- <phrase role="string">"Hello World!"</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+
+ <phrase role="comment">// access the result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
 </para>
@@ -1427,18 +1477,21 @@
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase
 role="special">::</phrase><phrase role="identifier">static_pool</phrase></code>
 - which contains an fixed set of pre-forked <emphasis>worker-threads</emphasis>
- (the size of the pool doesn't change during its lifetime).
+ (the size of the pool doesn't change during its lifetime). <code><phrase
+ role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">static_pool</phrase></code> supports move semantics.
 </para>
 <para>

-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">_static_pool</phrase><phrase role="special"><</phrase> <phrase role="comment">// pool type
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase> <phrase role="comment">// queuing policy (unbounded_channel, bounded_channel)
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase> <phrase role="comment">// scheduling policy (fifo, priority, smart)
-</phrase> <phrase role="special">></phrase>
+<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">_static_pool</phrase><phrase role="special"><</phrase> <phrase role="comment">// pool type
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase> <phrase role="comment">// queuing policy (unbounded_channel, bounded_channel)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase> <phrase role="comment">// scheduling policy (fifo, priority, smart)
+</phrase> <phrase role="special">></phrase>
<phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">6</phrase><phrase role="special">),</phrase> <phrase role="comment">// pool with 6 pre-forked worker-threads
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">50</phrase><phrase role="special">),</phrase> <phrase role="comment">// time to sleep if no work-item available
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// iterations over local-queues before sleep
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">6</phrase><phrase role="special">),</phrase> <phrase role="comment">// pool with 6 pre-forked worker-threads
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">50</phrase><phrase role="special">),</phrase> <phrase role="comment">// time to sleep if no work-item available
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// iterations over local-queues before sleep
</phrase></programlisting>
 </para>
 <para>
@@ -1468,16 +1521,16 @@
 role="identifier">size</phrase><phrase role="special">()</phrase></code>.
 </para>
 <para>
- For infomational pruposes <code><phrase role="identifier">empty</phrase><phrase
+ For informational pruposes <code><phrase role="identifier">empty</phrase><phrase
 role="special">()</phrase></code> and <code><phrase role="identifier">pending</phrase><phrase
- role="special">()()</phrase></code> can be used in order to know if the global
+ role="special">()</phrase></code> can be used in order to know if the global
 task-queue is empty or how many tasks are waiting for execution. With <code><phrase
 role="identifier">clear</phrase><phrase role="special">()</phrase></code>
 all tasks are removed from the global-queue.
 </para>
 <note>
 <para>
- <code><phrase role="identifier">pending</phrase><phrase role="special">()()</phrase></code>
+ <code><phrase role="identifier">pending</phrase><phrase role="special">()</phrase></code>
 does not count tasks in the local-queues of the <emphasis>worker-threads</emphasis>.
 </para>
 </note>
@@ -1568,21 +1621,29 @@
 </para>
 <para>

-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase> <phrase role="comment">// allow unlimited tasks to be queue in global-queue
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">priority</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="special">></phrase> <phrase role="comment">// tasks with lower priority are scheduled first
-</phrase><phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+<programlisting><phrase role="comment">// thread-pool with priority scheduling
+</phrase><phrase role="comment">// tasks with higher priority are
+</phrase><phrase role="comment">// scheduled first
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">priority</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="special">></phrase>
+<phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>

-<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">some_fn</phrase><phrase role="special">),</phrase> <phrase role="comment">// task to be executed
-</phrase> <phrase role="number">5</phrase><phrase role="special">,</phrase> <phrase role="comment">// priority is 5
-</phrase> <phrase role="identifier">pool</phrase><phrase role="special">);</phrase> <phrase role="comment">// thread-pool
-</phrase>
-<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">another_fn</phrase><phrase role="special">),</phrase> <phrase role="comment">// task to be executed
-</phrase> <phrase role="number">3</phrase><phrase role="special">,</phrase> <phrase role="comment">// priority is 3
-</phrase> <phrase role="identifier">pool</phrase><phrase role="special">);</phrase> <phrase role="comment">// thread-pool
-</phrase></programlisting>
+<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase> <phrase role="identifier">some_fn</phrase><phrase role="special">);</phrase>
+<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">void</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase> <phrase role="identifier">another_fn</phrase><phrase role="special">);</phrase>
+
+<phrase role="comment">// move task t1 with priority 5 to thread-pool
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
+ <phrase role="number">5</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
+
+<phrase role="comment">// move task t2 with priority 3 to thread-pool
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
+ <phrase role="number">3</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
+</programlisting>
 </para>
 <para>
 In this example the tasks get scheduled by the assigned integer (third argument
@@ -1597,15 +1658,18 @@
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase
 role="special">::</phrase><phrase role="identifier">priority</phrase></code>
 (the default is <code><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase
- role="identifier">less</phrase><phrase role="special"><</phrase> <phrase
+ role="identifier">greater</phrase><phrase role="special"><</phrase> <phrase
 role="identifier">Attr</phrase> <phrase role="special">></phrase></code>).
 </para>
 <para>

-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+<programlisting><phrase role="comment">// thread-pool with priority scheduling
+</phrase><phrase role="comment">// tasks with lower priority are
+</phrase><phrase role="comment">// scheduled first
+</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">priority</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase><phrase role="special">,</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">greater</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="special">></phrase> <phrase role="special">></phrase> <phrase role="comment">// tasks with higher priority are scheduled first
-</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">priority</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase><phrase role="special">,</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">less</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="special">></phrase>
+ <phrase role="special">></phrase>
<phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
</programlisting>
 </para>
@@ -1663,19 +1727,23 @@

 <phrase role="special">...</phrase>

+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">bind</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">bind</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
 <phrase role="comment">// replaced by later task with same attribute == 2
</phrase> <phrase role="comment">// if still pending in pool
</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="number">2</phrase><phrase role="special">,</phrase> <phrase role="comment">// attribute is 2
-</phrase> <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
+ <phrase role="number">2</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>

 <phrase role="comment">// will replace previous pending task with attribute == 2
</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="number">2</phrase><phrase role="special">,</phrase> <phrase role="comment">// attribute is 2 too
-</phrase> <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
+ <phrase role="number">2</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">);</phrase>
<phrase role="special">}</phrase>
</programlisting>
 </para>
@@ -1730,17 +1798,20 @@

 <phrase role="special">...</phrase>

+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">.</phrase><phrase role="identifier">shutdown</phrase><phrase role="special">();</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// waits until all pending tasks are finished
+</phrase> <phrase role="identifier">pool</phrase><phrase role="special">.</phrase><phrase role="identifier">shutdown</phrase><phrase role="special">();</phrase>

 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
 <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(5) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
@@ -1791,110 +1862,60 @@

 <phrase role="special">...</phrase>

+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy
-</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special">.</phrase><phrase role="identifier">shutdown_now</phrase><phrase role="special">();</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// requests task interruption and
+</phrase> <phrase role="comment">// joins all worker-threads
+</phrase> <phrase role="identifier">pool</phrase><phrase role="special">.</phrase><phrase role="identifier">shutdown_now</phrase><phrase role="special">();</phrase>

- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase> <phrase role="comment">// may throw broken_task or task_interrupted
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(5) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase> <phrase role="comment">// may throw broken_task or task_interrupted
-</phrase><phrase role="special">}</phrase>
+ <phrase role="comment">// accessing the result may throw task_interrupted
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(5) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="special">}</phrase>
</programlisting>
 </para>
 </section>
- <section id="boost_task.pool.default_pool">
- <title><link linkend="boost_task.pool.default_pool"> Default pool</link></title>
+ <section id="boost_task.pool.processor_binding">
+ <title><link linkend="boost_task.pool.processor_binding"> Processor binding</link></title>
 <para>
- The library provides a default-pool accessible via <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase
- role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase
- role="special">()</phrase></code>. The function returns a reference to <code><phrase
- role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">static_pool</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">fifo</phrase> <phrase role="special">></phrase> <phrase
- role="special">></phrase></code>. The static instance of <code><phrase
+ For some applications it is convenient to bind the <emphasis>worker-threads</emphasis>
+ to processors/cores of the system. For this purpose <code><phrase role="identifier">bind_to_processors</phrase><phrase
+ role="special">()</phrase></code> must be given to constructor instead <code><phrase
 role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">default_pool</phrase></code> contains as many <emphasis>worker-threads</emphasis>
- as <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">thread</phrase><phrase role="special">::</phrase><phrase
- role="identifier">hardware_concurrency</phrase><phrase role="special">()</phrase></code>
- returns, queues unlimited amount of tasks and schedules the tasks in FIFO-order.
+ role="identifier">poolsize</phrase></code> so that a <emphasis>worker-thread</emphasis>
+ is created an bound the the core.
 </para>
 <para>

-<programlisting><phrase role="keyword">long</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">(</phrase> <phrase role="keyword">long</phrase> <phrase role="identifier">n</phrase><phrase role="special">)</phrase>
-<phrase role="special">{</phrase>
- <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special">==</phrase> <phrase role="number">0</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special">==</phrase> <phrase role="number">1</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="number">1</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">long</phrase> <phrase role="identifier">k1</phrase><phrase role="special">(</phrase> <phrase role="number">1</phrase><phrase role="special">),</phrase> <phrase role="identifier">k2</phrase><phrase role="special">(</phrase> <phrase role="number">0</phrase><phrase role="special">);</phrase>
- <phrase role="keyword">for</phrase> <phrase role="special">(</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">i</phrase><phrase role="special">(</phrase> <phrase role="number">2</phrase><phrase role="special">);</phrase> <phrase role="identifier">i</phrase> <phrase role="special"><=</phrase> <phrase role="identifier">n</phrase><phrase role="special">;</phrase> <phrase role="special">++</phrase><phrase role="identifier">i</phrase><phrase role="special">)</phrase>
- <phrase role="special">{</phrase>
- <phrase role="keyword">long</phrase> <phrase role="identifier">tmp</phrase><phrase role="special">(</phrase> <phrase role="identifier">k1</phrase><phrase role="special">);</phrase>
- <phrase role="identifier">k1</phrase> <phrase role="special">=</phrase> <phrase role="identifier">k1</phrase> <phrase role="special">+</phrase> <phrase role="identifier">k2</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">k2</phrase> <phrase role="special">=</phrase> <phrase role="identifier">tmp</phrase><phrase role="special">;</phrase>
- <phrase role="special">}</phrase>
- <phrase role="keyword">return</phrase> <phrase role="identifier">k1</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-
-<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"worker-threads running in default-pool == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">().</phrase><phrase role="identifier">size</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
+<programlisting><phrase role="keyword">typedef</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase> <phrase role="special">></phrase>
+<phrase role="special">></phrase> <phrase role="identifier">pool_type</phrase><phrase role="special">;</phrase>

- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h1</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy == default-pool
-</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h2</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci_fn</phrase><phrase role="special">,</phrase> <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// execution-policy == default-pool
-</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h1</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(5) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h2</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
+<phrase role="comment">// constructs thread-pool with worker-threads as
+</phrase><phrase role="comment">// CPUs/Cores are available on the system
+</phrase><phrase role="identifier">pool_type</phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">pool_type</phrase><phrase role="special">::</phrase><phrase role="identifier">bind_to_processors</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
</programlisting>
 </para>
- </section>
- <section id="boost_task.pool.processor_binding">
- <title><link linkend="boost_task.pool.processor_binding"> Processor binding</link></title>
- <para>
- For some applications it is convenient to bind the <emphasis>worker-threads</emphasis>
- to processors/cores of the system. For this purpose <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">task</phrase><phrase
- role="special">::</phrase><phrase role="identifier">poolsize</phrase></code>
- must not be given to the constructor so that a <emphasis>worker-thread</emphasis>
- is created an bound the the core.
- </para>
- <para>
-
-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase> <phrase role="special">></phrase>
-<phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">;</phrase> <phrase role="comment">// constructs thread-pool with worker-threads as hardware_concurrency() returns
-</phrase></programlisting>
- </para>
 <para>
- The constructor takes additional arguments for the link_work_stealing[work-stealing
- algorithm] and link_channel[high-] and link_channel[low-watermark] too.
+ The constructor takes additional arguments for the <link linkend="boost_task.pool.work_stealing">work-stealing
+ algorithm</link> and <link linkend="boost_task.pool.channel">high-</link>
+ and <link linkend="boost_task.pool.channel">low-watermark</link> too.
 </para>
 <note>
 <para>
 <emphasis role="bold">Boost.Task</emphasis> does provide this feature only
- for Windows, Linux, AIX, HP-UX and Solaris.
+ for Windows, Linux, AIX, HP-UX, Solaris and FreeBSD.
 </para>
 </note>
 </section>
@@ -2003,7 +2024,7 @@
 role="special">::</phrase><phrase role="identifier">task</phrase></code>
 is not proceeded in the join operation until the forked <emphasis>sub-tasks</emphasis>
 have completed. In the meantime the <emphasis>worker-thread</emphasis> executes
- other tasks from its local worker-queue.
+ other tasks from its local <emphasis>worker-queue</emphasis>.
 </para>
 <para>

@@ -2018,21 +2039,21 @@
 <phrase role="keyword">if</phrase> <phrase role="special">(</phrase> <phrase role="identifier">n</phrase> <phrase role="special"><</phrase> <phrase role="identifier">cutof</phrase><phrase role="special">)</phrase> <phrase role="keyword">return</phrase> <phrase role="identifier">serial_fib</phrase><phrase role="special">(</phrase> <phrase role="identifier">n</phrase><phrase role="special">);</phrase>
 <phrase role="keyword">else</phrase>
 <phrase role="special">{</phrase>
- <phrase role="comment">// fork a sub-task calculating fibonacci(n-1)
-</phrase> <phrase role="identifier">h1</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">1</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">cutof</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">as_sub_task</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
-
- <phrase role="comment">// fork a sub-task calculating fibonacci(n-2)
-</phrase> <phrase role="identifier">h2</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">2</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">cutof</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">as_sub_task</phrase><phrase role="special">()</phrase> <phrase role="special">);</phrase>
+ <phrase role="comment">// create a sub-task calculating fibonacci(n-1)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t1</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">1</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">cutof</phrase><phrase role="special">);</phrase>
+ <phrase role="comment">// create a sub-task calculating fibonacci(n-2)
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t2</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">n</phrase> <phrase role="special">-</phrase> <phrase role="number">2</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">cutof</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// fork both sub-tasks by moving the task
+</phrase> <phrase role="comment">// ownership to the thread-pool
+</phrase> <phrase role="identifier">h1</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t1</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+ <phrase role="identifier">h2</phrase> <phrase role="special">=</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t2</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>

 <phrase role="comment">// join the results of both sub-tasks
</phrase> <phrase role="comment">// if one of the both sub-tasks is not ready
@@ -2044,14 +2065,27 @@

<phrase role="keyword">void</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
<phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase> <phrase role="comment">// handle for fibonacci calculation
-</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="comment">// calculate fibonacci number 10
-</phrase> <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase> <phrase role="comment">// for numbers < 5 do inline recursive calculation
-</phrase> <phrase role="number">10</phrase><phrase role="special">,</phrase>
- <phrase role="number">5</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">default_pool</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="comment">// access the default thread-pool
-</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase>
+ <phrase role="special">></phrase>
+ <phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">5</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// compute fibonacci-number 10
+</phrase> <phrase role="comment">// for numbers < 5 do inline calculation
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">parallel_fib</phrase><phrase role="special">,</phrase>
+ <phrase role="number">10</phrase><phrase role="special">,</phrase>
+ <phrase role="number">5</phrase><phrase role="special">);</phrase>
+
+ <phrase role="comment">// move task ownership to thread-pool
+</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">pool</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="comment">// access result
+</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="string">"fibonacci(10) == "</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">h</phrase><phrase role="special">.</phrase><phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
<phrase role="special">}</phrase>
</programlisting>
 </para>
@@ -2074,11 +2108,11 @@
 </para>
 <para>

-<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
+<programlisting><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">(</phrase> <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase> <phrase role="number">10</phrase><phrase role="special">);</phrase>
+
+<phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="keyword">long</phrase> <phrase role="special">></phrase> <phrase role="identifier">h</phrase><phrase role="special">(</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">async</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">make_task</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">fibonacci</phrase><phrase role="special">,</phrase>
- <phrase role="number">10</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">move</phrase><phrase role="special">(</phrase> <phrase role="identifier">t</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">as_sub_task</phrase><phrase role="special">()</phrase> <phrase role="special">)</phrase> <phrase role="special">);</phrase>
</programlisting>
 </para>
@@ -2199,13 +2233,19 @@
 </para>
 <para>

-<programlisting><phrase role="identifier">typdef</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
+<programlisting><phrase role="comment">// thread-pool with priority scheduling
+</phrase><phrase role="comment">// type of priority is int
+</phrase><phrase role="identifier">typdef</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">static_pool</phrase><phrase role="special"><</phrase>
 <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">priority</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase> <phrase role="special">></phrase> <phrase role="comment">// pool with priority scheduling; integer as priority type
-</phrase><phrase role="special">></phrase> <phrase role="identifier">pool_type</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">priority</phrase><phrase role="special"><</phrase> <phrase role="keyword">int</phrase> <phrase role="special">></phrase>
+ <phrase role="special">></phrase>
+<phrase role="special">></phrase> <phrase role="identifier">pool_type</phrase><phrase role="special">;</phrase>
+
+<phrase role="comment">// test if thread-pool supports priorities at compile time
+</phrase><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">has_attribute</phrase><phrase role="special"><</phrase> <phrase role="identifier">pool_type</phrase> <phrase role="special">>::</phrase><phrase role="identifier">value</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>

-<phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">boolalpha</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">has_attribute</phrase><phrase role="special"><</phrase> <phrase role="identifier">pool_type</phrase> <phrase role="special">>::</phrase><phrase role="identifier">value</phrase> <phrase role="special"><<</phrase> <phrase role="string">"\n"</phrase><phrase role="special">;</phrase>
-<phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="keyword">typeid</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">attribute_type</phrase><phrase role="special"><</phrase> <phrase role="identifier">pool_type</phrase> <phrase role="special">>::</phrase><phrase role="identifier">type</phrase><phrase role="special">).</phrase><phrase role="identifier">name</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
+<phrase role="comment">// access the type used for priority
+</phrase><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special"><<</phrase> <phrase role="keyword">typeid</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">task</phrase><phrase role="special">::</phrase><phrase role="identifier">attribute_type</phrase><phrase role="special"><</phrase> <phrase role="identifier">pool_type</phrase> <phrase role="special">>::</phrase><phrase role="identifier">type</phrase><phrase role="special">).</phrase><phrase role="identifier">name</phrase><phrase role="special">()</phrase> <phrase role="special"><<</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
</programlisting>
 </para>
 </section>
@@ -2219,33 +2259,97 @@
<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">class</phrase> <phrase role="identifier">task</phrase>
+<phrase role="keyword">class</phrase> <phrase role="identifier">task</phrase> <phrase role="special">:</phrase> <phrase role="keyword">private</phrase> <phrase role="identifier">noncopyable</phrase>
<phrase role="special">{</phrase>
<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="identifier">task</phrase><phrase role="special">();</phrase>
+
+ <phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">R</phrase><phrase role="special">(</phrase> <phrase role="special">*</phrase> <phrase role="identifier">fn</phrase><phrase role="special">)());</phrase>
+
 <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">fn</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase> <phrase role="special">></phrase>
+ <phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">);</phrase>
+ <phrase role="special">...</phrase>
+ <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A9</phrase> <phrase role="special">></phrase>
+ <phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="identifier">A9</phrase> <phrase role="identifier">a9</phrase><phrase role="special">);</phrase>

- <phrase role="keyword">const</phrase> <phrase role="identifier">id</phrase> <phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">task</phrase> <phrase role="special">&</phrase> <phrase role="keyword">operator</phrase><phrase role="special">=(</phrase> <phrase role="identifier">task</phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">task</phrase> <phrase role="special">&&</phrase> <phrase role="identifier">move</phrase><phrase role="special">();</phrase>

 <phrase role="identifier">shared_future</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">get_future</phrase><phrase role="special">();</phrase>

- <phrase role="keyword">void</phrase> <phrase role="identifier">swap</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">other</phrase><phrase role="special">)</phrase> <phrase role="comment">// throw();
-</phrase>
- <phrase role="keyword">void</phrase> <phrase role="keyword">operator</phrase><phrase role="special">()()</phrase> <phrase role="comment">// throw();
-</phrase><phrase role="special">};</phrase>
+ <phrase role="keyword">void</phrase> <phrase role="keyword">operator</phrase><phrase role="special">()();</phrase>

-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>::</phrase><phrase role="identifier">type</phrase> <phrase role="special">></phrase> <phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">);</phrase>
+ <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Cb</phrase> <phrase role="special">></phrase>
+ <phrase role="keyword">void</phrase> <phrase role="identifier">set_wait_callback</phrase><phrase role="special">(</phrase> <phrase role="identifier">Cb</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">cb</phrase><phrase role="special">);</phrase>

-<phrase role="special">...</phrase>
+ <phrase role="keyword">void</phrase> <phrase role="identifier">swap</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">other</phrase><phrase role="special">);</phrase>

-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A10</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>::</phrase><phrase role="identifier">type</phrase> <phrase role="special">></phrase> <phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="identifier">A10</phrase> <phrase role="identifier">a10</phrase><phrase role="special">);</phrase>
+ <phrase role="keyword">operator</phrase> <phrase role="identifier">unspecified_bool_type</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="keyword">bool</phrase> <phrase role="keyword">operator</phrase><phrase role="special">!()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.task.constructor"/>
+ <anchor id="boost_task.reference.task.default_constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.default_constructor">Default constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">task</phrase><phrase role="special">()</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs an unitialized <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase
+ role="special">></phrase></code>
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.constructor__function_pointer_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.constructor__function_pointer_">Constructor
+ (function pointer)</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">R</phrase><phrase role="special">(</phrase> <phrase role="special">*</phrase> <phrase role="identifier">fn</phrase><phrase role="special">)());</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase></code>
+ from a function pointer
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.constructor__functor_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.task.constructor">Constructor</link>
+ <link linkend="boost_task.reference.task.constructor__functor_">Constructor
+ (functor)</link>
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase> <phrase role="special">></phrase>
@@ -2256,7 +2360,7 @@
 <listitem>
 <para>
 constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">tp</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special"><</phrase>
 <phrase role="identifier">R</phrase> <phrase role="special">></phrase></code>
 from a function object
@@ -2270,19 +2374,104 @@
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.task.function__code__phrase_role__identifier__get_id__phrase__phrase_role__special______phrase___code_"/>
+ <anchor id="boost_task.reference.task.constructor__functor_with_arguments_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.constructor__functor_with_arguments_">Constructor
+ (functor with arguments)</link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase> <phrase role="special">></phrase>
+<phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">);</phrase>
+<phrase role="special">...</phrase>
+<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A9</phrase> <phrase role="special">></phrase>
+<phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="identifier">A9</phrase> <phrase role="identifier">a9</phrase><phrase role="special">);</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase></code>
+ from a function object and its arguments
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.move_copy_constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.move_copy_constructor">Move-copy
+ constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">task</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase> <phrase role="special">&&)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase></code>
+ from another task taking over the ownership
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.move_assignment_operator"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.move_assignment_operator">Move-assignment
+ operator</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">task</phrase> <phrase role="special">&</phrase> <phrase role="keyword">operator</phrase><phrase role="special">=(</phrase> <phrase role="identifier">task</phrase> <phrase role="special">&&)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase></code>
+ from another task taking over the ownership
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.member_function__code__phrase_role__identifier__move__phrase__phrase_role__special______phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.task.function__code__phrase_role__identifier__get_id__phrase__phrase_role__special______phrase___code_">function
- <code><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase></code></link>
+ <link linkend="boost_task.reference.task.member_function__code__phrase_role__identifier__move__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="identifier">move</phrase><phrase role="special">()</phrase></code></link>
 </bridgehead>

-<programlisting><phrase role="keyword">const</phrase> <phrase role="identifier">id</phrase> <phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+<programlisting><phrase role="identifier">task</phrase> <phrase role="special">&&</phrase> <phrase role="identifier">move</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- returns task identifier
+ moves task releasing the ownership
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
@@ -2311,15 +2500,67 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- ???
+ Nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.task.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special______phrase___code_"/>
+ <anchor id="boost_task.reference.task.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special________phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.task.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special______phrase___code_">Member
- function <code><phrase role="identifier">swap</phrase><phrase role="special">()</phrase></code></link>
+ <link linkend="boost_task.reference.task.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special________phrase___code_">Member
+ function <code><phrase role="keyword">operator</phrase><phrase role="special">()()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">void</phrase> <phrase role="keyword">operator</phrase><phrase role="special">()()</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ executes task's internal function object
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.member_template_function__code__phrase_role__identifier__set_wait_callback__phrase__phrase_role__special_____phrase___phrase_role__identifier__cb__phrase___phrase_role__identifier__cons__phrase__phrase_role__special___amp____phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.member_template_function__code__phrase_role__identifier__set_wait_callback__phrase__phrase_role__special_____phrase___phrase_role__identifier__cb__phrase___phrase_role__identifier__cons__phrase__phrase_role__special___amp____phrase___code_">Member
+ template-function <code><phrase role="identifier">set_wait_callback</phrase><phrase
+ role="special">(</phrase> <phrase role="identifier">Cb</phrase> <phrase role="identifier">cons</phrase><phrase
+ role="special">&)</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Cb</phrase> <phrase role="special">></phrase>
+<phrase role="keyword">void</phrase> <phrase role="identifier">set_wait_callback</phrase><phrase role="special">(</phrase> <phrase role="identifier">Cb</phrase> <phrase role="keyword">const</phrase> <phrase role="identifier">cb</phrase><phrase role="special">&);</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ stores callback function object which will be called if task would block
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.task.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp____phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.task.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp____phrase___code_">Member
+ function <code><phrase role="identifier">swap</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&)</phrase></code></link>
 </bridgehead>

<programlisting><phrase role="keyword">void</phrase> <phrase role="identifier">swap</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">other</phrase><phrase role="special">)</phrase>
@@ -2339,19 +2580,20 @@
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.task.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special________phrase___code_"/>
+ <anchor id="boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.task.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special________phrase___code_">Member
- function <code><phrase role="keyword">operator</phrase><phrase role="special">()()</phrase></code></link>
+ <link linkend="boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_">operator
+ <code><phrase role="keyword">operator</phrase> <phrase role="identifier">unspecified_bool_type</phrase><phrase
+ role="special">()</phrase></code></link>
 </bridgehead>

-<programlisting><phrase role="keyword">void</phrase> <phrase role="keyword">operator</phrase><phrase role="special">()()</phrase>
+<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">unspecified_bool_type</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- executes tasks internal function object
+ is task valid == does task own ownership
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
@@ -2362,25 +2604,19 @@
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.task.free_function__code__phrase_role__identifier__make_task__phrase__phrase_role__special______phrase___code_"/>
+ <anchor id="boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.task.free_function__code__phrase_role__identifier__make_task__phrase__phrase_role__special______phrase___code_">Free
- function <code><phrase role="identifier">make_task</phrase><phrase role="special">()</phrase></code></link>
+ <link linkend="boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_">operator
+ <code><phrase role="keyword">operator</phrase><phrase role="special">!()</phrase></code></link>
 </bridgehead>

-<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>::</phrase><phrase role="identifier">type</phrase> <phrase role="special">></phrase> <phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">);</phrase>
-
-<phrase role="special">...</phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Fn</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">A10</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>::</phrase><phrase role="identifier">type</phrase> <phrase role="special">></phrase> <phrase role="identifier">make_task</phrase><phrase role="special">(</phrase> <phrase role="identifier">Fn</phrase> <phrase role="identifier">fn</phrase><phrase role="special">,</phrase> <phrase role="identifier">A0</phrase> <phrase role="identifier">a0</phrase><phrase role="special">,</phrase> <phrase role="special">...,</phrase> <phrase role="identifier">A10</phrase> <phrase role="identifier">a10</phrase><phrase role="special">);</phrase>
+<programlisting><phrase role="keyword">bool</phrase> <phrase role="keyword">operator</phrase><phrase role="special">!()</phrase> <phrase role="keyword">const</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- creates an task from function object and arguments
+ is task invalid == task does not have ownership
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
@@ -2404,27 +2640,17 @@
<phrase role="special">{</phrase>
 <phrase role="identifier">handle</phrase><phrase role="special">();</phrase>

- <phrase role="keyword">const</phrase> <phrase role="identifier">id</phrase> <phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
-
 <phrase role="keyword">void</phrase> <phrase role="identifier">interrupt</phrase><phrase role="special">();</phrase>
-
 <phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_and_wait</phrase><phrase role="special">();</phrase>
-
 <phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_and_wait_until</phrase><phrase role="special">(</phrase> <phrase role="identifier">system_time</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">abs_time</phrase><phrase role="special">);</phrase>
-
 <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Duration</phrase> <phrase role="special">></phrase>
 <phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_and_wait_for</phrase><phrase role="special">(</phrase> <phrase role="identifier">Duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">rel_time</phrase><phrase role="special">);</phrase>
-
 <phrase role="keyword">bool</phrase> <phrase role="identifier">interruption_requested</phrase><phrase role="special">();</phrase>

 <phrase role="identifier">R</phrase> <phrase role="identifier">get</phrase><phrase role="special">();</phrase>
-
 <phrase role="keyword">bool</phrase> <phrase role="identifier">is_ready</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
-
 <phrase role="keyword">bool</phrase> <phrase role="identifier">has_value</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
-
 <phrase role="keyword">bool</phrase> <phrase role="identifier">has_exception</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
-
 <phrase role="keyword">void</phrase> <phrase role="identifier">wait</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>

 <phrase role="identifier">shared_future</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">get_future</phrase><phrase role="special">();</phrase>
@@ -2437,13 +2663,7 @@

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase>
<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">);</phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">);</phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">);</phrase>
-
+<phrase role="special">...</phrase>
<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase>
<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t5</phrase><phrase role="special">);</phrase>

@@ -2452,13 +2672,7 @@

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase>
<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">);</phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">);</phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase
><phrase role="special"><</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">);</phrase>
-
+<phrase role="special">...</phrase>
<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase>
<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase
><phrase role="special"><</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t5</phrase><phrase role="special">);</phrase>
</programlisting>
@@ -2485,29 +2699,6 @@
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.handle.member_function__code__phrase_role__identifier__get_id__phrase__phrase_role__special______phrase___code_"/>
- <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.handle.member_function__code__phrase_role__identifier__get_id__phrase__phrase_role__special______phrase___code_">Member
- function <code><phrase role="identifier">get_id</phrase><phrase role="special">()</phrase></code></link>
- </bridgehead>
-
-<programlisting><phrase role="keyword">const</phrase> <phrase role="identifier">id</phrase> <phrase role="identifier">get_id</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
-</programlisting>
- <variablelist>
- <title></title> <varlistentry><term>Effects:</term>
- <listitem>
- <para>
- returns identifier of the associated task
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Throws:</term>
- <listitem>
- <para>
- Nothing
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
 <anchor id="boost_task.reference.handle.member_function__code__phrase_role__identifier__interruption_requested__phrase__phrase_role__special______phrase___code_"/>
 <bridgehead renderas="sect4">
 <link linkend="boost_task.reference.handle.member_function__code__phrase_role__identifier__interruption_requested__phrase__phrase_role__special______phrase___code_">Member
@@ -2550,7 +2741,7 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- ???
+ Nothing
 </para>
 </listitem>
 </varlistentry>
@@ -2574,7 +2765,8 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- ???
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2586,7 +2778,7 @@
 role="special">()</phrase></code></link>
 </bridgehead>

-<programlisting><phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_and_wait_until</phrase><phrase role="special">(</phrase> <phrase role="identifier">system_time</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">abs_time</phrase><phrase role="special">)</phrase>
+<programlisting><phrase role="keyword">bool</phrase> <phrase role="identifier">interrupt_and_wait_until</phrase><phrase role="special">(</phrase> <phrase role="identifier">system_time</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">abs_time</phrase><phrase role="special">)</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
@@ -2596,10 +2788,17 @@
 or time-point elapsed
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Returns:</term>
+ <listitem>
+ <para>
+ false if the the time specified by abs_time was reached, true otherwise
+ </para>
+ </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- ???
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2612,7 +2811,7 @@
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Duration</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_and_wait_for</phrase><phrase role="special">(</phrase> <phrase role="identifier">Duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">rel_time</phrase><phrase role="special">)</phrase>
+<phrase role="keyword">bool</phrase> <phrase role="identifier">interrupt_and_wait_for</phrase><phrase role="special">(</phrase> <phrase role="identifier">Duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">rel_time</phrase><phrase role="special">)</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
@@ -2622,10 +2821,17 @@
 or time-duration elapsed
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Returns:</term>
+ <listitem>
+ <para>
+ false if the the time specified by rel_time was reached, true otherwise
+ </para>
+ </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- ???
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2648,7 +2854,16 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- task_interrupted, task_uninialized
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task_uninialized</phrase></code>,
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_rejected</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">broken_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2671,7 +2886,81 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- task_interrupted, task_uninialized
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task_uninialized</phrase></code>,
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_rejected</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">broken_task</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_for__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_for__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="identifier">wait_for</phrase><phrase role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Duration</phrase> <phrase role="special">></phrase>
+<phrase role="keyword">bool</phrase> <phrase role="identifier">wait_for</phrase><phrase role="special">(</phrase> <phrase role="identifier">Duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">rel_time</phrase><phrase role="special">)</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ blocks caller until task is done
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task_uninialized</phrase></code>,
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_rejected</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">broken_task</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_until__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_until__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="identifier">wait_until</phrase><phrase role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">bool</phrase> <phrase role="identifier">wait_until</phrase><phrase role="special">(</phrase> <phrase role="identifier">system_time</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">abs_time</phrase><phrase role="special">)</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ blocks caller until task is done
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task_uninialized</phrase></code>,
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_rejected</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">broken_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2798,19 +3087,19 @@
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">begin</phrase><phrase role="special">,</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">end</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">begin</phrase><phrase role="special">,</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">end</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T4</phrase> <ph
rase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t5</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">void</phrase> <phrase role="identifier">waitfor_all</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T4</phrase> <ph
rase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t5</phrase><phrase role="special">);</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
@@ -2822,7 +3111,11 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task_rejected</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2834,19 +3127,19 @@
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">begin</phrase><phrase role="special">,</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">end</phrase><phrase role="special">);</phrase>
+<phrase role="identifier">Iterator</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">begin</phrase><phrase role="special">,</phrase> <phrase role="identifier">Iterator</phrase> <phrase role="identifier">end</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase
><phrase role="special"><</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <
phrase role="identifier">T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">);</phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T1</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T2</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T3</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T4</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">friend</phrase> <phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase
><phrase role="special"><</phrase> <phrase role="identifier">T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t5</phrase><phrase role="special">);</phrase>
+<phrase role="keyword">unsigned</phrase> <phrase role="keyword">int</phrase> <phrase role="identifier">waitfor_any</phrase><phrase role="special">(</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T1</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t1</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T2</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t2</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T3</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t3</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <
phrase role="identifier">T4</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t4</phrase><phrase role="special">,</phrase> <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">T5</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">t5</phrase><phrase role="special">);</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
@@ -2858,7 +3151,13 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task_rejected</phrase></code>,
+ <code><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">bad_alloc</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2867,28 +3166,30 @@
 <section id="boost_task.reference.async">
 <title><link linkend="boost_task.reference.async"> Non-member function <code><phrase
 role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase
- role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>,</phrase>
- <phrase role="identifier">EP</phrase><phrase role="special">)</phrase></code></link></title>
+ role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&&,</phrase> <phrase role="identifier">EP</phrase><phrase
+ role="special">)</phrase></code></link></title>
 <para>

<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">async</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">EP</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">EP</phrase> <phrase role="identifier">ep</phrase><phrase role="special">);</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">EP</phrase> <phrase role="identifier">ep</phrase><phrase role="special">);</phrase>
</programlisting>
 </para>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- executes task in an asyncrounous executer and returns a handle associated
+ moves task to an asyncrounous executer and returns a handle associated
 with the task
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2897,30 +3198,32 @@
 <section id="boost_task.reference.async1">
 <title><link linkend="boost_task.reference.async1"> Non-member function <code><phrase
 role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase
- role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>,</phrase>
- <phrase role="identifier">pool</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase>
- <phrase role="special">&)</phrase></code></link></title>
+ role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&&,</phrase> <phrase role="identifier">pool</phrase><phrase
+ role="special"><</phrase> <phrase role="identifier">Channel</phrase> <phrase
+ role="special">></phrase> <phrase role="special">&)</phrase></code></link></title>
 <para>

<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">async</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">pool</phrase><phrase role="special"><</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">ep</phrase><phrase role="special">);</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">pool</phrase><phrase role="special"><</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">ep</phrase><phrase role="special">);</phrase>
</programlisting>
 </para>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- executes task in a thread-pool and returns a handle associated with the
+ moves task into a thread-pool and returns a handle associated with the
 task
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_rejected</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2929,31 +3232,33 @@
 <section id="boost_task.reference.async2">
 <title><link linkend="boost_task.reference.async2"> Non-member function <code><phrase
 role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase
- role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">>,</phrase>
- <phrase role="identifier">Attr</phrase><phrase role="special">,</phrase> <phrase
- role="identifier">pool</phrase><phrase role="special"><</phrase> <phrase
- role="identifier">Channel</phrase> <phrase role="special">></phrase> <phrase
- role="special">&)</phrase></code></link></title>
+ role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&&,</phrase> <phrase role="identifier">Attr</phrase><phrase
+ role="special">,</phrase> <phrase role="identifier">pool</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&)</phrase></code></link></title>
 <para>

<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">async</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Channel</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Attr</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase role="identifier">attr</phrase><phrase role="special">,</phrase> <phrase role="identifier">pool</phrase><phrase role="special"><</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">ep</phrase><phrase role="special">);</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">async</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase role="identifier">attr</phrase><phrase role="special">,</phrase> <phrase role="identifier">pool</phrase><phrase role="special"><</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase> <phrase role="special">&</phrase> <phrase role="identifier">ep</phrase><phrase role="special">);</phrase>
</programlisting>
 </para>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- executes atrributed task in a thread-pool and returns a handle associated
+ moves attributed task into a thread-pool and returns a handle associated
 with the task
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task_rejected</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -2969,27 +3274,27 @@
<phrase role="keyword">struct</phrase> <phrase role="identifier">own_thread</phrase>
<phrase role="special">{</phrase>
 <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.own_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__identifier__t__phrase__phrase_role__special_____phrase___code_"/>
+ <anchor id="boost_task.reference.own_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.own_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__identifier__t__phrase__phrase_role__special_____phrase___code_">Member
+ <link linkend="boost_task.reference.own_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_">Member
 function <code><phrase role="keyword">operator</phrase><phrase role="special">()(</phrase>
 <phrase role="identifier">task</phrase><phrase role="special"><</phrase>
 <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">t</phrase><phrase role="special">)</phrase></code></link>
+ <phrase role="special">&&)</phrase></code></link>
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- executes task in the current thread an returns an handle associated with
+ moves task in the current thread an returns an handle associated with
 the task
 </para>
 </listitem>
@@ -3012,34 +3317,34 @@
<phrase role="keyword">struct</phrase> <phrase role="identifier">new_thread</phrase>
<phrase role="special">{</phrase>
 <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
+ <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&);</phrase>
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.new_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__identifier__t__phrase__phrase_role__special_____phrase___code_"/>
+ <anchor id="boost_task.reference.new_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.new_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__identifier__t__phrase__phrase_role__special_____phrase___code_">Member
+ <link linkend="boost_task.reference.new_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_">Member
 function <code><phrase role="keyword">operator</phrase><phrase role="special">()(</phrase>
 <phrase role="identifier">task</phrase><phrase role="special"><</phrase>
 <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">t</phrase><phrase role="special">)</phrase></code></link>
+ <phrase role="special">&&)</phrase></code></link>
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">operator</phrase><phrase role="special">()(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- executes task in a new thread an returns an handle associated with the
- task
+ moves task in a new thread an returns an handle associated with the task
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3050,62 +3355,103 @@
 role="identifier">static_pool</phrase></code></link></title>
 <para>

-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">static_pool</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+<programlisting> <phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">static_pool</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">class</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">:</phrase> <phrase role="keyword">private</phrase> <phrase role="identifier">noncopyable</phrase>
-<phrase role="special">{</phrase>
-<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">poolsize</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">psize</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">microseconds</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">poolsize</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">psize</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">100</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
-
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">microseconds</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">,</phrase>
- <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">100</phrase><phrase role="special">),</phrase>
- <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
-
- <phrase role="special">~</phrase><phrase role="identifier">static_pool</phrase><phrase role="special">();</phrase>
-
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">size</phrase><phrase role="special">();</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">active</phrase><phrase role="special">();</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">idle</phrase><phrase role="special">();</phrase>
-
- <phrase role="keyword">void</phrase> <phrase role="identifier">shutdown</phrase><phrase role="special">();</phrase>
- <phrase role="keyword">void</phrase> <phrase role="identifier">shutdown_now</phrase><phrase role="special">();</phrase>
-
- <phrase role="keyword">bool</phrase> <phrase role="identifier">closed</phrase><phrase role="special">();</phrase>
- <phrase role="keyword">void</phrase> <phrase role="identifier">clear</phrase><phrase role="special">();</phrase>
- <phrase role="keyword">bool</phrase> <phrase role="identifier">empty</phrase><phrase role="special">();</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">pending</phrase><phrase role="special">();</phrase>
-
- <phrase role="keyword">const</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">upper_bound</phrase><phrase role="special">();</phrase>
- <phrase role="keyword">void</phrase> <phrase role="identifier">upper_bound</phrase><phrase role="special">(</phrase> <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">);</phrase>
- <phrase role="keyword">const</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">lower_bound</phrase><phrase role="special">();</phrase>
- <phrase role="keyword">void</phrase> <phrase role="identifier">lower_bound</phrase><phrase role="special">(</phrase> <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">);</phrase>
+ <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Channel</phrase> <phrase role="special">></phrase>
+ <phrase role="keyword">class</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">:</phrase> <phrase role="keyword">private</phrase> <phrase role="identifier">noncopyable</phrase>
+ <phrase role="special">{</phrase>
+ <phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="identifier">static_pool</phrase><phrase role="special">();</phrase>

- <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">poolsize</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">psize</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">microseconds</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase>
+ <phrase role="identifier">poolsize</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">psize</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">100</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">&&);</phrase>
+
+ <phrase role="identifier">static_pool</phrase> <phrase role="special">&</phrase> <phrase role="keyword">operator</phrase><phrase role="special">=(</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">&&);</phrase>
+
+<phrase role="preprocessor"># if</phrase> <phrase role="identifier">defined</phrase><phrase role="special">(</phrase><phrase role="identifier">BOOST_HAS_PROCESSOR_BINDINGS</phrase><phrase role="special">)</phrase>
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase>
+ <phrase role="special"><<</phrase><phrase role="identifier">unspec</phrase><phrase role="special">-</phrase><phrase role="identifier">type</phrase><phrase role="special">>>,</phrase>
+ <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">microseconds</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase>
+ <phrase role="special"><<</phrase><phrase role="identifier">unspec</phrase><phrase role="special">-</phrase><phrase role="identifier">type</phrase><phrase role="special">>>,</phrase>
+ <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">,</phrase>
+ <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">100</phrase><phrase role="special">),</phrase>
+ <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase>
+
+ <phrase role="keyword">static</phrase> <phrase role="special"><<</phrase><phrase role="identifier">unspec</phrase><phrase role="special">-</phrase><phrase role="identifier">type</phrase><phrase role="special">>></phrase> <phrase role="identifier">bind_to_processors</phrase><phrase role="special">();</phrase>
+<phrase role="preprocessor"># endif</phrase>

- <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Attr</phrase> <phrase role="special">></phrase>
- <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">attr</phrase><phrase role="special">);</phrase>
-<phrase role="special">};</phrase>
+ <phrase role="special">~</phrase><phrase role="identifier">static_pool</phrase><phrase role="special">();</phrase>
+
+ <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">size</phrase><phrase role="special">();</phrase>
+ <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">active</phrase><phrase role="special">();</phrase>
+ <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">idle</phrase><phrase role="special">();</phrase>
+
+ <phrase role="keyword">void</phrase> <phrase role="identifier">shutdown</phrase><phrase role="special">();</phrase>
+ <phrase role="keyword">void</phrase> <phrase role="identifier">shutdown_now</phrase><phrase role="special">();</phrase>
+
+ <phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_all_worker</phrase><phrase role="special">();</phrase>
+
+ <phrase role="keyword">bool</phrase> <phrase role="identifier">closed</phrase><phrase role="special">();</phrase>
+ <phrase role="keyword">void</phrase> <phrase role="identifier">clear</phrase><phrase role="special">();</phrase>
+ <phrase role="keyword">bool</phrase> <phrase role="identifier">empty</phrase><phrase role="special">();</phrase>
+ <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">pending</phrase><phrase role="special">();</phrase>
+
+ <phrase role="keyword">const</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">upper_bound</phrase><phrase role="special">();</phrase>
+ <phrase role="keyword">void</phrase> <phrase role="identifier">upper_bound</phrase><phrase role="special">(</phrase> <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">);</phrase>
+ <phrase role="keyword">const</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">lower_bound</phrase><phrase role="special">();</phrase>
+ <phrase role="keyword">void</phrase> <phrase role="identifier">lower_bound</phrase><phrase role="special">(</phrase> <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Attr</phrase> <phrase role="special">></phrase>
+ <phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">attr</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">void</phrase> <phrase role="identifier">swap</phrase><phrase role="special">(</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">&</phrase> <phrase role="identifier">other</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">operator</phrase> <phrase role="identifier">unspecified_bool_type</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="keyword">bool</phrase> <phrase role="keyword">operator</phrase><phrase role="special">!()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="special">};</phrase>
</programlisting>
 </para>
+ <anchor id="boost_task.reference.static_pool.default_constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.default_constructor">Default
+ constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">static_pool</phrase><phrase role="special">()</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs an unitialized pool
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
 <anchor id="boost_task.reference.static_pool.constructor__unbounded_channel_"/>
 <bridgehead renderas="sect4">
 <link linkend="boost_task.reference.static_pool.constructor__unbounded_channel_">Constructor
@@ -3113,6 +3459,7 @@
 </bridgehead>

<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase>
+ <phrase role="special"><<</phrase><phrase role="identifier">unspec</phrase><phrase role="special">-</phrase><phrase role="identifier">type</phrase><phrase role="special">>>,</phrase>
 <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">microseconds</phrase><phrase role="special">(</phrase> <phrase role="number">10</phrase><phrase role="special">),</phrase>
 <phrase role="identifier">scanns</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">scns</phrase> <phrase role="special">=</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="number">20</phrase><phrase role="special">)</phrase> <phrase role="special">)</phrase>
</programlisting>
@@ -3120,7 +3467,7 @@
 <title></title> <varlistentry><term>Preconditions:</term>
 <listitem>
 <para>
- operating system provides functionality for processor pining
+ operating system provides functionality for processor binding
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Effects:</term>
@@ -3135,6 +3482,8 @@
 <listitem>
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>, <code><phrase
+ role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">invalid_scanns</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase
@@ -3144,7 +3493,9 @@
 </varlistentry> <varlistentry><term>Notes:</term>
 <listitem>
 <para>
- constructor has to be called if a unbounded-channel is used
+ constructor has to be called if a unbounded-channel is used and <code><phrase
+ role="identifier">bind_to_processors</phrase><phrase role="special">()</phrase></code>
+ must be set as first argument
 </para>
 </listitem>
 </varlistentry>
@@ -3172,6 +3523,8 @@
 <listitem>
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>, <code><phrase
+ role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">invalid_scanns</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase
@@ -3193,6 +3546,7 @@
 </bridgehead>

<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase>
+ <phrase role="special"><<</phrase><phrase role="identifier">unspec</phrase><phrase role="special">-</phrase><phrase role="identifier">type</phrase><phrase role="special">>>,</phrase>
 <phrase role="identifier">high_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">hwm</phrase><phrase role="special">,</phrase>
 <phrase role="identifier">low_watermark</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">lwm</phrase><phrase role="special">,</phrase>
 <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">time_duration</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">asleep</phrase> <phrase role="special">=</phrase> <phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">100</phrase><phrase role="special">),</phrase>
@@ -3202,7 +3556,7 @@
 <title></title> <varlistentry><term>Preconditions:</term>
 <listitem>
 <para>
- operating system provides functionality for processor pining
+ operating system provides functionality for processor binding
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Effects:</term>
@@ -3217,6 +3571,8 @@
 <listitem>
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>, <code><phrase
+ role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">invalid_scanns</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase
@@ -3229,7 +3585,9 @@
 </varlistentry> <varlistentry><term>Notes:</term>
 <listitem>
 <para>
- Constructor has to be called if a bounded-channel is used.
+ constructor has to be called if a bounded-channel is used and <code><phrase
+ role="identifier">bind_to_processors</phrase><phrase role="special">()</phrase></code>
+ must be set as first argument
 </para>
 </listitem>
 </varlistentry>
@@ -3259,6 +3617,8 @@
 <listitem>
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_resource_error</phrase></code>, <code><phrase
+ role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
 role="identifier">invalid_scanns</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
 role="special">::</phrase><phrase role="identifier">task</phrase><phrase
@@ -3276,6 +3636,52 @@
 </listitem>
 </varlistentry>
 </variablelist>
+ <anchor id="boost_task.reference.static_pool.move_copy_constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.move_copy_constructor">Move-copy
+ constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">static_pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">&&)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ creates an pool out of another one which gets zeroed out
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.static_pool.move_assigment_constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.move_assigment_constructor">Move-assigment
+ constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="identifier">static_pool</phrase> <phrase role="special">&</phrase> <phrase role="keyword">operator</phrase><phrase role="special">=(</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">&&)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ creates an pool out of another one which gets zeroed out
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
 <anchor id="boost_task.reference.static_pool.destructor"/>
 <bridgehead renderas="sect4">
 <link linkend="boost_task.reference.static_pool.destructor">Destructor</link>
@@ -3287,14 +3693,39 @@
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- calls <code><phrase role="special">:</phrase><phrase role="identifier">shutdown</phrase><phrase
- role="special">()</phrase></code> if not already called
+ calls <code><phrase role="identifier">shutdown</phrase><phrase role="special">()</phrase></code>
+ if not already called
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.static_pool.static_member_function__code__phrase_role__identifier__bind_to_processors__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.static_member_function__code__phrase_role__identifier__bind_to_processors__phrase__phrase_role__special______phrase___code_">Static
+ member function <code><phrase role="identifier">bind_to_processors</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="special"><<</phrase><phrase role="identifier">unspec</phrase><phrase role="special">-</phrase><phrase role="identifier">type</phrase><phrase role="special">>></phrase> <phrase role="identifier">bind_to_processors</phrase><phrase role="special">()</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ used in order to let the pool create worker-threads as cores are available
+ and bound the threads to the cores
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
 </para>
 </listitem>
 </varlistentry>
@@ -3317,7 +3748,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3340,7 +3773,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3363,13 +3798,15 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
 <listitem>
 <para>
- The value is the difference of <code><phrase role="identifier">size</phrase><phrase
+ the value is the difference of <code><phrase role="identifier">size</phrase><phrase
 role="special">()</phrase></code> and <code><phrase role="identifier">active</phrase><phrase
 role="special">()</phrase></code>
 </para>
@@ -3394,7 +3831,13 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">system</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">system_error</phrase></code>,
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
@@ -3424,7 +3867,13 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_interrupted</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">system</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">system_error</phrase></code>,
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
@@ -3435,6 +3884,30 @@
 </listitem>
 </varlistentry>
 </variablelist>
+ <anchor id="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__interrupt_all_worker__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__interrupt_all_worker__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="identifier">interrupt_all_worker</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">void</phrase> <phrase role="identifier">interrupt_all_worker</phrase><phrase role="special">()</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ interrupts all worker-threads without invalidating the pool
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
 <anchor id="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__closed__phrase__phrase_role__special______phrase___code_"/>
 <bridgehead renderas="sect4">
 <link linkend="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__closed__phrase__phrase_role__special______phrase___code_">Member
@@ -3453,7 +3926,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3476,7 +3951,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3499,7 +3976,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3523,7 +4002,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3552,7 +4033,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
@@ -3600,7 +4083,9 @@
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_watermark</phrase></code>
+ role="identifier">invalid_watermark</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
@@ -3635,7 +4120,9 @@
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
@@ -3683,7 +4170,9 @@
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_watermark</phrase></code>
+ role="identifier">invalid_watermark</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Notes:</term>
@@ -3694,17 +4183,17 @@
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__act__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__act__phrase__phrase_role__special_____phrase___code_"/>
+ <anchor id="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__act__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__act__phrase__phrase_role__special_____phrase___code_">Member
+ <link linkend="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_">Member
 function <code><phrase role="identifier">submit</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">Act</phrase> <phrase role="keyword">const</phrase><phrase
- role="special">&</phrase> <phrase role="identifier">act</phrase><phrase
- role="special">)</phrase></code></link>
+ <phrase role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&&)</phrase></code></link>
 </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">)</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Preconditions:</term>
@@ -3716,7 +4205,7 @@
 </varlistentry> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- submits an task to the pool and returns an associated handle
+ moves an task to the pool and returns an associated handle
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
@@ -3724,24 +4213,26 @@
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task_rejected</phrase></code>
+ role="identifier">task_rejected</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">pool_moved</phrase></code>
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__act__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__act__phrase__phrase_role__special_____phrase___phrase_role__identifier__attr__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__attr__phrase__phrase_role__special_____phrase___code_"/>
+ <anchor id="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___phrase_role__identifier__attr__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__attr__phrase__phrase_role__special_____phrase___code_"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__act__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__act__phrase__phrase_role__special_____phrase___phrase_role__identifier__attr__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__attr__phrase__phrase_role__special_____phrase___code_">Member
+ <link linkend="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___phrase_role__identifier__attr__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__attr__phrase__phrase_role__special_____phrase___code_">Member
 function <code><phrase role="identifier">submit</phrase><phrase role="special">(</phrase>
- <phrase role="identifier">Act</phrase> <phrase role="keyword">const</phrase><phrase
- role="special">&</phrase> <phrase role="identifier">act</phrase><phrase
- role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase
- role="keyword">const</phrase><phrase role="special">&</phrase> <phrase
- role="identifier">attr</phrase><phrase role="special">)</phrase></code></link>
- </bridgehead>
+ <phrase role="identifier">task</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">R</phrase> <phrase role="special">></phrase>
+ <phrase role="special">&&,</phrase> <phrase role="identifier">Attr</phrase>
+ <phrase role="keyword">const</phrase><phrase role="special">&</phrase>
+ <phrase role="identifier">attr</phrase><phrase role="special">)</phrase></code></link>
+ </bridgehead>

<programlisting><phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">R</phrase><phrase role="special">,</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Attr</phrase> <phrase role="special">></phrase>
-<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">attr</phrase><phrase role="special">)</phrase>
+<phrase role="identifier">handle</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="identifier">submit</phrase><phrase role="special">(</phrase> <phrase role="identifier">task</phrase><phrase role="special"><</phrase> <phrase role="identifier">R</phrase> <phrase role="special">></phrase> <phrase role="special">&&</phrase> <phrase role="identifier">t</phrase><phrase role="special">,</phrase> <phrase role="identifier">Attr</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">attr</phrase><phrase role="special">)</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Preconditions:</term>
@@ -3753,7 +4244,7 @@
 </varlistentry> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- submits an task to the pool and returns an associated handle - task is
+ moves an task to the pool and returns an associated handle - task is
 scheduled by the attribute
 </para>
 </listitem>
@@ -3762,7 +4253,79 @@
 <para>
 <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task_rejected</phrase></code>
+ role="identifier">task_rejected</phrase></code>, <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">task</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">pool_moved</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.static_pool.member_function_swap__static_pool__amp___"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.member_function_swap__static_pool__amp___">Member
+ function swap( static_pool &)`</link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">void</phrase> <phrase role="identifier">swap</phrase><phrase role="special">(</phrase> <phrase role="identifier">static_pool</phrase> <phrase role="special">&</phrase> <phrase role="identifier">other</phrase><phrase role="special">)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ swaps pool
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_">operator
+ <code><phrase role="keyword">operator</phrase> <phrase role="identifier">unspecified_bool_type</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">unspecified_bool_type</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ is static_pool valid == does static_pool own ownership
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_">operator
+ <code><phrase role="keyword">operator</phrase><phrase role="special">!()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">bool</phrase> <phrase role="keyword">operator</phrase><phrase role="special">!()</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ is static_pool invalid == static_pool does not have ownership
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
 </para>
 </listitem>
 </varlistentry>
@@ -3786,21 +4349,20 @@
 reschedules current task until passed callable predicate becomes ready
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
- </para>
- </listitem>
- <listitem>
- <para>
- Nothing.
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">thread_interrupted</phrase></code>,<code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">system</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">system_error</phrase></code>
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Note:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3825,21 +4387,17 @@
 is executed
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
- </para>
- </listitem>
- <listitem>
- <para>
- Nothing.
+ nothing
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Note:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3862,21 +4420,17 @@
 returns true if the current task is executed in a thread-pool
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
- </para>
- </listitem>
- <listitem>
- <para>
- Nothing.
+ nothing
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Note:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3899,21 +4453,17 @@
 returns returns the thread-id of the worker-thread
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
- </para>
- </listitem>
- <listitem>
- <para>
- Nothing.
+ nothing
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Note:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3940,21 +4490,17 @@
 process another task in the meantime
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
- </para>
- </listitem>
- <listitem>
- <para>
- Nothing.
+ nothing
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Note:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -3978,21 +4524,17 @@
 task in the meantime
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
- </para>
- </listitem>
- <listitem>
- <para>
- Nothing.
+ nothing
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Note:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
 </para>
 </listitem>
 </varlistentry>
@@ -4015,59 +4557,379 @@
 task can request interruption for itself
 </para>
 </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Note:</term>
+ <listitem>
+ <para>
+ this function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">this_task</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="boost_task.reference.has_attribute">
+ <title><link linkend="boost_task.reference.has_attribute"> Meta function <code><phrase
+ role="identifier">has_attribute</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">meta</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase> <phrase role="special">></phrase>
+<phrase role="keyword">struct</phrase> <phrase role="identifier">has_attribute</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">mpl</phrase><phrase role="special">::</phrase><phrase role="identifier">bool_</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">is_same</phrase><phrase role="special"><</phrase>
+ <phrase role="identifier">detail</phrase><phrase role="special">::</phrase><phrase role="identifier">has_priority</phrase><phrase role="special">,</phrase>
+ <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase><phrase role="special">::</phrase><phrase role="identifier">scheduler_type</phrase><phrase role="special">::</phrase><phrase role="identifier">priority_tag_type</phrase>
+ <phrase role="special">>::</phrase><phrase role="identifier">value</phrase>
+<phrase role="special">></phrase>
+<phrase role="special">{};</phrase>
+</programlisting>
+ </para>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ returns true if Pool supports attributes (priority-scheduling)
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="boost_task.reference.attribute_type">
+ <title><link linkend="boost_task.reference.attribute_type"> Meta function
+ <code><phrase role="identifier">attribute_type</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">meta</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase> <phrase role="special">></phrase>
+<phrase role="keyword">struct</phrase> <phrase role="identifier">attribute_type</phrase>
+<phrase role="special">{</phrase>
+ <phrase role="keyword">typedef</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase><phrase role="special">::</phrase><phrase role="identifier">scheduler_type</phrase><phrase role="special">::</phrase><phrase role="identifier">attribute_type</phrase> <phrase role="identifier">type</phrase><phrase role="special">;</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ returns type of attribute
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="boost_task.reference.poolsize">
+ <title><link linkend="boost_task.reference.poolsize"> Class <code><phrase role="identifier">poolsize</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">class</phrase> <phrase role="identifier">poolsize</phrase>
+<phrase role="special">{</phrase>
+<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <anchor id="boost_task.reference.poolsize.constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.poolsize.constructor">Constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Preconditions:</term>
+ <listitem>
+ <para>
+ value > 0
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">poolsize</phrase></code> instance
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Postconditions:</term>
+ <listitem>
+ <para>
+ operator std::size_t () > 0
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">invalid_poolsize</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.poolsize.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.poolsize.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ returns the value
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="boost_task.reference.high_watermark">
+ <title><link linkend="boost_task.reference.high_watermark"> Class <code><phrase
+ role="identifier">high_watermark</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">watermark</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">class</phrase> <phrase role="identifier">high_watermark</phrase>
+<phrase role="special">{</phrase>
+<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">high_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <anchor id="boost_task.reference.high_watermark.constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.high_watermark.constructor">Constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">high_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">tp</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">high_watermark</phrase></code> instance
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">invalid_watermark</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.high_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.high_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ returns high watermark
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- [Throws:
+ Nothing
 </para>
 </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="boost_task.reference.low_watermark">
+ <title><link linkend="boost_task.reference.low_watermark"> Class <code><phrase
+ role="identifier">low_watermark</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">watermark</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">class</phrase> <phrase role="identifier">low_watermark</phrase>
+<phrase role="special">{</phrase>
+<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">low_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <anchor id="boost_task.reference.low_watermark.constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.low_watermark.constructor">Constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">low_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">low_watermark</phrase></code> instance
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">invalid_watermark</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.low_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.low_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ returns low watermark
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ Nothing
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="boost_task.reference.scanns">
+ <title><link linkend="boost_task.reference.scanns"> Class <code><phrase role="identifier">scanns</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">scanns</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">class</phrase> <phrase role="identifier">scanns</phrase>
+<phrase role="special">{</phrase>
+<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="keyword">explicit</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
+
+ <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <anchor id="boost_task.reference.scanns.constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.scanns.constructor">Constructor</link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Preconditions:</term>
+ <listitem>
+ <para>
+ value > 0
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Effects:</term>
+ <listitem>
+ <para>
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">scanns</phrase></code> instance
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Postconditions:</term>
+ <listitem>
+ <para>
+ operator std::size_t () > 0
+ </para>
+ </listitem>
+ </varlistentry> <varlistentry><term>Throws:</term>
+ <listitem>
+ <para>
+ <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">invalid_poolsize</phrase></code>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <anchor id="boost_task.reference.scanns.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.scanns.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
+ role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
+ role="special">()</phrase></code></link>
+ </bridgehead>
+
+<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+</programlisting>
+ <variablelist>
+ <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- Nothing.
+ returns the value
 </para>
 </listitem>
- </varlistentry> <varlistentry><term>Note:</term>
+ </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- This function resides in namespace <code><phrase role="identifier">boost</phrase><phrase
- role="special">::</phrase><phrase role="identifier">this_task</phrase></code>.
+ Nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
 </section>
- <section id="boost_task.reference.has_attribute">
- <title><link linkend="boost_task.reference.has_attribute"> Meta function <code><phrase
- role="identifier">has_attribute</phrase></code></link></title>
- <para>
-
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">meta</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">struct</phrase> <phrase role="identifier">has_attribute</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">mpl</phrase><phrase role="special">::</phrase><phrase role="identifier">bool_</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">is_same</phrase><phrase role="special"><</phrase>
- <phrase role="identifier">detail</phrase><phrase role="special">::</phrase><phrase role="identifier">has_priority</phrase><phrase role="special">,</phrase>
- <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase><phrase role="special">::</phrase><phrase role="identifier">scheduler_type</phrase><phrase role="special">::</phrase><phrase role="identifier">priority_tag_type</phrase>
- <phrase role="special">>::</phrase><phrase role="identifier">value</phrase>
-<phrase role="special">></phrase>
-<phrase role="special">{};</phrase>
-</programlisting>
- </para>
- </section>
- <section id="boost_task.reference.attribute_type">
- <title><link linkend="boost_task.reference.attribute_type"> Meta function
- <code><phrase role="identifier">attribute_type</phrase></code></link></title>
- <para>
-
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">meta</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
-
-<phrase role="keyword">template</phrase><phrase role="special"><</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase> <phrase role="special">></phrase>
-<phrase role="keyword">struct</phrase> <phrase role="identifier">attribute_type</phrase>
-<phrase role="special">{</phrase>
- <phrase role="keyword">typedef</phrase> <phrase role="keyword">typename</phrase> <phrase role="identifier">Pool</phrase><phrase role="special">::</phrase><phrase role="identifier">scheduler_type</phrase><phrase role="special">::</phrase><phrase role="identifier">attribute_type</phrase> <phrase role="identifier">type</phrase><phrase role="special">;</phrase>
-<phrase role="special">};</phrase>
-</programlisting>
- </para>
- </section>
 <section id="boost_task.reference.invalid_poolsize">
 <title><link linkend="boost_task.reference.invalid_poolsize"> Class <code><phrase
 role="identifier">invalid_poolsize</phrase></code></link></title>
@@ -4093,15 +4955,15 @@
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- Constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_poolsize</phrase></code> instance.
+ role="identifier">invalid_poolsize</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
@@ -4121,9 +4983,10 @@
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <para>
- heading Constructor]
- </para>
+ <anchor id="boost_task.reference.invalid_scanns.constructor"/>
+ <bridgehead renderas="sect4">
+ <link linkend="boost_task.reference.invalid_scanns.constructor">Constructor</link>
+ </bridgehead>

<programlisting><phrase role="identifier">invalid_scanns</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="keyword">const</phrase><phrase role="special">&</phrase> <phrase role="identifier">msg</phrase><phrase role="special">)</phrase>
</programlisting>
@@ -4131,15 +4994,15 @@
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- Constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_scanns</phrase></code> instance.
+ role="identifier">invalid_scanns</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
@@ -4170,15 +5033,15 @@
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- Constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_timeduration</phrase></code> instance.
+ role="identifier">invalid_timeduration</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
@@ -4209,15 +5072,15 @@
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- Constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_watermark</phrase></code> instance.
+ role="identifier">invalid_watermark</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
@@ -4248,189 +5111,118 @@
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- Constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task_rejected</phrase></code> instance.
+ role="identifier">task_rejected</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
 </section>
- <section id="boost_task.reference.poolsize">
- <title><link linkend="boost_task.reference.poolsize"> Class <code><phrase role="identifier">poolsize</phrase></code></link></title>
+ <section id="boost_task.reference.task_unitialized">
+ <title><link linkend="boost_task.reference.task_unitialized"> Class <code><phrase
+ role="identifier">task_unitialized</phrase></code></link></title>
 <para>

-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">exceptions</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

-<phrase role="keyword">class</phrase> <phrase role="identifier">poolsize</phrase>
+<phrase role="keyword">class</phrase> <phrase role="identifier">task_unitialized</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">logic_error</phrase>
<phrase role="special">{</phrase>
<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
-
- <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">task_unitialized</phrase><phrase role="special">();</phrase>
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.poolsize.constructor"/>
+ <anchor id="boost_task.reference.task_unitialized.constructor"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.poolsize.constructor">Constructor</link>
+ <link linkend="boost_task.reference.task_unitialized.constructor">Constructor</link>
 </bridgehead>

-<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+<programlisting><phrase role="identifier">task_unitialized</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
- <title></title> <varlistentry><term>Preconditions:</term>
- <listitem>
- <para>
- value > 0
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Effects:</term>
+ <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
 constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">poolsize</phrase></code> instance
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Postconditions:</term>
- <listitem>
- <para>
- operator std::size_t () > 0
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Throws:</term>
- <listitem>
- <para>
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_poolsize</phrase></code>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <anchor id="boost_task.reference.poolsize.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
- <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.poolsize.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
- function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
- role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
- role="special">()</phrase></code></link>
- </bridgehead>
-
-<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
-</programlisting>
- <variablelist>
- <title></title> <varlistentry><term>Effects:</term>
- <listitem>
- <para>
- returns the value
+ role="identifier">task_unitialized</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
 </section>
- <section id="boost_task.reference.high_watermark">
- <title><link linkend="boost_task.reference.high_watermark"> Class <code><phrase
- role="identifier">high_watermark</phrase></code></link></title>
+ <section id="boost_task.reference.task_already_executed">
+ <title><link linkend="boost_task.reference.task_already_executed"> Class <code><phrase
+ role="identifier">task_already_executed</phrase></code></link></title>
 <para>

-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">watermark</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">exceptions</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

-<phrase role="keyword">class</phrase> <phrase role="identifier">high_watermark</phrase>
+<phrase role="keyword">class</phrase> <phrase role="identifier">task_already_executed</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">logic_error</phrase>
<phrase role="special">{</phrase>
<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">high_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
-
- <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">task_already_executed</phrase><phrase role="special">();</phrase>
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.high_watermark.constructor"/>
+ <anchor id="boost_task.reference.task_already_executed.constructor"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.high_watermark.constructor">Constructor</link>
+ <link linkend="boost_task.reference.task_already_executed.constructor">Constructor</link>
 </bridgehead>

-<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">high_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+<programlisting><phrase role="identifier">task_already_executed</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
 constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">tp</phrase><phrase role="special">::</phrase><phrase
- role="identifier">high_watermark</phrase></code> instance
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Throws:</term>
- <listitem>
- <para>
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_watermark</phrase></code>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <anchor id="boost_task.reference.high_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
- <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.high_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
- function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
- role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
- role="special">()</phrase></code></link>
- </bridgehead>
-
-<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
-</programlisting>
- <variablelist>
- <title></title> <varlistentry><term>Effects:</term>
- <listitem>
- <para>
- returns high watermark
+ role="identifier">task_already_executed</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
 </section>
- <section id="boost_task.reference.low_watermark">
- <title><link linkend="boost_task.reference.low_watermark"> Class <code><phrase
- role="identifier">low_watermark</phrase></code></link></title>
+ <section id="boost_task.reference.task_moved">
+ <title><link linkend="boost_task.reference.task_moved"> Class <code><phrase
+ role="identifier">task_moved</phrase></code></link></title>
 <para>

-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">watermark</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">exceptions</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

-<phrase role="keyword">class</phrase> <phrase role="identifier">low_watermark</phrase>
+<phrase role="keyword">class</phrase> <phrase role="identifier">task_moved</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">logic_error</phrase>
<phrase role="special">{</phrase>
<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">low_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
-
- <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">task_moved</phrase><phrase role="special">();</phrase>
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.low_watermark.constructor"/>
+ <anchor id="boost_task.reference.task_moved.constructor"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.low_watermark.constructor">Constructor</link>
+ <link linkend="boost_task.reference.task_moved.constructor">Constructor</link>
 </bridgehead>

-<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">low_watermark</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+<programlisting><phrase role="identifier">task_moved</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
@@ -4438,119 +5230,130 @@
 <para>
 constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">low_watermark</phrase></code> instance
+ role="identifier">task_moved</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_watermark</phrase></code>
+ nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.low_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
+ </section>
+ <section id="boost_task.reference.broken_task">
+ <title><link linkend="boost_task.reference.broken_task"> Class <code><phrase
+ role="identifier">broken_task</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">exceptions</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">class</phrase> <phrase role="identifier">broken_task</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">logic_error</phrase>
+<phrase role="special">{</phrase>
+<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="identifier">broken_task</phrase><phrase role="special">();</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <anchor id="boost_task.reference.broken_task.constructor"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.low_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
- function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
- role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
- role="special">()</phrase></code></link>
+ <link linkend="boost_task.reference.broken_task.constructor">Constructor</link>
 </bridgehead>

-<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+<programlisting><phrase role="identifier">broken_task</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- returns low watermark
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">broken_task</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
 </section>
- <section id="boost_task.reference.scanns">
- <title><link linkend="boost_task.reference.scanns"> Class <code><phrase role="identifier">scanns</phrase></code></link></title>
+ <section id="boost_task.reference.task_interrupted">
+ <title><link linkend="boost_task.reference.task_interrupted"> Class <code><phrase
+ role="identifier">task_interrupted</phrase></code></link></title>
 <para>

-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">scanns</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">exceptions</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>

-<phrase role="keyword">class</phrase> <phrase role="identifier">scanns</phrase>
+<phrase role="keyword">class</phrase> <phrase role="identifier">task_interrupted</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">runtime_error</phrase>
<phrase role="special">{</phrase>
<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
- <phrase role="keyword">explicit</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">);</phrase>
-
- <phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase><phrase role="special">;</phrase>
+ <phrase role="identifier">task_interrupted</phrase><phrase role="special">();</phrase>
<phrase role="special">};</phrase>
</programlisting>
 </para>
- <anchor id="boost_task.reference.scanns.constructor"/>
+ <anchor id="boost_task.reference.task_interrupted.constructor"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.scanns.constructor">Constructor</link>
+ <link linkend="boost_task.reference.task_interrupted.constructor">Constructor</link>
 </bridgehead>

-<programlisting><phrase role="keyword">explicit</phrase> <phrase role="identifier">scanns</phrase><phrase role="special">(</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="identifier">value</phrase><phrase role="special">)</phrase>
+<programlisting><phrase role="identifier">task_interrupted</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
- <title></title> <varlistentry><term>Preconditions:</term>
- <listitem>
- <para>
- value > 0
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Effects:</term>
+ <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
 constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
 role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">scanns</phrase></code> instance
- </para>
- </listitem>
- </varlistentry> <varlistentry><term>Postconditions:</term>
- <listitem>
- <para>
- operator std::size_t () > 0
+ role="identifier">task_interrupted</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">invalid_poolsize</phrase></code>
+ nothing
 </para>
 </listitem>
 </varlistentry>
 </variablelist>
- <anchor id="boost_task.reference.scanns.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"/>
+ </section>
+ <section id="boost_task.reference.pool_moved">
+ <title><link linkend="boost_task.reference.pool_moved"> Class <code><phrase
+ role="identifier">pool_moved</phrase></code></link></title>
+ <para>
+
+<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special"><</phrase><phrase role="identifier">boost</phrase><phrase role="special">/</phrase><phrase role="identifier">task</phrase><phrase role="special">/</phrase><phrase role="identifier">exceptions</phrase><phrase role="special">.</phrase><phrase role="identifier">hpp</phrase><phrase role="special">></phrase>
+
+<phrase role="keyword">class</phrase> <phrase role="identifier">pool_moved</phrase> <phrase role="special">:</phrase> <phrase role="keyword">public</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">logic_error</phrase>
+<phrase role="special">{</phrase>
+<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
+ <phrase role="identifier">pool_moved</phrase><phrase role="special">();</phrase>
+<phrase role="special">};</phrase>
+</programlisting>
+ </para>
+ <anchor id="boost_task.reference.pool_moved.constructor"/>
 <bridgehead renderas="sect4">
- <link linkend="boost_task.reference.scanns.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
- function <code><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase
- role="special">::</phrase><phrase role="identifier">size_t</phrase><phrase
- role="special">()</phrase></code></link>
+ <link linkend="boost_task.reference.pool_moved.constructor">Constructor</link>
 </bridgehead>

-<programlisting><phrase role="keyword">operator</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">size_t</phrase> <phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
+<programlisting><phrase role="identifier">pool_moved</phrase><phrase role="special">()</phrase>
</programlisting>
 <variablelist>
 <title></title> <varlistentry><term>Effects:</term>
 <listitem>
 <para>
- returns the value
+ constructs a <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">task</phrase><phrase role="special">::</phrase><phrase
+ role="identifier">pool_moved</phrase></code> instance
 </para>
 </listitem>
 </varlistentry> <varlistentry><term>Throws:</term>
 <listitem>
 <para>
- Nothing
+ nothing
 </para>
 </listitem>
 </varlistentry>
@@ -4625,21 +5428,8 @@
 <itemizedlist>
 <listitem>
 With special support of concurrence and synchronisation abstractions interdepended
- tasks work in <emphasis>thread-pools</emphasis> (using context switching/fibers).
- </listitem>
- </itemizedlist>
- <anchor id="boost_task.appendices.todo.support_of_explicit_processor_bindig"/>
- <bridgehead renderas="sect4">
- <link linkend="boost_task.appendices.todo.support_of_explicit_processor_bindig">Support
- of explicit processor bindig</link>
- </bridgehead>
- <itemizedlist>
- <listitem>
- <emphasis>execution-policies</emphasis> related to a <emphasis>thread-pool</emphasis>
- (like <code><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase
- role="identifier">task</phrase><phrase role="special">::</phrase><phrase
- role="identifier">default_pool</phrase></code>) could support explicit
- processor binding.
+ tasks work in <emphasis>thread-pools</emphasis> without deadlocking the
+ pool.
 </listitem>
 </itemizedlist>
 <anchor id="boost_task.appendices.todo.optimizations"/>
@@ -4655,29 +5445,14 @@
 policies fifo, priority, smart?)
 </listitem>
 </itemizedlist>
- <anchor id="boost_task.appendices.todo.actor_framework"/>
- <bridgehead renderas="sect4">
- <link linkend="boost_task.appendices.todo.actor_framework">Actor framework</link>
- </bridgehead>
- <itemizedlist>
- <listitem>
- framework support of communication and synchronisation between tasks
- </listitem>
- <listitem>
- so called actors provide the required mechanisms
- </listitem>
- <listitem>
- for a detailed explanation read Micorsoft proposal of <ulink url="http://msdn.microsoft.com/en-us/devlabs/dd795202.aspx">Axum</ulink>
- </listitem>
- </itemizedlist>
 </section>
 <section id="boost_task.appendices.acknowledgements">
 <title><link linkend="boost_task.appendices.acknowledgements"> Appendix B:
 Acknowledgments</link></title>
 <para>
- I'd like to thank Vicente J. Botet Escriba for his contributions (default_pool,
- reschedule_until, sleep, yield) and Anthony Williams and Braddock Gaskill
- for their future libraries.
+ I'd like to thank Vicente J. Botet Escriba for his comments and contributions
+ (this_task::reschedule_until, this_task::delay, this_task::yield) as well
+ Anthony Williams and Braddock Gaskill for their future libraries.
 </para>
 </section>
 </section>

Modified: sandbox/task/libs/task/doc/fork_join.qbk
==============================================================================
--- sandbox/task/libs/task/doc/fork_join.qbk (original)
+++ sandbox/task/libs/task/doc/fork_join.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -26,17 +26,19 @@
 if ( n < cutof) return serial_fib( n);
 else
 {
- // fork a sub-task calculating fibonacci(n-1)
+ // create a sub-task calculating fibonacci(n-1)
 boost::task::task< long > t1(
 parallel_fib,
 n - 1,
 cutof);
- // fork a sub-task calculating fibonacci(n-2)
+ // create a sub-task calculating fibonacci(n-2)
 boost::task< long > t2(
 parallel_fib,
 n - 2,
 cutof);

+ // fork both sub-tasks by moving the task
+ // ownership to the thread-pool
 h1 = boost::task::async( boost::move( t1) );
 h2 = boost::task::async( boost::move( t2) );

@@ -56,19 +58,21 @@
>
> pool( boost::task::poolsize( 5) );

- // calculate fibonacci number 10
- // for numbers < 5 do inline serial calculation
+ // compute fibonacci-number 10
+ // for numbers < 5 do inline calculation
 boost::task::task< long > t(
 parallel_fib,
 10,
 5);

- boost::task::handle< long > h( // handle for fibonacci calculation
+ // move task ownership to thread-pool
+ boost::task::handle< long > h(
 boost::task::async(
 boost::move( t),
- pool) ); // execute in the thread-pool
+ pool) );

- std::cout << h.get() << std::endl;
+ // access result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
 }
``

Added: sandbox/task/libs/task/doc/html/boost_task/appendices.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/appendices.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,138 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Appendices</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a>
+</div>
+<div class="section" title="Appendices">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.appendices"></a><a class="link" href="appendices.html" title="Appendices">Appendices</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt> Appendix A: Future development</dt>
+<dt><a href="appendices.html#boost_task.appendices.acknowledgements"> Appendix B:
+ Acknowledgments</a></dt>
+</dl></div>
+<div class="section" title="Appendix A: Future development">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.appendices.todo"></a><a class="link" href="appendices.html#boost_task.appendices.todo" title="Appendix A: Future development"> Appendix A: Future development</a>
+</h3></div></div></div>
+<a name="boost_task.appendices.todo.dynamic_thread_pool"></a><h5>
+<a name="id687757"></a>
+ <a class="link" href="appendices.html#boost_task.appendices.todo.dynamic_thread_pool">Dynamic thread-pool</a>
+ </h5>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">boost::task::dynamic_pool</code> adds or removes worker-threads
+ from the thread-pool depending on the work-load (undersubscription/
+ oversubscription).
+ </li></ul></div>
+<a name="boost_task.appendices.todo.communication_and_synchronisation_abstractions"></a><h5>
+<a name="id687821"></a>
+ <a class="link" href="appendices.html#boost_task.appendices.todo.communication_and_synchronisation_abstractions">Communication
+ and synchronisation abstractions</a>
+ </h5>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+Event variable: A event variable is a
+ bivalued variable (up/down) on which a task can wait for an event to be
+ set or reset. The calling task will be suspended until the state of the
+ event variable is that required by the caller.
+ </li>
+<li class="listitem">
+Buffer: A bounded/unbounded buffer is
+ shared between several tasks. The data must be placed in, and retrieved
+ from, the buffer under mutual exclusion. Condition synchronisation is required
+ because a calling task attempting to place data into the buffer. When the
+ buffer is full, the task must be suspended until there is space int the
+ buffer. Also a retrieving task must be suspended when the buffer is empty.
+ The data, once read, is destroyed.
+ </li>
+<li class="listitem">
+Multicast: The data is sent to a specific
+ group of tasks and all tasks in the group should receive the data. Only
+ when all tasks have received one item of data then another item is allowed
+ to be transmitted.
+ </li>
+<li class="listitem">
+Rendezvous: A rendezvous uses direct naming
+ and synchronous communication between tasks. One task that executes its
+ command first will be delayed until the other tasks is ready to rendezvous.
+ </li>
+<li class="listitem">
+Protected resource: A protected resource
+ is a passive entity that controls access to the internal states (to the
+ controled real resources).
+ </li>
+<li class="listitem">
+Task groups: A task group defines a graph
+ of interdependent tasks that can mostly be run in parallel. The tasks in
+ the group have dependencies or communicate with each other.
+ </li>
+</ul></div>
+<a name="boost_task.appendices.todo.interdepended_task"></a><h5>
+<a name="id687912"></a>
+ <a class="link" href="appendices.html#boost_task.appendices.todo.interdepended_task">Interdepended
+ task</a>
+ </h5>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ With special support of concurrence and synchronisation abstractions interdepended
+ tasks work in thread-pools without deadlocking the
+ pool.
+ </li></ul></div>
+<a name="boost_task.appendices.todo.optimizations"></a><h5>
+<a name="id687943"></a>
+ <a class="link" href="appendices.html#boost_task.appendices.todo.optimizations">Optimizations</a>
+ </h5>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ two-lock-queue as global queue in thread-pool
+</li>
+<li class="listitem">
+ maybe lock-free-queue as global queue too (how to provide the scheduling
+ policies fifo, priority, smart?)
+ </li>
+</ul></div>
+</div>
+<div class="section" title="Appendix B: Acknowledgments">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.appendices.acknowledgements"></a><a class="link" href="appendices.html#boost_task.appendices.acknowledgements" title="Appendix B: Acknowledgments"> Appendix B:
+ Acknowledgments</a>
+</h3></div></div></div>
+
+ I'd like to thank Vicente J. Botet Escriba for his comments and contributions
+ (this_task::reschedule_until, this_task::delay, this_task::yield) as well
+ Anthony Williams and Braddock Gaskill for their future libraries.
+ 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/as_sub_task.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/as_sub_task.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,64 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Execute as sub-task</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="pool.html" title="Thread-pool">
+<link rel="next" href="utilities.html" title="Utilities">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="pool.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="utilities.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Execute as sub-task">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.as_sub_task"></a><a class="link" href="as_sub_task.html" title="Execute as sub-task"> Execute as sub-task</a>
+</h2></div></div></div>
+
+ <code class="computeroutput">boost::task::as_sub_task</code>
+ is a convenient way to execute a sub-task. If the parent
+ task is executed inside a thread-pool the sub-task
+ is put into the local-queue of the worker-thread in the
+ other case the sub-task will be executed in a new thread.
+ <code class="computeroutput">boost::task::as_sub_task</code>
+ is used as default execution-policy for <code class="computeroutput">boost::task::async()</code>,
+ 
+
+
+
+<pre class="programlisting">boost::task::task< long > t( fibonacci, 10);
+
+boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::as_sub_task() ) );
+</pre>
+
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="pool.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="utilities.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/async.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/async.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,91 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Asynchronous execution</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="handle.html" title="Handle">
+<link rel="next" href="own_thread.html" title="Execute in own thread">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="handle.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="own_thread.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Asynchronous execution">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.async"></a><a class="link" href="async.html" title="Asynchronous execution"> Asynchronous execution</a>
+</h2></div></div></div>
+
+ Function <code class="computeroutput">boost::task::async()</code> applies the moved <code class="computeroutput">boost::task::task</code> to the execution-policy
+ which executes the <code class="computeroutput">boost::task::task</code>
+ (for this purpose execution-policy is required to provide
+ <code class="computeroutput">handle<
+ R >
+ operator()(
+ task<
+ R >
+ && t)</code>). <code class="computeroutput">boost::task::async()</code> accepts
+ two arguments - the first is an <code class="computeroutput">boost::task::task</code> object and the second an execution-policy.
+ For the second argument <code class="computeroutput">boost::task::as_sub_task</code> is used per default. The function
+ returns a <code class="computeroutput">boost::task::handle</code>
+ which controls the submitted <code class="computeroutput">boost::task::task</code>.
+ 
+
+
+
+<pre class="programlisting">long fibonacci( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+void main()
+{
+ // task computing fibonacci(10)
+ boost::task< long > t( fibonacci, 10);
+
+ // move the task to executor
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t) );
+
+ // access the result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="handle.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="own_thread.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/handle.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/handle.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,325 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Handle</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="task.html" title="Task">
+<link rel="next" href="async.html" title="Asynchronous execution">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="task.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="async.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Handle">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.handle"></a><a class="link" href="handle.html" title="Handle"> Handle</a>
+</h2></div></div></div>
+
+ The asynchronous-completion-token dispatches tasks in
+ response to the completion of asynchronous operations. asynchronous-completion-token
+ uniquely identifies the task and state necessary to process the result of the
+ operation
+ [<a name="id646812" href="#ftn.id646812" class="footnote">3</a>]
+ .
+ 
+
+ <code class="computeroutput">boost::task::handle</code>
+ represents an asynchronous-completion-token. It will be
+ returned by <a class="link" href="async.html" title="Asynchronous execution"><code class="computeroutput">boost::task::async()</code></a>
+ and is associated with the submitted <code class="computeroutput">boost::task::task</code>.
+ 
+<a name="boost_task.handle.asynchronous_completion_token_interface"></a><h4>
+<a name="id646919"></a>
+ <a class="link" href="handle.html#boost_task.handle.asynchronous_completion_token_interface">Asynchronous
+ completion token interface</a>
+ </h4>
+
+ <code class="computeroutput">boost::task::handle</code>
+ implements an interface in order to check the state of computation and to transfer
+ the result.
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<code class="computeroutput">is_ready()</code>:
+ test if result is set
+ </li>
+<li class="listitem">
+<code class="computeroutput">has_value()</code>:
+ test if value-result is set
+ </li>
+<li class="listitem">
+<code class="computeroutput">has_exception()</code>:
+ test if exception-result is set
+ </li>
+<li class="listitem">
+<code class="computeroutput">get()</code>:
+ return value-result or throw the exception-result
+ </li>
+<li class="listitem">
+<code class="computeroutput">wait()</code>:
+ wait until result is set
+ </li>
+<li class="listitem">
+<code class="computeroutput">wait_for()</code>:
+ wait until result is set or time-duration has elapsed
+ </li>
+<li class="listitem">
+<code class="computeroutput">wait_until()</code>:
+ wait until result ist set or time-point has elapsed
+ </li>
+</ul></div>
+
+
+
+<pre class="programlisting">long fibonacci( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+void main()
+{
+ // create task
+ boost::task::task< long > t( fibonacci, 10);
+
+ // move task ownership to executor
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ std::cout << "is ready == " << std::boolalpha << h.is_ready() << "\n";
+
+ // wait for task completion
+ h.wait();
+
+ std::cout << "has value == " << std::boolalpha << h.has_value() << "\n";
+ std::cout << "has exception == " << std::boolalpha << h.has_exception() << "\n";
+
+ // return result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+<a name="boost_task.handle.task_interruption"></a><h4>
+<a name="id647994"></a>
+ <a class="link" href="handle.html#boost_task.handle.task_interruption">Task interruption</a>
+ </h4>
+
+ Each invokation of <code class="computeroutput">boost::task::async()</code> returns an <code class="computeroutput">boost::task::handle</code> which allows to control the associated
+ <code class="computeroutput">boost::task::task</code>
+ (passed to <code class="computeroutput">boost::task::async()</code>). This includes the ability to interrupt
+ an <code class="computeroutput">boost::task::task</code>
+ if it is cooperative. Cooperative means that the <code class="computeroutput">boost::task::task</code> contains interruption-points
+ or checks for interruption requests
+ [<a name="id648167" href="#ftn.id648167" class="footnote">4</a>]
+ .
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<code class="computeroutput">interrupt()</code>:
+ interrupt <code class="computeroutput">boost::task::task</code> and return immediately
+ </li>
+<li class="listitem">
+<code class="computeroutput">interrupt_and_wait()</code>:
+ interrupt and wait until <code class="computeroutput">boost::task::task</code>
+ was removed from worker-thread
+</li>
+<li class="listitem">
+<code class="computeroutput">interrupt_and_wait_for()</code>:
+ interrupt and wait until <code class="computeroutput">boost::task::task</code>
+ was removed from worker-thread or time duration has
+ elapsed
+ </li>
+<li class="listitem">
+<code class="computeroutput">interrupt_and_wait_until()</code>: interrupt and wait until <code class="computeroutput">boost::task::task</code> was removed from worker-thread
+ or time point has reached
+ </li>
+<li class="listitem">
+<code class="computeroutput">boost::this_thread::interruption_requested()</code>:
+ return bool if interruption was requested
+ </li>
+</ul></div>
+
+
+
+<pre class="programlisting">long cooperative( long n)
+{
+ boost::this_thread::interruption_point(); // interruption point
+
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ if ( boost::this_thread::interruption_requested() ) // check if interruption was requested
+ return;
+
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+
+ boost::this_thread::interruption_point(); // interruption point
+
+ return k1;
+}
+
+void main()
+{
+ // task, to be executed asynchronously
+ boost::task::task< long > t( cooperative, 10);
+
+ // move task to async. executor
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ // interrupt task and wait until task is removed by worker-thread
+ h.interrupt_and_wait();
+
+ std::cout << "is ready == " << std::boolalpha << h.is_ready() << "\n";
+ std::cout << "has value == " << std::boolalpha << h.has_value() << "\n";
+ std::cout << "has exception == " << std::boolalpha << h.has_exception() << "\n";
+
+ // access result
+ // throws boost::task::task_interrupted
+ std::cout << h.get() << std::endl;
+}
+</pre>
+
+ 
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ If the task is still pending (not executed yet) when an interruption is requested
+ - the task is not removed from the queue, it is marked to be interrupted
+ instead.
+ </td></tr>
+</table></div>
+<a name="boost_task.handle.waiting_for_handles"></a><h4>
+<a name="id649489"></a>
+ <a class="link" href="handle.html#boost_task.handle.waiting_for_handles">Waiting for handles</a>
+ </h4>
+
+ Boost.Task provides function <code class="computeroutput">boost::task::waitfor_all()</code> waits for all handles passed to this function
+ to become ready
+ 
+
+
+
+<pre class="programlisting">void main()
+{
+ std::vector handles< boost::task::handle< long > > results;
+ results.reserve( 10);
+
+ for ( int i = 0; i < 10; ++i)
+ {
+ boost::task::task< long > t( fibonacci, i);
+
+ results.push_back(
+ boost::task::async(
+ boost::move( t) ) );
+ }
+
+ // wait until all tasks are ready
+ boost::task::waitfor_all( results.begin(), results.end() );
+
+ int k = 0;
+ std::vector< boost::task::handle< long > >::iterator e( results.end() );
+ for (
+ std::vector< boost::task::handle< long > >::iterator i( results.begin() );
+ i != e;
+ ++i)
+ std::cout << "fibonacci(" << k++ << ") == " << i->get() << std::endl;
+}
+</pre>
+
+ 
+
+ and <code class="computeroutput">boost::task::waitfor_any()</code> which returns if at least one of the passed
+ handles becomes ready.
+ 
+
+
+
+<pre class="programlisting">void main()
+{
+ boost::task::task< long > t1( cooperative, 10);
+ boost::task::task< long > t2( cooperative, 7);
+ boost::task::task< long > t3( cooperative, 5);
+
+ boost::task::handle< long > h1(
+ boost::task::async(
+ boost::move( t1) ) );
+ boost::task::handle< long > h2(
+ boost::task::async(
+ boost::move( t2) ) );
+ boost::task::handle< long > h3(
+ boost::task::async(
+ boost::move( t3) ) );
+
+ // wait for any task becomes ready
+ boost::task::waitfor_any( h1, h2, h3);
+
+ if ( h1.is_ready() )
+ std::cout << "fibonacci(10) == " << h1.get() << std::endl;
+ if ( h2.is_ready() )
+ std::cout << "fibonacci(7) == " << h2.get() << std::endl;
+ if ( h3.is_ready() )
+ std::cout << "fibonacci(5) == " << h3.get() << std::endl;
+}
+</pre>
+
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id646812" href="#id646812" class="para">3</a>] 
+ see <a href="http://www.cs.wustl.edu/~schmidt/PDF/ACT.pdf" target="_top">'Asynchronous
+ Completion Token'</a>, Douglas Schmidt
+ </div>
+<div class="footnote">[<a name="ftn.id648167" href="#id648167" class="para">4</a>] 
+ see 'Interrupt Politely',
+ Herb Sutter
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="task.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="async.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/meta_functions.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/meta_functions.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,69 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Meta functions</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="utilities.html" title="Utilities">
+<link rel="next" href="reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="utilities.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Meta functions">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.meta_functions"></a><a class="link" href="meta_functions.html" title="Meta functions"> Meta functions</a>
+</h2></div></div></div>
+
+ If the thread-pool supports attributes (like priorities)
+ <code class="computeroutput">boost::task::has_attribute</code>
+ evaluates to <code class="computeroutput">true</code> at compile-time
+ (derived from boost::mpl::bool_). The type of the attribute is determined by
+ <code class="computeroutput">boost::task::attribute_type</code>.
+ 
+
+
+
+<pre class="programlisting">// thread-pool with priority scheduling
+// type of priority is int
+typdef boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::priority< int >
+ >
+> pool_type;
+
+// test if thread-pool supports priorities at compile time
+std::cout << std::boolalpha << boost::task::has_attribute< pool_type >::value << "\n";
+
+// access the type used for priority
+std::cout << typeid( boost::task::attribute_type< pool_type >::type).name() << std::endl;
+</pre>
+
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="utilities.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/motivation.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/motivation.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,264 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Motivation</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="next" href="task.html" title="Task">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="task.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Motivation">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.motivation"></a><a class="link" href="motivation.html" title="Motivation"> Motivation</a>
+</h2></div></div></div>
+
+ To speed-up computer-bound work and/or increase the computation-throughput
+ is a common motivation for parallelizing a program. Especially for interactive
+ applications that have to process user input while performing some background
+ tasks responsivness is very important. Parallelizing a program requires partitioning
+ the program into smaller chunks that can run in parallel. The code can scale
+ as the hardware gets better without changing the code.
+ 
+
+ The evolution from one-core to many-core architectures and the usage of threads
+ (of course processes fit too) support this paradigm.
+ 
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ “You can have multithreading on a single core machine, but you can
+ only have parallelism on a multi core machine ... .” -- Daniel Moth
+ [<a name="id640350" href="#ftn.id640350" class="footnote">1</a>]
+ </td></tr>
+</table></div>
+
+ Boost.Task provides a framework to utilize
+ the available hardware and provide a way for efficient asynchronous processing
+ of time consuming operations. The framework provides some execution-policies,
+ like <code class="computeroutput">boost::task::new_thread</code>,
+ in order to execute the task asynchronously in another execution context (Boost.Task uses preemptible threads for this purpose).
+ 
+
+
+
+<pre class="programlisting">void print( std::string const& msg)
+{ printf("%s\n", msg.c_str() ); }
+
+void main()
+{
+ // task, to be executed asynchronously
+ boost::task::task< void > t( print, "Hello World!");
+
+ // execute task in newly-created thread
+ // move task ownership to executor
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+}
+</pre>
+
+ 
+
+ In order to manage the task <code class="computeroutput">boost::task::async()</code> returns
+ a <code class="computeroutput">boost::task::handle</code>
+ (associated with the submitted task). It functions as a asynchronous-completion-token
+ - that means it transfers the result of the execution back to the caller thread.
+ 
+
+
+
+<pre class="programlisting">std::string echo( std::string const& msg)
+{ return msg; }
+
+void main()
+{
+ // task returning the submitted string
+ boost::task::task< std::string > t( echo, "Hello World!");
+
+ // execute task in newly-created thread
+ // move task ownership to executor
+ boost::task::handle< std::string > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ // wait until task has finished and return the result
+ std::cout << h.get() << std::endl;
+}
+</pre>
+
+ 
+
+ The task can also be interrupted via <code class="computeroutput">boost::task::handle</code> if it is a so-called <a class="link" href="task.html" title="Task">cooperative
+ task</a>.
+ 
+
+
+
+<pre class="programlisting">void long_running( boost::posix_time::time_duration const& rel_time)
+{ boost::this_thread::sleep( rel_time);
+
+void main()
+{
+ // create a long runing task
+ boost::task::task< void > t( long_running, boost::posix_time::millisec( 500) );
+
+ // execute task in newly-created thread
+ // move task ownership to executor
+ boost::task::handle< std::string > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ // requests interruption of task
+ // returns immediately
+ h.interrupt();
+
+ // access the result
+ // task_interrupted exeception will be thrown
+ std::cout << h.get() << std::endl;
+}
+</pre>
+
+ 
+
+ Beside <code class="computeroutput">boost::task::new_thread</code>
+ (which creates a new task for each submitted task - the thread will be joined
+ by <code class="computeroutput">boost::task::handle</code>)
+ Boost.Task provides <a class="link" href="pool.html" title="Thread-pool">thread-pools</a>
+ to prevent the overhead of thread creation and destruction of threads for each
+ task (thread-pools can be customized).
+ 
+
+
+
+<pre class="programlisting">long serial_fib( long n)
+{
+ if( n < 2) return n;
+ else return serial_fib( n - 1) + serial_fib( n - 2);
+}
+
+long parallel_fib( long n, long cutof)
+{
+ if ( n < cutof) return serial_fib( n);
+ else
+ {
+ // create a sub-task calculating fibonacci(n-1)
+ boost::task::task< long > t1(
+ parallel_fib,
+ n - 1,
+ cutof);
+ // create a sub-task calculating fibonacci(n-2)
+ boost::task::task< long > t2(
+ parallel_fib,
+ n - 2,
+ cutof);
+
+ // fork two sub-tasks
+ boost::task::handle< long > h1(
+ boost::task::async(
+ boost::move( t1),
+ boost::this_task::get_pool() ) );
+ boost::task::handle< long > h2(
+ boost::task::async(
+ boost::move( t2),
+ boost::this_task::get_pool() ) );
+
+ // join the results of both sub-tasks
+ return h1.get() + h2.get();
+ }
+}
+
+void main()
+{
+ // create a thread-pool with five worker-threads
+ boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+ > pool( boost::task::poolsize( 5) );
+
+ // create task computing fibonacci-number for 10
+ boost::task::task< long > t(
+ parallel_fib,
+ 10,
+ 5);
+
+ // execute task in a thread-pool
+ // move task ownership to executor
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ pool) );
+
+ // access the result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+
+ With function <code class="computeroutput">boost::this_task::runs_in_pool()</code>
+ a task can detect if it is executed inside a thread-pool.
+ sub-tasks arecreated by <code class="computeroutput">boost::task::as_sub_task</code>. Where the sub-task
+ is executed by a new thread if the parent task is not executed inside a thread-pool.
+ In the other case the sub-task is put into the local
+ worker-queue which enables <a class="link" href="pool.html#boost_task.pool.work_stealing" title="Work-Stealing">work-stealing</a>
+ and <a class="link" href="pool.html#boost_task.pool.forkjoin" title="Fork/Join">inline execution</a> of tasks.
+ 
+
+
+
+<pre class="programlisting">// create a long runing task
+boost::task::task< long > t(
+ parallel_fib,
+ 10,
+ 5);
+
+// move task ownership to executor
+// sub-task executed in a new thread or inside the thread-pool
+boost::task::async(
+ boost::move( t),
+ boost::task::as_sub_task() );
+</pre>
+
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id640350" href="#id640350" class="para">1</a>] 
+ more to read at Daniel's blog
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="task.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/new_thread.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/new_thread.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,115 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Execute in new thread</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="own_thread.html" title="Execute in own thread">
+<link rel="next" href="pool.html" title="Thread-pool">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="own_thread.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="pool.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Execute in new thread">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.new_thread"></a><a class="link" href="new_thread.html" title="Execute in new thread"> Execute in new thread</a>
+</h2></div></div></div>
+
+ <code class="computeroutput">boost::task::new_thread</code>
+ creates a new <code class="computeroutput">boost::thread</code> and executes the task in this thread
+ (asynchronous). The created thread gets joined by handle (so N2802
+ should be addressed). The returned <code class="computeroutput">boost::task::handle</code> joins the thread in its destructor
+ (if the last reference gets out of scope) .
+ 
+
+
+
+<pre class="programlisting">long fibonacci( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+void main()
+{
+ boost::task::task< long > t( fibonacci, 10);
+
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+<div class="caution" title="Caution"><table border="0" summary="Caution">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../../../doc/html/images/caution.png"></td>
+<th align="left">Caution</th>
+</tr>
+<tr><td align="left" valign="top">
+ Always store the returned asynchronous-completion-token
+ in a variable because <code class="computeroutput">boost::task::handle</code>
+ joins the thread in its destructor (if the last reference gets out of scope).
+ </td></tr>
+</table></div>
+
+ In the example below both <code class="computeroutput">a_function()</code> and <code class="computeroutput">another_function()</code> are executed synchron because the returned
+ <code class="computeroutput">boost::task::handle</code>
+ is not stored in a variable. Thatswhy the worker-thread
+ is joined after return from <code class="computeroutput">boost::task::async()</code>!
+ 
+
+
+
+<pre class="programlisting">boost::task::task< void > t1( a_function);
+boost::task::task< void > t2( another_function);
+
+// handles are not retrieved
+// both task executed in sequence
+boost::task::async(
+ boost::move( t1),
+ boost::task::new_thread() ) );
+boost::task::async(
+ boost::move( t2),
+ boost::task::new_thread() ) );
+</pre>
+
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="own_thread.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="pool.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/own_thread.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/own_thread.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,80 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Execute in own thread</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="async.html" title="Asynchronous execution">
+<link rel="next" href="new_thread.html" title="Execute in new thread">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="async.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="new_thread.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Execute in own thread">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.own_thread"></a><a class="link" href="own_thread.html" title="Execute in own thread"> Execute in own thread</a>
+</h2></div></div></div>
+
+ <code class="computeroutput">boost::task::own_thread</code>
+ executes the task in the current thread (synchronous execution - concerns of
+ N2802
+ do not aply).
+ 
+
+
+
+<pre class="programlisting">long fibonacci( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+void main()
+{
+ boost::task::task< long > t( fibonacci, 10);
+
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::own_thread() ) );
+
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="async.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="new_thread.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/pool.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/pool.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,707 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Thread-pool</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="new_thread.html" title="Execute in new thread">
+<link rel="next" href="as_sub_task.html" title="Execute as sub-task">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="new_thread.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="as_sub_task.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Thread-pool">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.pool"></a><a class="link" href="pool.html" title="Thread-pool"> Thread-pool</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt> Static thread-pool</dt>
+<dt> Channel</dt>
+<dt> Scheduling</dt>
+<dt> Pool shutdown</dt>
+<dt> Processor binding</dt>
+<dt> Work-Stealing</dt>
+<dt> Fork/Join</dt>
+</dl></div>
+
+ Instead of creating a new thread and quickly throwing it away after the task
+ is done, the overhead related to thread creation and destruction can be avoided
+ by running the work-items on a thread-pool
+ (reusing an existing worker-thread instead).
+ 
+
+ A thread-pool maintains a queue (or queues) of work-items
+ to be done, and a pool of worker-threads which execute
+ work-items from the queue(s).
+ 
+
+ Boost.Task provides <code class="computeroutput">boost::task::async()</code> with
+ support of executing an <code class="computeroutput">boost::task::task</code> in thread-pool:
+ 
+
+
+
+<pre class="programlisting">std::string echo( std::string const& msg)
+{ return msg; }
+
+void main()
+{
+ // create a thread-pool with
+ // five worker-threads
+ // FIFO schduling of queued tasks
+ // and unlimited size of internal queue
+ boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+ > pool( boost::task::poolsize( 5) );
+
+ // create task
+ boost::task::task< std::string > t( echo, "Hello World!");
+
+ // move task to executor
+ // let the task be executed by the thread-pool
+ boost::task::handle< std::string > h(
+ boost::task::async(
+ boost::move( t),
+ pool) );
+
+ // access the result
+ std::cout << h.get() << std::endl;
+}
+</pre>
+
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../doc/html/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ Tasks should not be too small (performance overhead dominates) and avoid
+ blocking tasks
+ [<a name="id655144" href="#ftn.id655144" class="footnote">5</a>]
+ .
+ </td></tr>
+</table></div>
+<div class="section" title="Static thread-pool">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.static_pool"></a><a class="link" href="pool.html#boost_task.pool.static_pool" title="Static thread-pool"> Static thread-pool</a>
+</h3></div></div></div>
+
+ Boost.Task provides <code class="computeroutput">boost::task::static_pool</code>
+ - which contains an fixed set of pre-forked worker-threads
+ (the size of the pool doesn't change during its lifetime). <code class="computeroutput">boost::task::static_pool</code> supports move semantics.
+ 
+
+
+
+<pre class="programlisting">boost::task::_static_pool< // pool type
+ boost::task::unbounded_channel< // queuing policy (unbounded_channel, bounded_channel)
+ boost::task::fifo // scheduling policy (fifo, priority, smart)
+ >
+> pool(
+ boost::task::poolsize( 6), // pool with 6 pre-forked worker-threads
+ boost::posix_time::posix_time::milliseconds( 50), // time to sleep if no work-item available
+ boost::task::scanns( 10) ); // iterations over local-queues before sleep
+</pre>
+
+ 
+
+ The first argument of the constructor specifies how many worker-threads
+ the pool will contain. The second and third argument are used by the <a class="link" href="pool.html#boost_task.pool.work_stealing" title="Work-Stealing">work-stealing</a>
+ algorithm.
+ 
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ If <code class="computeroutput">boost::task::bounded_channel</code> is used as queuing policy
+ the constructor has two additional arguments .
+ </td></tr>
+</table></div>
+
+ <code class="computeroutput">boost::task::static_pool</code> provides functionality to check
+ the status of the pool - <code class="computeroutput">close()</code> returns true when the pool was shutdown
+ and <code class="computeroutput">active()</code>
+ as well as <code class="computeroutput">idle()</code>
+ returning how many worker-threads are active (executing
+ a task) or idle. The size of the pool can be accessed over <code class="computeroutput">size()</code>.
+ 
+
+ For informational pruposes <code class="computeroutput">empty()</code> and <code class="computeroutput">pending()</code> can be used in order to know if the global
+ task-queue is empty or how many tasks are waiting for execution. With <code class="computeroutput">clear()</code>
+ all tasks are removed from the global-queue.
+ 
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ <code class="computeroutput">pending()</code>
+ does not count tasks in the local-queues of the worker-threads.
+ </td></tr>
+</table></div>
+</div>
+<div class="section" title="Channel">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.channel"></a><a class="link" href="pool.html#boost_task.pool.channel" title="Channel"> Channel</a>
+</h3></div></div></div>
+
+ The channel synchronizes the access between non-pool threads (application
+ threads) and worker-threads and implements a queuing
+ policy (limitation of queued tasks).
+ 
+<a name="boost_task.pool.channel._code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__task__phrase__phrase_role__special______phrase__phrase_role__identifier__bounded_channel__phrase___code_"></a><h5>
+<a name="id655776"></a>
+ <a class="link" href="pool.html#boost_task.pool.channel._code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__task__phrase__phrase_role__special______phrase__phrase_role__identifier__bounded_channel__phrase___code_"><code class="computeroutput">boost::task::bounded_channel</code></a>
+ </h5>
+
+ <code class="computeroutput">boost::task::bounded_channel</code> contains a single lock
+ in order to synchronize access to the queue. The number of pending tasks
+ is limited in order to prevent resource exhaustion. For this purpose a high-
+ and low-watermark has to be passed at construction. <code class="computeroutput">boost::task::high_watermark</code>
+ sets the maximum of pending tasks. If this limited is reached all threads
+ which submit a task will be set to sleep (blocked). If it is equal to <code class="computeroutput">boost::task::low_watermark</code> everytime a sleeping producer
+ thread will be woken up and puts its task if one worker thread has taken
+ a task from the channel. <code class="computeroutput">boost::task::low_watermark</code>
+ sets the threshold when blocked threads get woken up. If it is less than
+ <code class="computeroutput">boost::task::high_watermark</code> all sleeping producer threads
+ will be woken up if the amount of pending tasks reaches <code class="computeroutput">boost::task::low_watermark</code>.
+ 
+<a name="boost_task.pool.channel._code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__task__phrase__phrase_role__special______phrase__phrase_role__identifier__unbounded_channel__phrase___code_"></a><h5>
+<a name="id656008"></a>
+ <a class="link" href="pool.html#boost_task.pool.channel._code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__task__phrase__phrase_role__special______phrase__phrase_role__identifier__unbounded_channel__phrase___code_"><code class="computeroutput">boost::task::unbounded_channel</code></a>
+ </h5>
+
+ <code class="computeroutput">boost::task::unbounded_channel</code> contains a single lock
+ in order to synchronize access to the queue. An unlimited number of tasks
+ can be queued into this channel. The insertion of an <code class="computeroutput">boost::task::task</code>
+ will never block. If the channel becomes empty worker-threads
+ will be set to sleep until new tasks are enqueued.
+ 
+</div>
+<div class="section" title="Scheduling">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.scheduling"></a><a class="link" href="pool.html#boost_task.pool.scheduling" title="Scheduling"> Scheduling</a>
+</h3></div></div></div>
+
+ The scheduling policy determines how tasks are scheduled inside the channel.
+ 
+<a name="boost_task.pool.scheduling.fifo"></a><h5>
+<a name="id656149"></a>
+ <a class="link" href="pool.html#boost_task.pool.scheduling.fifo">fifo</a>
+ </h5>
+
+ First inserted pending <code class="computeroutput">boost::task::task</code>
+ gets taken first.
+ 
+<a name="boost_task.pool.scheduling.priority"></a><h5>
+<a name="id656201"></a>
+ <a class="link" href="pool.html#boost_task.pool.scheduling.priority">priority</a>
+ </h5>
+
+ Each <code class="computeroutput">boost::task::task</code> is submitted to the pool with a priority
+ attribute. The type and ordering of the priority is user-defined.
+ 
+
+
+
+<pre class="programlisting">// thread-pool with priority scheduling
+// tasks with higher priority are
+// scheduled first
+boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::priority< int > >
+> pool( boost::task::poolsize( 5) );
+
+boost::task::task< void > t1( some_fn);
+boost::task::task< void > t2( another_fn);
+
+// move task t1 with priority 5 to thread-pool
+boost::task::async(
+ boost::move( t1),
+ 5,
+ pool);
+
+// move task t2 with priority 3 to thread-pool
+boost::task::async(
+ boost::move( t2),
+ 3,
+ pool);
+</pre>
+
+ 
+
+ In this example the tasks get scheduled by the assigned integer (third argument
+ of <code class="computeroutput">boost::task::async()</code>).
+ The <code class="computeroutput">boost::task::task</code> with the lowest priority gets scheduled
+ first (taken by a worker-thread). The ordering can be
+ changed by the second argument of <code class="computeroutput">boost::task::priority</code>
+ (the default is <code class="computeroutput">std::greater< Attr ></code>).
+ 
+
+
+
+<pre class="programlisting">// thread-pool with priority scheduling
+// tasks with lower priority are
+// scheduled first
+boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::priority< int, std::less< int > >
+ >
+> pool( boost::task::poolsize( 5) );
+</pre>
+
+ 
+<a name="boost_task.pool.scheduling.smart"></a><h5>
+<a name="id657077"></a>
+ <a class="link" href="pool.html#boost_task.pool.scheduling.smart">smart</a>
+ </h5>
+
+ Each inserted <code class="computeroutput">boost::task::task</code> is associated with an attribute. The
+ scheduler gets an put- and take-policy as template arguments. The corresponding
+ policy gets applied for each insertion and removal.
+ 
+
+ Boost.Task provides <code class="computeroutput">boost::task::replace_oldest</code>
+ as put- policy and <code class="computeroutput">boost::task::take_oldest</code>
+ as take-policy. Both policies allow the replacement of older (pending) tasks
+ in the scheduler by new ones.
+ 
+
+
+
+<pre class="programlisting">long fibonacci_fn( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+typedef boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::smart<
+ int,
+ std::less< int >,
+ boost::task::replace_oldest,
+ boost::task::take_oldest
+ >
+ >
+> pool_type;
+
+void main()
+{
+ pool_type pool( boost::task::poolsize( 1) );
+
+ ...
+
+ boost::task::task< long > t1(
+ boost::bind( fibonacci_fn, 10) );
+ boost::task::task< long > t2(
+ boost::bind( fibonacci_fn, 5) );
+
+ // replaced by later task with same attribute == 2
+ // if still pending in pool
+ boost::task::async(
+ boost::move( t1),
+ 2,
+ pool);
+
+ // will replace previous pending task with attribute == 2
+ boost::task::async(
+ boost::move( t2),
+ 2,
+ pool);
+}
+</pre>
+
+ 
+</div>
+<div class="section" title="Pool shutdown">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.pool_shutdown"></a><a class="link" href="pool.html#boost_task.pool.pool_shutdown" title="Pool shutdown"> Pool shutdown</a>
+</h3></div></div></div>
+
+ Boost.Task allows to shutdown a thread-pool
+ explicitly via functions <code class="computeroutput">shutdown()</code> and <code class="computeroutput">shutdown_now()</code>. The destructor of the pool calls <code class="computeroutput">shutdown()</code>
+ if not already done so that all worker-threads are joined
+ and the topic of N2802
+ should be addressed.
+ 
+<a name="boost_task.pool.pool_shutdown.shutdown"></a><h5>
+<a name="id658313"></a>
+ <a class="link" href="pool.html#boost_task.pool.pool_shutdown.shutdown">Shutdown</a>
+ </h5>
+
+ If <code class="computeroutput">shutdown()</code>
+ is called - the the pool is set the closed state and all worker-threads
+ are joined until all pending tasks are processed. No futher tasks can be
+ submitted.
+ 
+
+
+
+<pre class="programlisting">long fibonacci_fn( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+typedef boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+> pool_type;
+
+void main()
+{
+ pool_type pool( boost::task::poolsize( 1) );
+
+ ...
+
+ boost::task::task< long > t1( fibonacci_fn, 10);
+ boost::task::task< long > t2( fibonacci_fn, 5);
+
+ boost::task::handle< long > h1(
+ boost::task::async(
+ boost::move( t1),
+ pool) );
+ boost::task::handle< long > h2(
+ boost::task::async(
+ boost::move( t2),
+ pool) );
+
+ // waits until all pending tasks are finished
+ pool.shutdown();
+
+ std::cout << "fibonacci(10) == " << h1.get() << "\n";
+ std::cout << "fibonacci(5) == " << h2.get() << std::endl;
+}
+</pre>
+
+ 
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ The deconstructor calls <code class="computeroutput">shutdown()</code> if the pool was not shutdown yet.
+ </td></tr>
+</table></div>
+<a name="boost_task.pool.pool_shutdown.shutdown_immediatly"></a><h5>
+<a name="id659496"></a>
+ <a class="link" href="pool.html#boost_task.pool.pool_shutdown.shutdown_immediatly">Shutdown
+ immediatly</a>
+ </h5>
+
+ The function <code class="computeroutput">shutdown_now()</code> closes the pool, interrupts and then joins
+ all worker-threads. Pending tasks are unprocessed.
+ 
+
+
+
+<pre class="programlisting">long fibonacci_fn( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+typedef boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+> pool_type;
+
+void main()
+{
+ pool_type pool( boost::task::poolsize( 1) );
+
+ ...
+
+ boost::task::task< long > t1( fibonacci_fn, 10);
+ boost::task::task< long > t2( fibonacci_fn, 5);
+
+ boost::task::handle< long > h1(
+ boost::task::async(
+ boost::move( t1),
+ pool) );
+ boost::task::handle< long > h2(
+ boost::task::async(
+ boost::move( t2),
+ pool) );
+
+ // requests task interruption and
+ // joins all worker-threads
+ pool.shutdown_now();
+
+ // accessing the result may throw task_interrupted
+ std::cout << "fibonacci(10) == " << h1.get() << "\n";
+ std::cout << "fibonacci(5) == " << h2.get() << std::endl;
+}
+</pre>
+
+ 
+</div>
+<div class="section" title="Processor binding">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.processor_binding"></a><a class="link" href="pool.html#boost_task.pool.processor_binding" title="Processor binding"> Processor binding</a>
+</h3></div></div></div>
+
+ For some applications it is convenient to bind the worker-threads
+ to processors/cores of the system. For this purpose <code class="computeroutput">bind_to_processors()</code> must be given to constructor instead <code class="computeroutput">boost::task::poolsize</code> so that a worker-thread
+ is created an bound the the core.
+ 
+
+
+
+<pre class="programlisting">typedef boost::task::static_pool<
+ boost::task::unbounded_channel< boost::tp::fifo >
+> pool_type;
+
+// constructs thread-pool with worker-threads as
+// CPUs/Cores are available on the system
+pool_type pool( pool_type::bind_to_processors() );
+</pre>
+
+ 
+
+ The constructor takes additional arguments for the <a class="link" href="pool.html#boost_task.pool.work_stealing" title="Work-Stealing">work-stealing
+ algorithm</a> and <a class="link" href="pool.html#boost_task.pool.channel" title="Channel">high-</a>
+ and <a class="link" href="pool.html#boost_task.pool.channel" title="Channel">low-watermark</a> too.
+ 
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Boost.Task does provide this feature only
+ for Windows, Linux, AIX, HP-UX, Solaris and FreeBSD.
+ </td></tr>
+</table></div>
+</div>
+<div class="section" title="Work-Stealing">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.work_stealing"></a><a class="link" href="pool.html#boost_task.pool.work_stealing" title="Work-Stealing"> Work-Stealing</a>
+</h3></div></div></div>
+
+ Traditional thread-pools do not scale because they use
+ a single global-queue protected by a global-lock. The frequency at which
+ worker-threads aquire the global-lock becomes a limiting
+ factor for the throughput if:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ the tasks become smaller
+ </li>
+<li class="listitem">
+ more processors are added
+ </li>
+</ul></div>
+
+ A work-stealing algorithm can be used to solve this
+ problem. It uses a special kind of queue which has two ends, and allows lock-free
+ pushes and pops from the private end (accessed by the
+ worker-thread owning the queue), but requires synchronization
+ from the public end (accessed by the other worker-threads).
+ Synchronization is necessary when the queue is sufficiently small that private
+ and public operations could conflict.
+ 
+
+ The pool contains one global-queue (<code class="computeroutput">boost::task::bounded_channel</code>
+ or <code class="computeroutput">boost::task::unbounded_channel</code>) protected by a global-lock
+ and each worker-thread has its own private local worker-queue.
+ If work is enqueued by a worker-thread the <code class="computeroutput">boost::task::task</code> is stored in the worker queue. If
+ the work is enqueued by a application thread it goes into the global queue.
+ When worker-threads are looking for work, they have
+ following search order:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ look into the private worker-queue - tasks can be dequeued without locks
+ </li>
+<li class="listitem">
+ look in the global-queue - locks are used for synchronization
+ </li>
+<li class="listitem">
+ check other worker-queues ('stealing' tasks from private worker queues
+ of other worker-threads) - requires locks
+ </li>
+</ul></div>
+
+ For a lot of recursively queued tasks (so called sub-tasks),
+ the use of a worker-queue per thread substantially reduces the synchronization
+ necessary to complete the work. There are also fewer cache effects due to
+ sharing of the global-queue information.
+ 
+
+ Operations on the private worker queue are executed in LIFO order and operations
+ on worker queues of other worker-threads in FIFO order
+ (steals).
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ There are chances that memory is still hot in the cache, if the tasks are
+ pushed in LIFO order into the private worker queue.
+ </li>
+<li class="listitem">
+ If a worker-thread steals work in FIFO order, increases
+ the chances that a larger 'chunk' of work will be stolen (the need for
+ other steals will be possibly reduced). Because the sub-tasks
+ are stored in LIFO order, the oldest items are closer to the public
+ end of the queue (forming a tree). Stealing such an older <code class="computeroutput">boost::task::task</code> also steals a (probably) larger
+ subtree of tasks unfolded if the stolen work item get executed. Since a
+ sub-task is just part of a larger <code class="computeroutput">boost::task::task</code>,
+ we don’t need to worry about execution order.
+ </li>
+</ul></div>
+</div>
+
+ / Copyright Oliver Kowalke 2009. Distributed under the Boost Software License,
+ Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt
+ ]
+ 
+<div class="section" title="Fork/Join">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.pool.forkjoin"></a><a class="link" href="pool.html#boost_task.pool.forkjoin" title="Fork/Join"> Fork/Join</a>
+</h3></div></div></div>
+
+ Fork/Join algorithms are recursive divide-and-conquer algorithms which repeatedly
+ splitt into sub-tasks until they become small enough to solve using simple,
+ short sequential methods, so that they run in parallel on multiple cores.
+ 
+
+ The fork operation creates new sub-tasks which can run
+ in parallel. The current <code class="computeroutput">boost::task::task</code>
+ is not proceeded in the join operation until the forked sub-tasks
+ have completed. In the meantime the worker-thread executes
+ other tasks from its local worker-queue.
+ 
+
+
+
+<pre class="programlisting">long serial_fib( long n)
+{
+ if( n < 2) return n;
+ else return serial_fib( n - 1) + serial_fib( n - 2);
+}
+
+long parallel_fib( long n, long cutof)
+{
+ if ( n < cutof) return serial_fib( n);
+ else
+ {
+ // create a sub-task calculating fibonacci(n-1)
+ boost::task::task< long > t1(
+ parallel_fib,
+ n - 1,
+ cutof);
+ // create a sub-task calculating fibonacci(n-2)
+ boost::task< long > t2(
+ parallel_fib,
+ n - 2,
+ cutof);
+
+ // fork both sub-tasks by moving the task
+ // ownership to the thread-pool
+ h1 = boost::task::async( boost::move( t1) );
+ h2 = boost::task::async( boost::move( t2) );
+
+ // join the results of both sub-tasks
+ // if one of the both sub-tasks is not ready
+ // the worker-thread does not block, it executes other
+ // task from its local-queue
+ return h1.get() + h2.get();
+ }
+}
+
+void main()
+{
+ boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+ > pool( boost::task::poolsize( 5) );
+
+ // compute fibonacci-number 10
+ // for numbers < 5 do inline calculation
+ boost::task::task< long > t(
+ parallel_fib,
+ 10,
+ 5);
+
+ // move task ownership to thread-pool
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ pool) );
+
+ // access result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id655144" href="#id655144" class="para">5</a>] 
+ see <a href="http://www.ddj.com/go-parallel/article/showArticle.jhtml?articleID=216500409" target="_top">'Use
+ Thread Pools Correctly'</a>, Herb Sutter
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="new_thread.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="as_sub_task.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/reference.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/reference.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,2752 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Reference</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="meta_functions.html" title="Meta functions">
+<link rel="next" href="appendices.html" title="Appendices">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="meta_functions.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="appendices.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Reference">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.reference"></a><a class="link" href="reference.html" title="Reference"> Reference</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt> Class template task</dt>
+<dt> Class template handle</dt>
+<dt><a href="reference.html#boost_task.reference.async"> Non-member function <code class="computeroutput">async( task< R >
+ &&, EP)</code></a></dt>
+<dt><a href="reference.html#boost_task.reference.async1"> Non-member function <code class="computeroutput">async( task< R >
+ &&, pool< Channel > &)</code></a></dt>
+<dt><a href="reference.html#boost_task.reference.async2"> Non-member function <code class="computeroutput">async( task< R >
+ &&, Attr, pool<
+ Channel >
+ &)</code></a></dt>
+<dt> Class own_thread</dt>
+<dt> Class new_thread</dt>
+<dt> Class template static_pool</dt>
+<dt><a href="reference.html#boost_task.reference.reschedule_until"> Non-member function
+ <code class="computeroutput">reschedule_until()</code></a></dt>
+<dt><a href="reference.html#boost_task.reference.get_pool"> Non-member function
+ <code class="computeroutput">get_pool()</code></a></dt>
+<dt><a href="reference.html#boost_task.reference.runs_in_pool"> Non-member function
+ <code class="computeroutput">runs_in_pool()</code></a></dt>
+<dt><a href="reference.html#boost_task.reference.worker_id"> Non-member function
+ <code class="computeroutput">worker_id()</code></a></dt>
+<dt> Non-member function delay()</dt>
+<dt> Non-member function yield()</dt>
+<dt><a href="reference.html#boost_task.reference.interrupt"> Non-member function
+ <code class="computeroutput">interrupt()</code></a></dt>
+<dt> Meta function has_attribute</dt>
+<dt><a href="reference.html#boost_task.reference.attribute_type"> Meta function
+ <code class="computeroutput">attribute_type</code></a></dt>
+<dt> Class poolsize</dt>
+<dt> Class high_watermark</dt>
+<dt> Class low_watermark</dt>
+<dt> Class scanns</dt>
+<dt> Class invalid_poolsize</dt>
+<dt> Class invalid_scanns</dt>
+<dt> Class invalid_timeduration</dt>
+<dt> Class invalid_watermark</dt>
+<dt> Class task_rejected</dt>
+<dt> Class task_unitialized</dt>
+<dt> Class task_already_executed</dt>
+<dt> Class task_moved</dt>
+<dt> Class broken_task</dt>
+<dt> Class task_interrupted</dt>
+<dt> Class pool_moved</dt>
+</dl></div>
+<div class="section" title="Class template task">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.task"></a><a class="link" href="reference.html#boost_task.reference.task" title="Class template task"> Class template <code class="computeroutput">task</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/task.hpp>
+
+template< typename R >
+class task : private noncopyable
+{
+public:
+ task();
+
+ task( R( * fn)());
+
+ template< typename Fn >
+ task( Fn fn);
+
+ template< typename Fn, typename A0 >
+ task( Fn fn, A0 a0);
+ ...
+ template< typename Fn, typename A0, ..., typename A9 >
+ task( Fn fn, A0 a0, ..., A9 a9);
+
+ task( task && t);
+ task & operator=( task && t);
+ task && move();
+
+ shared_future< R > & get_future();
+
+ void operator()();
+
+ template< typename Cb >
+ void set_wait_callback( Cb const& cb);
+
+ void swap( task< R > & other);
+
+ operator unspecified_bool_type() const;
+ bool operator!() const;
+};
+</pre>
+
+ 
+<a name="boost_task.reference.task.default_constructor"></a><h5>
+<a name="id664852"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.default_constructor">Default constructor</a>
+ </h5>
+<pre class="programlisting">task()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs an unitialized <code class="computeroutput">boost::task::task< R ></code>
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.constructor__function_pointer_"></a><h5>
+<a name="id664962"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.constructor__function_pointer_">Constructor
+ (function pointer)</a>
+ </h5>
+<pre class="programlisting">task( R( * fn)());
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task<
+ R ></code>
+ from a function pointer
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.constructor__functor_"></a><h5>
+<a name="id665099"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.constructor__functor_">Constructor
+ (functor)</a>
+ </h5>
+<pre class="programlisting">template< typename Fn >
+task( Fn const& fn)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task<
+ R ></code>
+ from a function object
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.constructor__functor_with_arguments_"></a><h5>
+<a name="id665262"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.constructor__functor_with_arguments_">Constructor
+ (functor with arguments)</a>
+ </h5>
+<pre class="programlisting">template< typename Fn, typename A0 >
+task( Fn fn, A0 a0);
+...
+template< typename Fn, typename A0, ..., typename A9 >
+task( Fn fn, A0 a0, ..., A9 a9);
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task<
+ R ></code>
+ from a function object and its arguments
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.move_copy_constructor"></a><h5>
+<a name="id665578"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.move_copy_constructor">Move-copy
+ constructor</a>
+ </h5>
+<pre class="programlisting">task( task &&)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task<
+ R ></code>
+ from another task taking over the ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.move_assignment_operator"></a><h5>
+<a name="id665699"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.move_assignment_operator">Move-assignment
+ operator</a>
+ </h5>
+<pre class="programlisting">task & operator=( task &&)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task<
+ R ></code>
+ from another task taking over the ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.member_function__code__phrase_role__identifier__move__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id665833"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.member_function__code__phrase_role__identifier__move__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">move()</code></a>
+ </h5>
+<pre class="programlisting">task && move()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ moves task releasing the ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.member_function__code__phrase_role__identifier__get_future__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id665927"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.member_function__code__phrase_role__identifier__get_future__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">get_future()</code></a>
+ </h5>
+<pre class="programlisting">shared_future< R > & get_future()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns a future assiciated with the task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special________phrase___code_"></a><h5>
+<a name="id666036"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special________phrase___code_">Member
+ function <code class="computeroutput">operator()()</code></a>
+ </h5>
+<pre class="programlisting">void operator()()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ executes task's internal function object
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.member_template_function__code__phrase_role__identifier__set_wait_callback__phrase__phrase_role__special_____phrase___phrase_role__identifier__cb__phrase___phrase_role__identifier__cons__phrase__phrase_role__special___amp____phrase___code_"></a><h5>
+<a name="id666123"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.member_template_function__code__phrase_role__identifier__set_wait_callback__phrase__phrase_role__special_____phrase___phrase_role__identifier__cb__phrase___phrase_role__identifier__cons__phrase__phrase_role__special___amp____phrase___code_">Member
+ template-function <code class="computeroutput">set_wait_callback( Cb cons&)</code></a>
+ </h5>
+<pre class="programlisting">template< typename Cb >
+void set_wait_callback( Cb const cb&);
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ stores callback function object which will be called if task would block
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp____phrase___code_"></a><h5>
+<a name="id666281"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp____phrase___code_">Member
+ function <code class="computeroutput">swap(
+ task<
+ R >
+ &)</code></a>
+ </h5>
+<pre class="programlisting">void swap( task< R > & other)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ swaps the task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id666441"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_">operator
+ <code class="computeroutput">operator unspecified_bool_type()</code></a>
+ </h5>
+<pre class="programlisting">operator unspecified_bool_type() const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ is task valid == does task own ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_"></a><h5>
+<a name="id666540"></a>
+ <a class="link" href="reference.html#boost_task.reference.task.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_">operator
+ <code class="computeroutput">operator!()</code></a>
+ </h5>
+<pre class="programlisting">bool operator!() const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ is task invalid == task does not have ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class template handle">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.handle"></a><a class="link" href="reference.html#boost_task.reference.handle" title="Class template handle"> Class template <code class="computeroutput">handle</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/handle.hpp>
+
+template< typename R >
+class handle
+{
+ handle();
+
+ void interrupt();
+ void interrupt_and_wait();
+ void interrupt_and_wait_until( system_time const& abs_time);
+ template< typename Duration >
+ void interrupt_and_wait_for( Duration const& rel_time);
+ bool interruption_requested();
+
+ R get();
+ bool is_ready() const;
+ bool has_value() const;
+ bool has_exception() const;
+ void wait() const;
+
+ shared_future< R > & get_future();
+
+ void swap( handle< R > & other);
+};
+
+template< typename Iterator >
+friend void waitfor_all( Iterator begin, Iterator end);
+
+template< typename T1, typename T2 >
+friend void waitfor_all( T1 & t1, T2 & t2);
+...
+template< typename T1, typename T2, typename T3, typename T4, typename T5 >
+friend void waitfor_all( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3, handle< T4 > & t4, handle< T5 > & t5);
+
+template< typename Iterator >
+friend Iterator waitfor_any( Iterator begin, Iterator end);
+
+template< typename T1, typename T2 >
+friend unsigned int waitfor_any( handle< T1 > & t1, handle< T2 > & t2);
+...
+template< typename T1, typename T2, typename T3, typename T4, typename T5 >
+friend unsigned int waitfor_any( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3, handle< T4 > & t4, handle< T5 > & t5);
+</pre>
+
+ 
+<a name="boost_task.reference.handle.constructor"></a><h5>
+<a name="id668168"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">handle()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs an empty (invalid) handle
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__interruption_requested__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id668235"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__interruption_requested__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">interruption_requested()</code></a>
+ </h5>
+<pre class="programlisting">bool interruption_requested()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ checks if interruption is already requested
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id668323"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">interrupt()</code></a>
+ </h5>
+<pre class="programlisting">void interrupt()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ requests task interruption; doesn not block (immediatly returns)
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt_and_wait__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id668412"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt_and_wait__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">interrupt_and_wait()</code></a>
+ </h5>
+<pre class="programlisting">void interrupt_and_wait()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ requests task interruption and blocks until worker-thread stops task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt_and_wait_until__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id668520"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt_and_wait_until__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">interrupt_and_wait_until()</code></a>
+ </h5>
+<pre class="programlisting">bool interrupt_and_wait_until( system_time const& abs_time)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ requests task interruption and blocks until worker-thread stops task
+ or time-point elapsed
+ </dd>
+<dt>Returns:</dt>
+<dd>
+ false if the the time specified by abs_time was reached, true otherwise
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt_and_wait_for__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id668667"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__interrupt_and_wait_for__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">interrupt_and_wait_for()</code></a>
+ </h5>
+<pre class="programlisting">template< typename Duration >
+bool interrupt_and_wait_for( Duration const& rel_time)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ requests task interruption and blocks until worker-thread stops task
+ or time-duration elapsed
+ </dd>
+<dt>Returns:</dt>
+<dd>
+ false if the the time specified by rel_time was reached, true otherwise
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__get__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id668841"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__get__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">get()</code></a>
+ </h5>
+<pre class="programlisting">R get()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ requests the result
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_interrupted</code>, <code class="computeroutput">boost::task::task_uninialized</code>,
+ <code class="computeroutput">boost::task::task_rejected</code>, <code class="computeroutput">boost::task::broken_task</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id669042"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__wait__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">wait()</code></a>
+ </h5>
+<pre class="programlisting">void wait()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ blocks caller until task is done
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_interrupted</code>, <code class="computeroutput">boost::task::task_uninialized</code>,
+ <code class="computeroutput">boost::task::task_rejected</code>, <code class="computeroutput">boost::task::broken_task</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_for__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id669243"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_for__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">wait_for()</code></a>
+ </h5>
+<pre class="programlisting">template< typename Duration >
+bool wait_for( Duration const& rel_time) const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ blocks caller until task is done
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_interrupted</code>, <code class="computeroutput">boost::task::task_uninialized</code>,
+ <code class="computeroutput">boost::task::task_rejected</code>, <code class="computeroutput">boost::task::broken_task</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_until__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id669504"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__wait_until__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">wait_until()</code></a>
+ </h5>
+<pre class="programlisting">bool wait_until( system_time const& abs_time) const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ blocks caller until task is done
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_interrupted</code>, <code class="computeroutput">boost::task::task_uninialized</code>,
+ <code class="computeroutput">boost::task::task_rejected</code>, <code class="computeroutput">boost::task::broken_task</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__is_ready__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id669738"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__is_ready__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">is_ready()</code></a>
+ </h5>
+<pre class="programlisting">bool is_ready()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ checks if task is done
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__has_value__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id669825"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__has_value__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">has_value()</code></a>
+ </h5>
+<pre class="programlisting">bool has_value()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ checks if task is done and a result value is set
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__has_exception__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id669913"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__has_exception__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">has_exception()</code></a>
+ </h5>
+<pre class="programlisting">bool has_exception()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ checks if task is done and an exception is set
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__get_future__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id670002"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__get_future__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">get_future()</code></a>
+ </h5>
+<pre class="programlisting">shared_future< R > & get_future()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns a reference to the internal shared_future< R >
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id670112"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.member_function__code__phrase_role__identifier__swap__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">swap()</code></a>
+ </h5>
+<pre class="programlisting">void swap( handle< R > & other)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ swapps handle
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.non_member_function__code__phrase_role__identifier__wait_for_all__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id670238"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.non_member_function__code__phrase_role__identifier__wait_for_all__phrase__phrase_role__special______phrase___code_">Non-member
+ function <code class="computeroutput">wait_for_all()</code></a>
+ </h5>
+<pre class="programlisting">template< typename Iterator >
+void waitfor_all( Iterator begin, Iterator end);
+
+template< typename T1, typename T2 >
+void waitfor_all( T1 & t1, T2 & t2);
+
+template< typename T1, typename T2, typename T3 >
+void waitfor_all( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3);
+
+template< typename T1, typename T2, typename T3, typename T4 >
+void waitfor_all( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3, handle< T4 > & t4);
+
+template< typename T1, typename T2, typename T3, typename T4, typename T5 >
+void waitfor_all( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3, handle< T4 > & t4, handle< T5 > & t5);
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ waits for all handles to become ready
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_interrupted</code>, <code class="computeroutput">boost::task::task_rejected</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.handle.non_member_function__code__phrase_role__identifier__wait_for_any__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id671259"></a>
+ <a class="link" href="reference.html#boost_task.reference.handle.non_member_function__code__phrase_role__identifier__wait_for_any__phrase__phrase_role__special______phrase___code_">Non-member
+ function <code class="computeroutput">wait_for_any()</code></a>
+ </h5>
+<pre class="programlisting">template< typename Iterator >
+Iterator waitfor_any( Iterator begin, Iterator end);
+
+template< typename T1, typename T2 >
+unsigned int waitfor_any( handle< T1 > & t1, handle< T2 > & t2);
+
+template< typename T1, typename T2, typename T3 >
+unsigned int waitfor_any( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3);
+
+template< typename T1, typename T2, typename T3, typename T4 >
+unsigned int waitfor_any( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3, handle< T4 > & t4);
+
+template< typename T1, typename T2, typename T3, typename T4, typename T5 >
+unsigned int waitfor_any( handle< T1 > & t1, handle< T2 > & t2, handle< T3 > & t3, handle< T4 > & t4, handle< T5 > & t5);
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ waits for any handle to become ready
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_interrupted</code>, <code class="computeroutput">boost::task::task_rejected</code>,
+ <code class="computeroutput">std::bad_alloc</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function async( task< R > &&, EP)">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.async"></a><a class="link" href="reference.html#boost_task.reference.async" title="Non-member function async( task< R > &&, EP)"> Non-member function <code class="computeroutput">async( task< R >
+ &&, EP)</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/async.hpp>
+
+template< typename R, typename EP >
+handle< R > async( task< R > && t, EP ep);
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ moves task to an asyncrounous executer and returns a handle associated
+ with the task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function async( task< R > &&, pool< Channel > &)">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.async1"></a><a class="link" href="reference.html#boost_task.reference.async1" title="Non-member function async( task< R > &&, pool< Channel > &)"> Non-member function <code class="computeroutput">async( task< R >
+ &&, pool< Channel > &)</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/async.hpp>
+
+template< typename R, typename Channel >
+handle< R > async( task< R > && t, pool< Channel > & ep);
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ moves task into a thread-pool and returns a handle associated with the
+ task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_rejected</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function async( task< R > &&, Attr, pool< Channel > &)">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.async2"></a><a class="link" href="reference.html#boost_task.reference.async2" title="Non-member function async( task< R > &&, Attr, pool< Channel > &)"> Non-member function <code class="computeroutput">async( task< R >
+ &&, Attr, pool<
+ Channel >
+ &)</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/async.hpp>
+
+template< typename R, typename Channel, typename Attr >
+handle< R > async( task< R > && t, Attr attr, pool< Channel > & ep);
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ moves attributed task into a thread-pool and returns a handle associated
+ with the task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_rejected</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class own_thread">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.own_thread"></a><a class="link" href="reference.html#boost_task.reference.own_thread" title="Class own_thread"> Class <code class="computeroutput">own_thread</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/async.hpp>
+
+struct own_thread
+{
+ template< typename R >
+ handle< R > operator()( task< R > && t);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.own_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_"></a><h5>
+<a name="id673593"></a>
+ <a class="link" href="reference.html#boost_task.reference.own_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_">Member
+ function <code class="computeroutput">operator()(
+ task<
+ R >
+ &&)</code></a>
+ </h5>
+<pre class="programlisting">template< typename R >
+handle< R > operator()( task< R > && t)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ moves task in the current thread an returns an handle associated with
+ the task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class new_thread">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.new_thread"></a><a class="link" href="reference.html#boost_task.reference.new_thread" title="Class new_thread"> Class <code class="computeroutput">new_thread</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/async.hpp>
+
+struct new_thread
+{
+ template< typename R >
+ handle< R > operator()( task< R > &&);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.new_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_"></a><h5>
+<a name="id673985"></a>
+ <a class="link" href="reference.html#boost_task.reference.new_thread.member_function__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_">Member
+ function <code class="computeroutput">operator()(
+ task<
+ R >
+ &&)</code></a>
+ </h5>
+<pre class="programlisting">template< typename R >
+handle< R > operator()( task< R > && t)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ moves task in a new thread an returns an handle associated with the task
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class template static_pool">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.static_pool"></a><a class="link" href="reference.html#boost_task.reference.static_pool" title="Class template static_pool"> Class template <code class="computeroutput">static_pool</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting"> #include <boost/task/static_pool.hpp>
+
+ template< typename Channel >
+ class static_pool : private noncopyable
+ {
+ public:
+ static_pool();
+
+ explicit static_pool(
+ poolsize const& psize,
+ posix_time::time_duration const& asleep = posix_time::microseconds( 10),
+ scanns const& scns = scanns( 20) );
+
+ explicit static_pool(
+ poolsize const& psize,
+ high_watermark const& hwm,
+ low_watermark const& lwm,
+ posix_time::time_duration const& asleep = posix_time::milliseconds( 100),
+ scanns const& scns = scanns( 20) );
+
+ static_pool( static_pool &&);
+
+ static_pool & operator=( static_pool &&);
+
+# if defined(BOOST_HAS_PROCESSOR_BINDINGS)
+ explicit static_pool(
+ <<unspec-type>>,
+ posix_time::time_duration const& asleep = posix_time::microseconds( 10),
+ scanns const& scns = scanns( 20) );
+
+ explicit static_pool(
+ <<unspec-type>>,
+ high_watermark const& hwm,
+ low_watermark const& lwm,
+ posix_time::time_duration const& asleep = posix_time::milliseconds( 100),
+ scanns const& scns = scanns( 20) );
+
+ static <<unspec-type>> bind_to_processors();
+# endif
+
+ ~static_pool();
+
+ std::size_t size();
+ std::size_t active();
+ std::size_t idle();
+
+ void shutdown();
+ void shutdown_now();
+
+ void interrupt_all_worker();
+
+ bool closed();
+ void clear();
+ bool empty();
+ std::size_t pending();
+
+ const std::size_t upper_bound();
+ void upper_bound( high_watermark const& hwm);
+ const std::size_t lower_bound();
+ void lower_bound( low_watermark const& lwm);
+
+ template< typename R >
+ handle< R > submit( task< R > && t);
+
+ template< typename R, typename Attr >
+ handle< R > submit( task< R > && t, Attr const& attr);
+
+ void swap( static_pool & other);
+
+ operator unspecified_bool_type() const;
+ bool operator!() const;
+ };
+</pre>
+
+ 
+<a name="boost_task.reference.static_pool.default_constructor"></a><h5>
+<a name="id675921"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.default_constructor">Default
+ constructor</a>
+ </h5>
+<pre class="programlisting">static_pool()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs an unitialized pool
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.constructor__unbounded_channel_"></a><h5>
+<a name="id675988"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.constructor__unbounded_channel_">Constructor
+ (unbounded channel)</a>
+ </h5>
+<pre class="programlisting">explicit static_pool(
+ <<unspec-type>>,
+ posix_time::time_duration const& asleep = posix_time::microseconds( 10),
+ scanns const& scns = scanns( 20) )
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ operating system provides functionality for processor binding
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ constructs a pool - for each processor a worker-thread is created and
+ bound to one processor - global-queue can queue an unlimited number of
+ tasks
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>, <code class="computeroutput">boost::task::invalid_scanns</code>, <code class="computeroutput">boost::task::invalid_timeduration</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ constructor has to be called if a unbounded-channel is used and <code class="computeroutput">bind_to_processors()</code>
+ must be set as first argument
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.constructor__unbounded_channel_poolsize_"></a><h5>
+<a name="id676321"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.constructor__unbounded_channel_poolsize_">Constructor
+ (unbounded channel/poolsize)</a>
+ </h5>
+<pre class="programlisting">explicit static_pool(
+ poolsize const& psize,
+ posix_time::time_duration const& asleep = posix_time::microseconds( 10),
+ scanns const& scns = scanns( 20) )
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a pool containing psize worker-threads - global-queue can
+ queue an unlimited number of tasks
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>, <code class="computeroutput">boost::task::invalid_scanns</code>, <code class="computeroutput">boost::task::invalid_timeduration</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ constructor has to be called if a unbounded-channel is used
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.constructor__bounded_channel_"></a><h5>
+<a name="id676627"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.constructor__bounded_channel_">Constructor
+ (bounded channel)</a>
+ </h5>
+<pre class="programlisting">explicit static_pool(
+ <<unspec-type>>,
+ high_watermark const& hwm,
+ low_watermark const& lwm,
+ posix_time::time_duration const& asleep = posix_time::milliseconds( 100),
+ scanns const& scns = scanns( 20) )
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ operating system provides functionality for processor binding
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ constructs a pool - for each processor a worker-thread is created and
+ bound to one processor - global-queue can only queue a limited number
+ of tasks
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>, <code class="computeroutput">boost::task::invalid_scanns</code>, <code class="computeroutput">boost::task::invalid_timeduration</code>,
+ <code class="computeroutput">boost::task::invalid_watermark</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ constructor has to be called if a bounded-channel is used and <code class="computeroutput">bind_to_processors()</code>
+ must be set as first argument
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.constructor__bounded_channel_poolsize_"></a><h5>
+<a name="id677040"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.constructor__bounded_channel_poolsize_">Constructor
+ (bounded channel/poolsize)</a>
+ </h5>
+<pre class="programlisting">explicit static_pool(
+ poolsize const& psize,
+ high_watermark const& hwm,
+ low_watermark const& lwm,
+ posix_time::time_duration const& asleep = posix_time::milliseconds( 100),
+ scanns const& scns = scanns( 20) )
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a pool containing psize worker-threads - global-queue can
+ only queue a limited number of tasks
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_resource_error</code>, <code class="computeroutput">boost::task::invalid_scanns</code>, <code class="computeroutput">boost::task::invalid_timeduration</code>,
+ <code class="computeroutput">boost::task::invalid_watermark</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ constructor has to be called if a bounded-channel is used
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.move_copy_constructor"></a><h5>
+<a name="id677427"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.move_copy_constructor">Move-copy
+ constructor</a>
+ </h5>
+<pre class="programlisting">static_pool( static_pool &&)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ creates an pool out of another one which gets zeroed out
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.move_assigment_constructor"></a><h5>
+<a name="id677504"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.move_assigment_constructor">Move-assigment
+ constructor</a>
+ </h5>
+<pre class="programlisting">static_pool & operator=( static_pool &&)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ creates an pool out of another one which gets zeroed out
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.destructor"></a><h5>
+<a name="id677594"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.destructor">Destructor</a>
+ </h5>
+<pre class="programlisting">~static_pool()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ calls <code class="computeroutput">shutdown()</code>
+ if not already called
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.static_member_function__code__phrase_role__identifier__bind_to_processors__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id677681"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.static_member_function__code__phrase_role__identifier__bind_to_processors__phrase__phrase_role__special______phrase___code_">Static
+ member function <code class="computeroutput">bind_to_processors()</code></a>
+ </h5>
+<pre class="programlisting"><<unspec-type>> bind_to_processors()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ used in order to let the pool create worker-threads as cores are available
+ and bound the threads to the cores
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__size__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id677789"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__size__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">size()</code></a>
+ </h5>
+<pre class="programlisting">std::size_t size()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns how many worker-threads are running in the pool
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__active__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id677915"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__active__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">active()</code></a>
+ </h5>
+<pre class="programlisting">std::size_t active()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns how many worker-threads are active (executing an task)
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__idle__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678039"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__idle__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">idle()</code></a>
+ </h5>
+<pre class="programlisting">std::size_t idle()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns how many worker-threads are idle (not executing an task).
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ the value is the difference of <code class="computeroutput">size()</code> and <code class="computeroutput">active()</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__shutdown__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678207"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__shutdown__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">shutdown()</code></a>
+ </h5>
+<pre class="programlisting">void shutdown()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ deactivates the channel and joins all worker-threads - the pool is closed
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_interrupted</code>, <code class="computeroutput">boost::system::system_error</code>,
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ all pending tasks are processed
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__shutdown_now__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678384"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__shutdown_now__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">shutdown_now()</code></a>
+ </h5>
+<pre class="programlisting">void shutdown_now()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ deactivates the channel, send interruption request to all worker-threads
+ and joins them - the pool is closed
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_interrupted</code>, <code class="computeroutput">boost::system::system_error</code>,
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ pending tasks are not processed but returned
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__interrupt_all_worker__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678561"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__interrupt_all_worker__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">interrupt_all_worker()</code></a>
+ </h5>
+<pre class="programlisting">void interrupt_all_worker()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ interrupts all worker-threads without invalidating the pool
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__closed__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678650"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__closed__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">closed()</code></a>
+ </h5>
+<pre class="programlisting">bool closed()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ queries if the pool is closed (pool is shutdown)
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__clear__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678766"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__clear__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">clear()</code></a>
+ </h5>
+<pre class="programlisting">void clear()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ removes all pending tasks from the channel
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__empty__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678882"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__empty__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">empty()</code></a>
+ </h5>
+<pre class="programlisting">bool empty()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ queries if the channel is empty
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__pending__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id678998"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__pending__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">pending()</code></a>
+ </h5>
+<pre class="programlisting">std::size_t pending()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ queries how many tasks are pending (still unprocessed) in the global-queue
+ (channel)
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__upper_bound__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id679123"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__upper_bound__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">upper_bound()</code></a>
+ </h5>
+<pre class="programlisting">std::size_t upper_bound()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ channel is of type bounded-channel
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ returns the upper bound of the bounded-channel
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ can only be used if a bounded-channel is used
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__upper_bound__phrase__phrase_role__special_____phrase___phrase_role__identifier__high_watermark__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__hwm__phrase__phrase_role__special_____phrase___code_"></a><h5>
+<a name="id679272"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__upper_bound__phrase__phrase_role__special_____phrase___phrase_role__identifier__high_watermark__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__hwm__phrase__phrase_role__special_____phrase___code_">Member
+ function <code class="computeroutput">upper_bound(
+ high_watermark const& hwm)</code></a>
+ </h5>
+<pre class="programlisting">void upper_bound( high_watermark const& hwm)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ channel is of type bounded-channel
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ sets the upper bound of the bounded-channel
+ </dd>
+<dt>Postconditions:</dt>
+<dd>
+ <code class="computeroutput">this->upper_bound()
+ == hwm</code>
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::invalid_watermark</code>, <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ can only be used if a bounded-channel is used
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__lower_bound__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id679549"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__lower_bound__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">lower_bound()</code></a>
+ </h5>
+<pre class="programlisting">std::size_t lower_bound();
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ channel is of type bounded-channel
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ returns the lower bound of the bounded-channel
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ can only be used if a bounded-channel is used
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__lower_bound__phrase__phrase_role__special_____phrase___phrase_role__identifier__low_watermark__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__lwm__phrase__phrase_role__special_____phrase___code_"></a><h5>
+<a name="id679699"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__lower_bound__phrase__phrase_role__special_____phrase___phrase_role__identifier__low_watermark__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__lwm__phrase__phrase_role__special_____phrase___code_">Member
+ function <code class="computeroutput">lower_bound(
+ low_watermark const& lwm)</code></a>
+ </h5>
+<pre class="programlisting">void lower_bound( low_watermark const& lwm)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ channel is of type bounded-channel
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ sets the lower bound of the bounded-channel
+ </dd>
+<dt>Postconditions:</dt>
+<dd>
+ <code class="computeroutput">this->lower_bound()
+ == lwm</code>
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::invalid_watermark</code>, <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+<dt>Notes:</dt>
+<dd>
+ can only be used if a bounded-channel is used
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_"></a><h5>
+<a name="id679974"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___code_">Member
+ function <code class="computeroutput">submit(
+ task<
+ R >
+ &&)</code></a>
+ </h5>
+<pre class="programlisting">template< typename R >
+handle< R > submit( task< R > && t)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ has_attribute< pool >::value == false && ! closed()
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ moves an task to the pool and returns an associated handle
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_rejected</code>, <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___phrase_role__identifier__attr__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__attr__phrase__phrase_role__special_____phrase___code_"></a><h5>
+<a name="id680249"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function__code__phrase_role__identifier__submit__phrase__phrase_role__special_____phrase___phrase_role__identifier__task__phrase__phrase_role__special___lt___phrase___phrase_role__identifier__r__phrase___phrase_role__special___gt___phrase___phrase_role__special___amp__amp____phrase___phrase_role__identifier__attr__phrase___phrase_role__keyword__const__phrase__phrase_role__special___amp___phrase___phrase_role__identifier__attr__phrase__phrase_role__special_____phrase___code_">Member
+ function <code class="computeroutput">submit(
+ task<
+ R >
+ &&, Attr
+ const&
+ attr)</code></a>
+ </h5>
+<pre class="programlisting">template< typename R, typename Attr >
+handle< R > submit( task< R > && t, Attr const& attr)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ has_attribute< pool >::value == true && ! closed()
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ moves an task to the pool and returns an associated handle - task is
+ scheduled by the attribute
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::task_rejected</code>, <code class="computeroutput">boost::task::pool_moved</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.member_function_swap__static_pool__amp___"></a><h5>
+<a name="id680595"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.member_function_swap__static_pool__amp___">Member
+ function swap( static_pool &)`</a>
+ </h5>
+<pre class="programlisting">void swap( static_pool & other)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ swaps pool
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id680691"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__unspecified_bool_type__phrase__phrase_role__special______phrase___code_">operator
+ <code class="computeroutput">operator unspecified_bool_type()</code></a>
+ </h5>
+<pre class="programlisting">operator unspecified_bool_type() const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ is static_pool valid == does static_pool own ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_"></a><h5>
+<a name="id680791"></a>
+ <a class="link" href="reference.html#boost_task.reference.static_pool.operator__code__phrase_role__keyword__operator__phrase__phrase_role__special_______phrase___code_">operator
+ <code class="computeroutput">operator!()</code></a>
+ </h5>
+<pre class="programlisting">bool operator!() const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ is static_pool invalid == static_pool does not have ownership
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function reschedule_until()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.reschedule_until"></a><a class="link" href="reference.html#boost_task.reference.reschedule_until" title="Non-member function reschedule_until()"> Non-member function
+ <code class="computeroutput">reschedule_until()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+template< typename Pred >
+void reschedule_until( Pred const&)
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ reschedules current task until passed callable predicate becomes ready
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::thread_interrupted</code>,<code class="computeroutput">boost::system::system_error</code>
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function get_pool()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.get_pool"></a><a class="link" href="reference.html#boost_task.reference.get_pool" title="Non-member function get_pool()"> Non-member function
+ <code class="computeroutput">get_pool()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+template< typename Pool >
+Pool & get_pool()
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns reference to the thread-pool where the current worker thread
+ is executed
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function runs_in_pool()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.runs_in_pool"></a><a class="link" href="reference.html#boost_task.reference.runs_in_pool" title="Non-member function runs_in_pool()"> Non-member function
+ <code class="computeroutput">runs_in_pool()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+bool runs_in_pool()
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns true if the current task is executed in a thread-pool
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function worker_id()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.worker_id"></a><a class="link" href="reference.html#boost_task.reference.worker_id" title="Non-member function worker_id()"> Non-member function
+ <code class="computeroutput">worker_id()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+id worker_id()
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns returns the thread-id of the worker-thread
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function delay()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.delay"></a><a class="link" href="reference.html#boost_task.reference.delay" title="Non-member function delay()"> Non-member function <code class="computeroutput">delay()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+void delay( system_time abs_time)
+
+template< typename Duration >
+void delay( Duration const& rel_time)
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ delays the execution of the current task so that the worker-thread can
+ process another task in the meantime
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function yield()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.yield"></a><a class="link" href="reference.html#boost_task.reference.yield" title="Non-member function yield()"> Non-member function <code class="computeroutput">yield()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+void yield()
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ yields the current task so that the worker-threadcan process another
+ task in the meantime
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Non-member function interrupt()">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.interrupt"></a><a class="link" href="reference.html#boost_task.reference.interrupt" title="Non-member function interrupt()"> Non-member function
+ <code class="computeroutput">interrupt()</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/utility.hpp>
+
+void interrupt()
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ task can request interruption for itself
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+<dt>Note:</dt>
+<dd>
+ this function resides in namespace <code class="computeroutput">boost::this_task</code>
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Meta function has_attribute">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.has_attribute"></a><a class="link" href="reference.html#boost_task.reference.has_attribute" title="Meta function has_attribute"> Meta function <code class="computeroutput">has_attribute</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/meta.hpp>
+
+template< typename Pool >
+struct has_attribute : public mpl::bool_<
+ is_same<
+ detail::has_priority,
+ typename Pool::scheduler_type::priority_tag_type
+ >::value
+>
+{};
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns true if Pool supports attributes (priority-scheduling)
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Meta function attribute_type">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.attribute_type"></a><a class="link" href="reference.html#boost_task.reference.attribute_type" title="Meta function attribute_type"> Meta function
+ <code class="computeroutput">attribute_type</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/meta.hpp>
+
+template< typename Pool >
+struct attribute_type
+{
+ typedef typename Pool::scheduler_type::attribute_type type;
+};
+</pre>
+
+ 
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns type of attribute
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class poolsize">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.poolsize"></a><a class="link" href="reference.html#boost_task.reference.poolsize" title="Class poolsize"> Class <code class="computeroutput">poolsize</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/poolsize.hpp>
+
+class poolsize
+{
+public:
+ explicit poolsize( std::size_t value);
+
+ operator std::size_t () const;
+};
+</pre>
+
+ 
+<a name="boost_task.reference.poolsize.constructor"></a><h5>
+<a name="id682905"></a>
+ <a class="link" href="reference.html#boost_task.reference.poolsize.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">explicit poolsize( std::size_t value)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ value > 0
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::poolsize</code> instance
+ </dd>
+<dt>Postconditions:</dt>
+<dd>
+ operator std::size_t () > 0
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::invalid_poolsize</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.poolsize.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id596678"></a>
+ <a class="link" href="reference.html#boost_task.reference.poolsize.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">operator std::size_t()</code></a>
+ </h5>
+<pre class="programlisting">operator std::size_t () const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns the value
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class high_watermark">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.high_watermark"></a><a class="link" href="reference.html#boost_task.reference.high_watermark" title="Class high_watermark"> Class <code class="computeroutput">high_watermark</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/watermark.hpp>
+
+class high_watermark
+{
+public:
+ explicit high_watermark( std::size_t value);
+
+ operator std::size_t () const;
+};
+</pre>
+
+ 
+<a name="boost_task.reference.high_watermark.constructor"></a><h5>
+<a name="id683462"></a>
+ <a class="link" href="reference.html#boost_task.reference.high_watermark.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">explicit high_watermark( std::size_t value)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::tp::high_watermark</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::invalid_watermark</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.high_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id683614"></a>
+ <a class="link" href="reference.html#boost_task.reference.high_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">operator std::size_t()</code></a>
+ </h5>
+<pre class="programlisting">operator std::size_t () const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns high watermark
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class low_watermark">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.low_watermark"></a><a class="link" href="reference.html#boost_task.reference.low_watermark" title="Class low_watermark"> Class <code class="computeroutput">low_watermark</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/watermark.hpp>
+
+class low_watermark
+{
+public:
+ explicit low_watermark( std::size_t value);
+
+ operator std::size_t () const;
+};
+</pre>
+
+ 
+<a name="boost_task.reference.low_watermark.constructor"></a><h5>
+<a name="id683927"></a>
+ <a class="link" href="reference.html#boost_task.reference.low_watermark.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">explicit low_watermark( std::size_t value)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::low_watermark</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::invalid_watermark</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.low_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id684080"></a>
+ <a class="link" href="reference.html#boost_task.reference.low_watermark.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">operator std::size_t()</code></a>
+ </h5>
+<pre class="programlisting">operator std::size_t () const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns low watermark
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class scanns">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.scanns"></a><a class="link" href="reference.html#boost_task.reference.scanns" title="Class scanns"> Class <code class="computeroutput">scanns</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/scanns.hpp>
+
+class scanns
+{
+public:
+ explicit scanns( std::size_t value);
+
+ operator std::size_t () const;
+};
+</pre>
+
+ 
+<a name="boost_task.reference.scanns.constructor"></a><h5>
+<a name="id684393"></a>
+ <a class="link" href="reference.html#boost_task.reference.scanns.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">explicit scanns( std::size_t value)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Preconditions:</dt>
+<dd>
+ value > 0
+ </dd>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::scanns</code> instance
+ </dd>
+<dt>Postconditions:</dt>
+<dd>
+ operator std::size_t () > 0
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ <code class="computeroutput">boost::task::invalid_poolsize</code>
+ </dd>
+</dl>
+</div>
+<a name="boost_task.reference.scanns.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_"></a><h5>
+<a name="id684570"></a>
+ <a class="link" href="reference.html#boost_task.reference.scanns.member_function__code__phrase_role__keyword__operator__phrase___phrase_role__identifier__std__phrase__phrase_role__special______phrase__phrase_role__identifier__size_t__phrase__phrase_role__special______phrase___code_">Member
+ function <code class="computeroutput">operator std::size_t()</code></a>
+ </h5>
+<pre class="programlisting">operator std::size_t () const
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ returns the value
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ Nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class invalid_poolsize">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.invalid_poolsize"></a><a class="link" href="reference.html#boost_task.reference.invalid_poolsize" title="Class invalid_poolsize"> Class <code class="computeroutput">invalid_poolsize</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class invalid_poolsize : public std::invalid_argument
+{
+public:
+ invalid_poolsize( std::string const& msg);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.invalid_poolsize.constructor"></a><h5>
+<a name="id684876"></a>
+ <a class="link" href="reference.html#boost_task.reference.invalid_poolsize.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">invalid_poolsize( std::string const& msg);
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::invalid_poolsize</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class invalid_scanns">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.invalid_scanns"></a><a class="link" href="reference.html#boost_task.reference.invalid_scanns" title="Class invalid_scanns"> Class <code class="computeroutput">invalid_scanns</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class invalid_scanns : public std::invalid_argument
+{
+public:
+ invalid_scanns( std::string const& msg);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.invalid_scanns.constructor"></a><h5>
+<a name="id685189"></a>
+ <a class="link" href="reference.html#boost_task.reference.invalid_scanns.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">invalid_scanns( std::string const& msg)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::invalid_scanns</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class invalid_timeduration">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.invalid_timeduration"></a><a class="link" href="reference.html#boost_task.reference.invalid_timeduration" title="Class invalid_timeduration"> Class <code class="computeroutput">invalid_timeduration</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class invalid_timeduration : public std::invalid_argument
+{
+public:
+ invalid_timeduration( std::string const& msg);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.invalid_timeduration.constructor"></a><h5>
+<a name="id685503"></a>
+ <a class="link" href="reference.html#boost_task.reference.invalid_timeduration.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">invalid_timeduration( std::string const& msg)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::invalid_timeduration</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class invalid_watermark">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.invalid_watermark"></a><a class="link" href="reference.html#boost_task.reference.invalid_watermark" title="Class invalid_watermark"> Class <code class="computeroutput">invalid_watermark</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class invalid_watermark : public std::invalid_argument
+{
+public:
+ invalid_watermark( std::string const& msg);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.invalid_watermark.constructor"></a><h5>
+<a name="id685817"></a>
+ <a class="link" href="reference.html#boost_task.reference.invalid_watermark.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">invalid_watermark( std::string const& msg)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::invalid_watermark</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class task_rejected">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.task_rejected"></a><a class="link" href="reference.html#boost_task.reference.task_rejected" title="Class task_rejected"> Class <code class="computeroutput">task_rejected</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class task_rejected : public std::runtime_error
+{
+public:
+ task_rejected( std::string const& msg);
+};
+</pre>
+
+ 
+<a name="boost_task.reference.task_rejected.constructor"></a><h5>
+<a name="id686131"></a>
+ <a class="link" href="reference.html#boost_task.reference.task_rejected.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">task_rejected( std::string const& msg)
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task_rejected</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class task_unitialized">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.task_unitialized"></a><a class="link" href="reference.html#boost_task.reference.task_unitialized" title="Class task_unitialized"> Class <code class="computeroutput">task_unitialized</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class task_unitialized : public std::logic_error
+{
+public:
+ task_unitialized();
+};
+</pre>
+
+ 
+<a name="boost_task.reference.task_unitialized.constructor"></a><h5>
+<a name="id686410"></a>
+ <a class="link" href="reference.html#boost_task.reference.task_unitialized.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">task_unitialized()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task_unitialized</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class task_already_executed">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.task_already_executed"></a><a class="link" href="reference.html#boost_task.reference.task_already_executed" title="Class task_already_executed"> Class <code class="computeroutput">task_already_executed</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class task_already_executed : public std::logic_error
+{
+public:
+ task_already_executed();
+};
+</pre>
+
+ 
+<a name="boost_task.reference.task_already_executed.constructor"></a><h5>
+<a name="id686655"></a>
+ <a class="link" href="reference.html#boost_task.reference.task_already_executed.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">task_already_executed()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task_already_executed</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class task_moved">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.task_moved"></a><a class="link" href="reference.html#boost_task.reference.task_moved" title="Class task_moved"> Class <code class="computeroutput">task_moved</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class task_moved : public std::logic_error
+{
+public:
+ task_moved();
+};
+</pre>
+
+ 
+<a name="boost_task.reference.task_moved.constructor"></a><h5>
+<a name="id686899"></a>
+ <a class="link" href="reference.html#boost_task.reference.task_moved.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">task_moved()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task_moved</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class broken_task">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.broken_task"></a><a class="link" href="reference.html#boost_task.reference.broken_task" title="Class broken_task"> Class <code class="computeroutput">broken_task</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class broken_task : public std::logic_error
+{
+public:
+ broken_task();
+};
+</pre>
+
+ 
+<a name="boost_task.reference.broken_task.constructor"></a><h5>
+<a name="id687144"></a>
+ <a class="link" href="reference.html#boost_task.reference.broken_task.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">broken_task()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::broken_task</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class task_interrupted">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.task_interrupted"></a><a class="link" href="reference.html#boost_task.reference.task_interrupted" title="Class task_interrupted"> Class <code class="computeroutput">task_interrupted</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class task_interrupted : public std::runtime_error
+{
+public:
+ task_interrupted();
+};
+</pre>
+
+ 
+<a name="boost_task.reference.task_interrupted.constructor"></a><h5>
+<a name="id687387"></a>
+ <a class="link" href="reference.html#boost_task.reference.task_interrupted.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">task_interrupted()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::task_interrupted</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+<div class="section" title="Class pool_moved">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_task.reference.pool_moved"></a><a class="link" href="reference.html#boost_task.reference.pool_moved" title="Class pool_moved"> Class <code class="computeroutput">pool_moved</code></a>
+</h3></div></div></div>
+
+
+
+<pre class="programlisting">#include <boost/task/exceptions.hpp>
+
+class pool_moved : public std::logic_error
+{
+public:
+ pool_moved();
+};
+</pre>
+
+ 
+<a name="boost_task.reference.pool_moved.constructor"></a><h5>
+<a name="id687632"></a>
+ <a class="link" href="reference.html#boost_task.reference.pool_moved.constructor">Constructor</a>
+ </h5>
+<pre class="programlisting">pool_moved()
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>Effects:</dt>
+<dd>
+ constructs a <code class="computeroutput">boost::task::pool_moved</code> instance
+ </dd>
+<dt>Throws:</dt>
+<dd>
+ nothing
+ </dd>
+</dl>
+</div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="meta_functions.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="appendices.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/task.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/task.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,292 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Task</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="motivation.html" title="Motivation">
+<link rel="next" href="handle.html" title="Handle">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="motivation.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="handle.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Task">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.task"></a><a class="link" href="task.html" title="Task"> Task</a>
+</h2></div></div></div>
+
+ A task is a chunk of code that can be executed independently.
+ 
+
+ <code class="computeroutput">boost::task::task</code>
+ represents a callable (provides <code class="computeroutput">operator()()</code>) object containing the unit of code to
+ be execute by a execution-policy. Function <code class="computeroutput">get_future()</code>
+ returns a asynchronous-completion-token allowing to wait
+ for the completion of the computation of the task, for getting the result of
+ a computation or for transfering exceptions. <code class="computeroutput">boost::task::task</code> supports move semantics (moving ownership).
+ 
+<a name="boost_task.task.cooperative_task_and_interruption"></a><h4>
+<a name="id643366"></a>
+ <a class="link" href="task.html#boost_task.task.cooperative_task_and_interruption">Cooperative
+ task and interruption</a>
+ </h4>
+
+ Sometimes it is desired to stop a running task if it is no longer needed. In
+ this case the thread is not killed - it stops only at well-defined points (interruption-points)
+ its execution. In the context of task-interruption a task is known as cooperative
+ if it checks for an interruption request between two interruption-points
+ via <code class="computeroutput">boost::this_thread::interruption_requested()</code>
+ [<a name="id643417" href="#ftn.id643417" class="footnote">2</a>]
+ .
+ 
+
+ interruption-points are:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><code class="computeroutput">boost::thread::join()</code></li>
+<li class="listitem"><code class="computeroutput">boost::thread::timed_join()</code></li>
+<li class="listitem"><code class="computeroutput">boost::condition_variable::wait()</code></li>
+<li class="listitem"><code class="computeroutput">boost::condition_variable::timed_wait()</code></li>
+<li class="listitem"><code class="computeroutput">boost::condition_variable_any::wait()</code></li>
+<li class="listitem"><code class="computeroutput">boost::condition_variable_any::timed_wait()</code></li>
+<li class="listitem"><code class="computeroutput">boost::thread::sleep()</code></li>
+<li class="listitem"><code class="computeroutput">boost::this_thread::sleep()</code></li>
+<li class="listitem"><code class="computeroutput">boost::this_thread::interruption_point()</code></li>
+</ul></div>
+
+ A interruption-point throws <code class="computeroutput">boost::task::task_interrupted</code> if an interruption was requested.
+ 
+
+
+
+<pre class="programlisting">long cooperative( long n)
+{
+ // interruption point
+ boost::this_thread::interruption_point();
+
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ // check if interruption was requested
+ if ( boost::this_thread::interruption_requested() )
+ return;
+
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+
+ // interruption point
+ boost::this_thread::interruption_point();
+
+ return k1;
+}
+
+void main()
+{
+ // task for computing fibonacci-number
+ boost::task::task< long > t( cooperative, 10) );
+
+ // execute task in new thread
+ // move task ownership to executor
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ // interrupt task an wait until
+ // the task is removed by the worker-thread
+ h.interrupt_and_wait();
+
+ // access the result
+ // throws boost::task::task_interrupted
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+<a name="boost_task.task.exceptions"></a><h4>
+<a name="id644579"></a>
+ <a class="link" href="task.html#boost_task.task.exceptions">Exceptions</a>
+ </h4>
+
+ Exceptions thrown by <code class="computeroutput">boost::task::task</code> are transported by the asynchronous-completion-token.
+ 
+
+
+
+<pre class="programlisting">void throwing()
+{
+ ...
+ throw std::domain_error("domain error");
+ ...
+}
+
+void main()
+{
+ // create task throwing std::domain_error
+ boost::task::task void > t( throwing);
+
+ // execute task asynchron
+ // move task ownership to executor
+ boost::task::handle< void > h(
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
+
+ // wait for task completion
+ // throws std::domain_error
+ std::cout << h.wait() << std::endl;
+}
+</pre>
+
+ 
+
+ Exceptions rethrown by type are:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><code class="computeroutput">std::bad_alloc</code></li>
+<li class="listitem"><code class="computeroutput">std::bad_cast</code></li>
+<li class="listitem"><code class="computeroutput">std::bad_exception</code></li>
+<li class="listitem"><code class="computeroutput">std::bad_typeid</code></li>
+<li class="listitem"><code class="computeroutput">std::domain_error</code></li>
+<li class="listitem"><code class="computeroutput">std::invalid_argument</code></li>
+<li class="listitem"><code class="computeroutput">std::ios_base::failure</code></li>
+<li class="listitem"><code class="computeroutput">std::length_error</code></li>
+<li class="listitem"><code class="computeroutput">std::logic_error</code></li>
+<li class="listitem"><code class="computeroutput">std::out_of_range</code></li>
+<li class="listitem"><code class="computeroutput">std::overflow_error</code></li>
+<li class="listitem"><code class="computeroutput">std::range_error</code></li>
+<li class="listitem"><code class="computeroutput">std::runtime_error</code></li>
+<li class="listitem"><code class="computeroutput">std::underflow_error</code></li>
+<li class="listitem"><code class="computeroutput">boost::exception</code></li>
+<li class="listitem"><code class="computeroutput">boost::future_already_set</code></li>
+<li class="listitem"><code class="computeroutput">boost::future_cancel</code></li>
+<li class="listitem"><code class="computeroutput">boost::invalid_thread_argument</code></li>
+<li class="listitem"><code class="computeroutput">boost::lock_error</code></li>
+<li class="listitem"><code class="computeroutput">boost::broken_task</code></li>
+<li class="listitem"><code class="computeroutput">boost::pool_moved</code></li>
+<li class="listitem"><code class="computeroutput">boost::task_already_executed</code></li>
+<li class="listitem"><code class="computeroutput">boost::task_interrupted</code></li>
+<li class="listitem"><code class="computeroutput">boost::task_moved</code></li>
+<li class="listitem"><code class="computeroutput">boost::task::task_interrupted</code></li>
+<li class="listitem"><code class="computeroutput">boost::task_task_rejected</code></li>
+<li class="listitem"><code class="computeroutput">boost::task_unitialized</code></li>
+</ul></div>
+<a name="boost_task.task.parent_task"></a><h4>
+<a name="id645550"></a>
+ <a class="link" href="task.html#boost_task.task.parent_task">Parent task</a>
+ </h4>
+
+ Top-level tasks have no parent. A parent task can create child tasks when it
+ creates another task by using <code class="computeroutput">boost::task::as_sub_task</code> as execution-policy.
+ These children are implicitly treated as sub-tasks of
+ the larger task. It is assumed that that sub-tasks can
+ be executed in any order because only overall operation speed matters (enabling
+ strategies for fast execution of unordered work-items
+ as <a class="link" href="pool.html#boost_task.pool.work_stealing" title="Work-Stealing">work-stealing</a>).
+ 
+
+
+
+<pre class="programlisting">long serial_fib( long n)
+{
+ if( n < 2) return n;
+ else return serial_fib( n - 1) + serial_fib( n - 2);
+}
+
+long parallel_fib( long n, long cutof)
+{
+ if ( n < cutof) return serial_fib( n);
+ else
+ {
+ // sub-task for computing fibonacci(n-1)
+ boost::task::task< long > t1(
+ parallel_fib,
+ n - 1,
+ cutof);
+ // sub-task for computing fibonacci(n-2)
+ boost::task::task< long > t2(
+ parallel_fib,
+ n - 2,
+ cutof);
+
+ // submit a sub-tasks to thread-pool
+ // move task ownership to executor
+ boost::task::handle< long > h1(
+ boost::task::async(
+ boost::move( t1) );
+ boost::task::handle< long > h2(
+ boost::task::async(
+ boost::move( t2) );
+
+ // computing fibonacci(n) by
+ // joining results of both sub-tasks
+ return h1.get() + h2.get();
+ }
+}
+
+void main()
+{
+ // create thread-pool with five worker-threads
+ boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+ > pool( boost::task::poolsize( 5) );
+
+ // create task computing fibonacci-number for 10
+ boost::task::task< long > t(
+ parallel_fib,
+ 10,
+ 5);
+
+ // execute task asynchron in thread-pool
+ // move task ownership to executor
+ boost::task::handle< long > h(
+ boost::task::async(
+ boost::move( t),
+ pool) );
+
+ // access result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
+}
+</pre>
+
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id643417" href="#id643417" class="para">2</a>] 
+ see 'Interrupt Politely',
+ Herb Sutter
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="motivation.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="handle.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boost_task/utilities.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boost_task/utilities.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,112 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Utilities</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="up" href="../index.html" title="Chapter 1. Boost.Task">
+<link rel="prev" href="as_sub_task.html" title="Execute as sub-task">
+<link rel="next" href="meta_functions.html" title="Meta functions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="as_sub_task.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="meta_functions.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Utilities">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.utilities"></a><a class="link" href="utilities.html" title="Utilities"> Utilities</a>
+</h2></div></div></div>
+
+ Boost.Task provides some free-functions which
+ can be used inside a <code class="computeroutput">boost::task::task</code> to access some informations (like if
+ the <code class="computeroutput">boost::task::task</code>
+ runs in a thread-pool).
+ 
+<a name="boost_task.utilities.reschedule_until"></a><h4>
+<a name="id662954"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.reschedule_until">reschedule_until</a>
+ </h4>
+
+ In the function <code class="computeroutput">boost::this_task::reschedule_until(
+ Pred const&)</code> allows to synchronize the task with other
+ asynchronous events without blocking the worker-threads
+ (bool Pred::operator()() must not block). The current task will be rescheduled
+ until the passed predicate becomes true.
+ 
+<a name="boost_task.utilities.get_pool"></a><h4>
+<a name="id663030"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.get_pool">get_pool</a>
+ </h4>
+
+ The pool in which the current code (<code class="computeroutput">boost::task::task</code>) is executed can be accessed via <code class="computeroutput">boost::this_task::get_pool()</code>. If hte code is not executed by a worker-thread
+ an assertion is raised.
+ 
+<a name="boost_task.utilities.runs_in_pool"></a><h4>
+<a name="id663119"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.runs_in_pool">runs_in_pool</a>
+ </h4>
+
+ In order to check if the current code is executed in a thread-pool
+ <code class="computeroutput">boost::this_task::runs_in_pool()</code>
+ should be used.
+ 
+<a name="boost_task.utilities.worker_id"></a><h4>
+<a name="id663178"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.worker_id">worker_id</a>
+ </h4>
+
+ <code class="computeroutput">boost::this_task::worker_id()</code>
+ returns the <code class="computeroutput">boost::thread::id</code> of the worker-thread
+ executing the current <code class="computeroutput">boost::task::task</code>.
+ 
+<a name="boost_task.utilities.delay"></a><h4>
+<a name="id663294"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.delay">delay</a>
+ </h4>
+
+ The execution of a <code class="computeroutput">boost::task::task</code>
+ can be delayed for a time-duration or until a specific time-point with <code class="computeroutput">boost::this_task::delay()</code>.
+ 
+<a name="boost_task.utilities.yield"></a><h4>
+<a name="id663378"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.yield">yield</a>
+ </h4>
+
+ If a <code class="computeroutput">boost::task::task</code>
+ detects that it would bould block it can yield itself with <code class="computeroutput">boost::this_task::yield()</code>
+ so that the worker-thread can execute another <code class="computeroutput">boost::task::task</code> in
+ the meantime.
+ 
+<a name="boost_task.utilities.interrupt"></a><h4>
+<a name="id663495"></a>
+ <a class="link" href="utilities.html#boost_task.utilities.interrupt">interrupt</a>
+ </h4>
+
+ A <code class="computeroutput">boost::task::task</code>
+ can interrupt itself via <code class="computeroutput">boost::this_task::interrupt()</code>.
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Oliver Kowalke
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="as_sub_task.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="meta_functions.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/boostbook.css
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/boostbook.css 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,594 @@
+/*=============================================================================
+ Copyright (c) 2004 Joel de Guzman
+ http://spirit.sourceforge.net/
+
+ Distributed under the Boost Software License, Version 1.0. (See accompany-
+ ing file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================*/
+
+/*=============================================================================
+ Body defaults
+=============================================================================*/
+
+ body
+ {
+ margin: 1em;
+ font-family: sans-serif;
+ }
+
+/*=============================================================================
+ Paragraphs
+=============================================================================*/
+
+ p
+ {
+ text-align: left;
+ font-size: 10pt;
+ line-height: 1.15;
+ }
+
+/*=============================================================================
+ Program listings
+=============================================================================*/
+
+ /* Code on paragraphs */
+ p tt.computeroutput
+ {
+ font-size: 9pt;
+ }
+
+ pre.synopsis
+ {
+ font-size: 90%;
+ margin: 1pc 4% 0pc 4%;
+ padding: 0.5pc 0.5pc 0.5pc 0.5pc;
+ }
+
+ .programlisting,
+ .screen
+ {
+ font-size: 9pt;
+ display: block;
+ margin: 1pc 4% 0pc 4%;
+ padding: 0.5pc 0.5pc 0.5pc 0.5pc;
+ }
+
+ /* Program listings in tables don't get borders */
+ td .programlisting,
+ td .screen
+ {
+ margin: 0pc 0pc 0pc 0pc;
+ padding: 0pc 0pc 0pc 0pc;
+ }
+
+/*=============================================================================
+ Headings
+=============================================================================*/
+
+ h1, h2, h3, h4, h5, h6
+ {
+ text-align: left;
+ margin: 1em 0em 0.5em 0em;
+ font-weight: bold;
+ }
+
+ h1 { font: 140% }
+ h2 { font: bold 140% }
+ h3 { font: bold 130% }
+ h4 { font: bold 120% }
+ h5 { font: italic 110% }
+ h6 { font: italic 100% }
+
+ /* Top page titles */
+ title,
+ h1.title,
+ h2.title
+ h3.title,
+ h4.title,
+ h5.title,
+ h6.title,
+ .refentrytitle
+ {
+ font-weight: bold;
+ margin-bottom: 1pc;
+ }
+
+ h1.title { font-size: 140% }
+ h2.title { font-size: 140% }
+ h3.title { font-size: 130% }
+ h4.title { font-size: 120% }
+ h5.title { font-size: 110% }
+ h6.title { font-size: 100% }
+
+ .section h1
+ {
+ margin: 0em 0em 0.5em 0em;
+ font-size: 140%;
+ }
+
+ .section h2 { font-size: 140% }
+ .section h3 { font-size: 130% }
+ .section h4 { font-size: 120% }
+ .section h5 { font-size: 110% }
+ .section h6 { font-size: 100% }
+
+ /* Code on titles */
+ h1 tt.computeroutput { font-size: 140% }
+ h2 tt.computeroutput { font-size: 140% }
+ h3 tt.computeroutput { font-size: 130% }
+ h4 tt.computeroutput { font-size: 120% }
+ h5 tt.computeroutput { font-size: 110% }
+ h6 tt.computeroutput { font-size: 100% }
+
+/*=============================================================================
+ Author
+=============================================================================*/
+
+ h3.author
+ {
+ font-size: 100%
+ }
+
+/*=============================================================================
+ Lists
+=============================================================================*/
+
+ li
+ {
+ font-size: 10pt;
+ line-height: 1.3;
+ }
+
+ /* Unordered lists */
+ ul
+ {
+ text-align: left;
+ }
+
+ /* Ordered lists */
+ ol
+ {
+ text-align: left;
+ }
+
+/*=============================================================================
+ Links
+=============================================================================*/
+
+ a
+ {
+ text-decoration: none; /* no underline */
+ }
+
+ a:hover
+ {
+ text-decoration: underline;
+ }
+
+/*=============================================================================
+ Spirit style navigation
+=============================================================================*/
+
+ .spirit-nav
+ {
+ text-align: right;
+ }
+
+ .spirit-nav a
+ {
+ color: white;
+ padding-left: 0.5em;
+ }
+
+ .spirit-nav img
+ {
+ border-width: 0px;
+ }
+
+/*=============================================================================
+ Copyright footer
+=============================================================================*/
+ .copyright-footer
+ {
+ text-align: right;
+ font-size: 70%;
+ }
+
+ .copyright-footer p
+ {
+ text-align: right;
+ font-size: 80%;
+ }
+
+/*=============================================================================
+ Table of contents
+=============================================================================*/
+
+ .toc
+ {
+ margin: 1pc 4% 0pc 4%;
+ padding: 0.1pc 1pc 0.1pc 1pc;
+ font-size: 80%;
+ line-height: 1.15;
+ }
+
+ .boost-toc
+ {
+ float: right;
+ padding: 0.5pc;
+ }
+
+/*=============================================================================
+ Tables
+=============================================================================*/
+
+ .table-title,
+ div.table p.title
+ {
+ margin-left: 4%;
+ padding-right: 0.5em;
+ padding-left: 0.5em;
+ }
+
+ .informaltable table,
+ .table table
+ {
+ width: 92%;
+ margin-left: 4%;
+ margin-right: 4%;
+ }
+
+ div.informaltable table,
+ div.table table
+ {
+ padding: 4px;
+ }
+
+ /* Table Cells */
+ div.informaltable table tr td,
+ div.table table tr td
+ {
+ padding: 0.5em;
+ text-align: left;
+ font-size: 9pt;
+ }
+
+ div.informaltable table tr th,
+ div.table table tr th
+ {
+ padding: 0.5em 0.5em 0.5em 0.5em;
+ border: 1pt solid white;
+ font-size: 80%;
+ }
+
+ table.simplelist
+ {
+ width: auto !important;
+ margin: 0em !important;
+ padding: 0em !important;
+ border: none !important;
+ }
+ table.simplelist td
+ {
+ margin: 0em !important;
+ padding: 0em !important;
+ text-align: left !important;
+ font-size: 9pt !important;
+ border: none !important;
+ }
+
+/*=============================================================================
+ Blurbs
+=============================================================================*/
+
+ div.note,
+ div.tip,
+ div.important,
+ div.caution,
+ div.warning,
+ p.blurb
+ {
+ font-size: 9pt; /* A little bit smaller than the main text */
+ line-height: 1.2;
+ display: block;
+ margin: 1pc 4% 0pc 4%;
+ padding: 0.5pc 0.5pc 0.5pc 0.5pc;
+ }
+
+ p.blurb img
+ {
+ padding: 1pt;
+ }
+
+/*=============================================================================
+ Variable Lists
+=============================================================================*/
+
+ div.variablelist
+ {
+ margin: 1em 0;
+ }
+
+ /* Make the terms in definition lists bold */
+ div.variablelist dl dt,
+ span.term
+ {
+ font-weight: bold;
+ font-size: 10pt;
+ }
+
+ div.variablelist table tbody tr td
+ {
+ text-align: left;
+ vertical-align: top;
+ padding: 0em 2em 0em 0em;
+ font-size: 10pt;
+ margin: 0em 0em 0.5em 0em;
+ line-height: 1;
+ }
+
+ div.variablelist dl dt
+ {
+ margin-bottom: 0.2em;
+ }
+
+ div.variablelist dl dd
+ {
+ margin: 0em 0em 0.5em 2em;
+ font-size: 10pt;
+ }
+
+ div.variablelist table tbody tr td p,
+ div.variablelist dl dd p
+ {
+ margin: 0em 0em 0.5em 0em;
+ line-height: 1;
+ }
+
+/*=============================================================================
+ Misc
+=============================================================================*/
+
+ /* Title of books and articles in bibliographies */
+ span.title
+ {
+ font-style: italic;
+ }
+
+ span.underline
+ {
+ text-decoration: underline;
+ }
+
+ span.strikethrough
+ {
+ text-decoration: line-through;
+ }
+
+ /* Copyright, Legal Notice */
+ div div.legalnotice p
+ {
+ text-align: left
+ }
+
+/*=============================================================================
+ Colors
+=============================================================================*/
+
+ @media screen
+ {
+ body {
+ background-color: #FFFFFF;
+ color: #000000;
+ }
+
+ /* Links */
+ a
+ {
+ color: #005a9c;
+ }
+
+ a:visited
+ {
+ color: #9c5a9c;
+ }
+
+ h1 a, h2 a, h3 a, h4 a, h5 a, h6 a,
+ h1 a:hover, h2 a:hover, h3 a:hover, h4 a:hover, h5 a:hover, h6 a:hover,
+ h1 a:visited, h2 a:visited, h3 a:visited, h4 a:visited, h5 a:visited, h6 a:visited
+ {
+ text-decoration: none; /* no underline */
+ color: #000000;
+ }
+
+ /* Syntax Highlighting */
+ .keyword { color: #0000AA; }
+ .identifier { color: #000000; }
+ .special { color: #707070; }
+ .preprocessor { color: #402080; }
+ .char { color: teal; }
+ .comment { color: #800000; }
+ .string { color: teal; }
+ .number { color: teal; }
+ .white_bkd { background-color: #FFFFFF; }
+ .dk_grey_bkd { background-color: #999999; }
+
+ /* Copyright, Legal Notice */
+ .copyright
+ {
+ color: #666666;
+ font-size: small;
+ }
+
+ div div.legalnotice p
+ {
+ color: #666666;
+ }
+
+ /* Program listing */
+ pre.synopsis
+ {
+ border: 1px solid #DCDCDC;
+ }
+
+ .programlisting,
+ .screen
+ {
+ border: 1px solid #DCDCDC;
+ }
+
+ td .programlisting,
+ td .screen
+ {
+ border: 0px solid #DCDCDC;
+ }
+
+ /* Blurbs */
+ div.note,
+ div.tip,
+ div.important,
+ div.caution,
+ div.warning,
+ p.blurb
+ {
+ border: 1px solid #DCDCDC;
+ }
+
+ /* Table of contents */
+ .toc
+ {
+ border: 1px solid #DCDCDC;
+ }
+
+ /* Tables */
+ div.informaltable table tr td,
+ div.table table tr td
+ {
+ border: 1px solid #DCDCDC;
+ }
+
+ div.informaltable table tr th,
+ div.table table tr th
+ {
+ background-color: #F0F0F0;
+ border: 1px solid #DCDCDC;
+ }
+
+ .copyright-footer
+ {
+ color: #8F8F8F;
+ }
+
+ /* Misc */
+ span.highlight
+ {
+ color: #00A000;
+ }
+ }
+
+ @media print
+ {
+ /* Links */
+ a
+ {
+ color: black;
+ }
+
+ a:visited
+ {
+ color: black;
+ }
+
+ .spirit-nav
+ {
+ display: none;
+ }
+
+ /* Program listing */
+ pre.synopsis
+ {
+ border: 1px solid gray;
+ }
+
+ .programlisting,
+ .screen
+ {
+ border: 1px solid gray;
+ }
+
+ td .programlisting,
+ td .screen
+ {
+ border: 0px solid #DCDCDC;
+ }
+
+ /* Table of contents */
+ .toc
+ {
+ border: 1px solid gray;
+ }
+
+ .informaltable table,
+ .table table
+ {
+ border: 1px solid gray;
+ border-collapse: collapse;
+ }
+
+ /* Tables */
+ div.informaltable table tr td,
+ div.table table tr td
+ {
+ border: 1px solid gray;
+ }
+
+ div.informaltable table tr th,
+ div.table table tr th
+ {
+ border: 1px solid gray;
+ }
+
+ table.simplelist tr td
+ {
+ border: none !important;
+ }
+
+ /* Misc */
+ span.highlight
+ {
+ font-weight: bold;
+ }
+ }
+
+/*=============================================================================
+ Images
+=============================================================================*/
+
+ span.inlinemediaobject img
+ {
+ vertical-align: middle;
+ }
+
+/*==============================================================================
+ Super and Subscript: style so that line spacing isn't effected, see
+ http://www.adobe.com/cfusion/communityengine/index.cfm?event=showdetails&productId=1&postId=5341
+==============================================================================*/
+
+sup,
+sub {
+ height: 0;
+ line-height: 1;
+ vertical-align: baseline;
+ _vertical-align: bottom;
+ position: relative;
+
+}
+
+sup {
+ bottom: 1ex;
+}
+
+sub {
+ top: .5ex;
+}
+

Added: sandbox/task/libs/task/doc/html/docutils.css
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/docutils.css 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,275 @@
+/*
+:Author: David Goodger
+:Contact: goodger_at_[hidden]
+:Date: $Date: 2007-11-25 19:34:32 +0000 (Sun, 25 Nov 2007) $
+:Revision: $Revision: 41371 $
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+ border: 0 }
+
+table.borderless td, table.borderless th {
+ /* Override padding for "table.docutils td" with "! important".
+ The right padding separates the table cells. */
+ padding: 0 0.5em 0 0 ! important }
+
+.first {
+ /* Override more specific margin styles with "! important". */
+ margin-top: 0 ! important }
+
+.last, .with-subtitle {
+ margin-bottom: 0 ! important }
+
+.hidden {
+ display: none }
+
+a.toc-backref {
+ text-decoration: none ;
+ color: black }
+
+blockquote.epigraph {
+ margin: 2em 5em ; }
+
+dl.docutils dd {
+ margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+ font-weight: bold }
+*/
+
+div.abstract {
+ margin: 2em 5em }
+
+div.abstract p.topic-title {
+ font-weight: bold ;
+ text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+ margin: 2em ;
+ border: medium outset ;
+ padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+ font-weight: bold ;
+ font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+ color: red ;
+ font-weight: bold ;
+ font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+ compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+ margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+ margin-top: 0.5em }
+*/
+
+div.dedication {
+ margin: 2em 5em ;
+ text-align: center ;
+ font-style: italic }
+
+div.dedication p.topic-title {
+ font-weight: bold ;
+ font-style: normal }
+
+div.figure {
+ margin-left: 2em ;
+ margin-right: 2em }
+
+div.footer, div.header {
+ clear: both;
+ font-size: smaller }
+
+div.line-block {
+ display: block ;
+ margin-top: 1em ;
+ margin-bottom: 1em }
+
+div.line-block div.line-block {
+ margin-top: 0 ;
+ margin-bottom: 0 ;
+ margin-left: 1.5em }
+
+div.sidebar {
+ margin-left: 1em ;
+ border: medium outset ;
+ padding: 1em ;
+ background-color: #ffffee ;
+ width: 40% ;
+ float: right ;
+ clear: right }
+
+div.sidebar p.rubric {
+ font-family: sans-serif ;
+ font-size: medium }
+
+div.system-messages {
+ margin: 5em }
+
+div.system-messages h1 {
+ color: red }
+
+div.system-message {
+ border: medium outset ;
+ padding: 1em }
+
+div.system-message p.system-message-title {
+ color: red ;
+ font-weight: bold }
+
+div.topic {
+ margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+ margin-top: 0.4em }
+
+h1.title {
+ text-align: center }
+
+h2.subtitle {
+ text-align: center }
+
+hr.docutils {
+ width: 75% }
+
+img.align-left {
+ clear: left }
+
+img.align-right {
+ clear: right }
+
+ol.simple, ul.simple {
+ margin-bottom: 1em }
+
+ol.arabic {
+ list-style: decimal }
+
+ol.loweralpha {
+ list-style: lower-alpha }
+
+ol.upperalpha {
+ list-style: upper-alpha }
+
+ol.lowerroman {
+ list-style: lower-roman }
+
+ol.upperroman {
+ list-style: upper-roman }
+
+p.attribution {
+ text-align: right ;
+ margin-left: 50% }
+
+p.caption {
+ font-style: italic }
+
+p.credits {
+ font-style: italic ;
+ font-size: smaller }
+
+p.label {
+ white-space: nowrap }
+
+p.rubric {
+ font-weight: bold ;
+ font-size: larger ;
+ color: maroon ;
+ text-align: center }
+
+p.sidebar-title {
+ font-family: sans-serif ;
+ font-weight: bold ;
+ font-size: larger }
+
+p.sidebar-subtitle {
+ font-family: sans-serif ;
+ font-weight: bold }
+
+p.topic-title {
+ font-weight: bold }
+
+pre.address {
+ margin-bottom: 0 ;
+ margin-top: 0 ;
+ font-family: serif ;
+ font-size: 100% }
+
+pre.literal-block, pre.doctest-block {
+ margin-left: 2em ;
+ margin-right: 2em }
+
+span.classifier {
+ font-family: sans-serif ;
+ font-style: oblique }
+
+span.classifier-delimiter {
+ font-family: sans-serif ;
+ font-weight: bold }
+
+span.interpreted {
+ font-family: sans-serif }
+
+span.option {
+ white-space: nowrap }
+
+span.pre {
+ white-space: pre }
+
+span.problematic {
+ color: red }
+
+span.section-subtitle {
+ /* font-size relative to parent (h1..h6 element) */
+ font-size: 80% }
+
+table.citation {
+ border-left: solid 1px gray;
+ margin-left: 1px }
+
+table.docinfo {
+ margin: 2em 4em }
+
+table.docutils {
+ margin-top: 0.5em ;
+ margin-bottom: 0.5em }
+
+table.footnote {
+ border-left: solid 1px black;
+ margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+ padding-left: 0.5em ;
+ padding-right: 0.5em ;
+ vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+ font-weight: bold ;
+ text-align: left ;
+ white-space: nowrap ;
+ padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+ font-size: 100% }
+
+ul.auto-toc {
+ list-style-type: none }

Added: sandbox/task/libs/task/doc/html/images/accumulators/doxygen.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_0.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_1.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_10.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_100.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_11.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_12.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_13.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_14.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_15.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_16.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_17.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_18.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_19.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_2.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_20.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_21.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_22.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_23.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_24.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_25.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_26.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_27.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_28.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_29.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_3.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_30.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_31.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_32.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_33.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_34.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_35.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_36.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_37.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_38.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_39.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_4.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_40.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_41.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_42.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_43.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_44.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_45.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_46.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_47.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_48.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_49.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_5.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_50.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_51.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_52.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_53.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_54.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_55.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_56.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_57.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_58.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_59.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_6.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_60.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_61.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_62.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_63.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_64.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_65.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_66.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_67.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_68.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_69.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_7.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_70.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_71.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_72.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_73.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_74.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_75.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_76.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_77.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_78.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_79.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_8.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_80.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_81.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_82.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_83.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_84.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_85.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_86.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_87.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_88.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_89.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_9.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_90.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_91.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_92.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_93.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_94.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_95.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_96.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_97.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_98.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/accumulators/form_99.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/alert.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/blank.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/1.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/10.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/11.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/12.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/13.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/14.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/15.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/2.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/3.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/4.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/5.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/6.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/7.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/8.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/callouts/9.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/caution.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/draft.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/home.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/important.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/next.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/next_disabled.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/note.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/prev.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/prev_disabled.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/smiley.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/tip.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/toc-blank.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/toc-minus.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/toc-plus.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/up.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/up_disabled.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/images/warning.png
==============================================================================
Binary file. No diff available.

Added: sandbox/task/libs/task/doc/html/index.html
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/index.html 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,414 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Chapter 1. Boost.Task</title>
+<link rel="stylesheet" href="boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
+<link rel="home" href="index.html" title="Chapter 1. Boost.Task">
+<link rel="next" href="boost_task/motivation.html" title="Motivation">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav"><a accesskey="n" href="boost_task/motivation.html"><img src="../../doc/html/images/next.png" alt="Next"></a></div>
+<div class="chapter" title="Chapter 1. Boost.Task">
+<div class="titlepage"><div>
+<div><h2 class="title">
+<a name="boost_task"></a>Chapter 1. Boost.Task</h2></div>
+<div><div class="author"><h3 class="author">
+Oliver Kowalke
+</h3></div></div>
+<div>Copyright © 2009 Oliver Kowalke</div>
+<div><div class="legalnotice" title="Legal Notice">
+<a name="id623344"></a>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></div>
+</div></div>
+<div class="toc">
+Table of Contents
+<dl>
+<dt> Overview</dt>
+<dt> Motivation</dt>
+<dt> Task</dt>
+<dt> Handle</dt>
+<dt> Asynchronous execution</dt>
+<dt> Execute in own thread</dt>
+<dt> Execute in new thread</dt>
+<dt> Thread-pool</dt>
+<dd><dl>
+<dt> Static thread-pool</dt>
+<dt> Channel</dt>
+<dt> Scheduling</dt>
+<dt> Pool shutdown</dt>
+<dt> Processor binding</dt>
+<dt> Work-Stealing</dt>
+<dt> Fork/Join</dt>
+</dl></dd>
+<dt> Execute as sub-task</dt>
+<dt> Utilities</dt>
+<dt> Meta functions</dt>
+<dt> Reference</dt>
+<dd><dl>
+<dt> Class template task</dt>
+<dt> Class template handle</dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.async"> Non-member function <code class="computeroutput">async( task< R >
+ &&, EP)</code></a></dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.async1"> Non-member function <code class="computeroutput">async( task< R >
+ &&, pool< Channel > &)</code></a></dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.async2"> Non-member function <code class="computeroutput">async( task< R >
+ &&, Attr, pool<
+ Channel >
+ &)</code></a></dt>
+<dt> Class own_thread</dt>
+<dt> Class new_thread</dt>
+<dt> Class template static_pool</dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.reschedule_until"> Non-member function
+ <code class="computeroutput">reschedule_until()</code></a></dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.get_pool"> Non-member function
+ <code class="computeroutput">get_pool()</code></a></dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.runs_in_pool"> Non-member function
+ <code class="computeroutput">runs_in_pool()</code></a></dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.worker_id"> Non-member function
+ <code class="computeroutput">worker_id()</code></a></dt>
+<dt> Non-member function delay()</dt>
+<dt> Non-member function yield()</dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.interrupt"> Non-member function
+ <code class="computeroutput">interrupt()</code></a></dt>
+<dt> Meta function has_attribute</dt>
+<dt><a href="boost_task/reference.html#boost_task.reference.attribute_type"> Meta function
+ <code class="computeroutput">attribute_type</code></a></dt>
+<dt> Class poolsize</dt>
+<dt> Class high_watermark</dt>
+<dt> Class low_watermark</dt>
+<dt> Class scanns</dt>
+<dt> Class invalid_poolsize</dt>
+<dt> Class invalid_scanns</dt>
+<dt> Class invalid_timeduration</dt>
+<dt> Class invalid_watermark</dt>
+<dt> Class task_rejected</dt>
+<dt> Class task_unitialized</dt>
+<dt> Class task_already_executed</dt>
+<dt> Class task_moved</dt>
+<dt> Class broken_task</dt>
+<dt> Class task_interrupted</dt>
+<dt> Class pool_moved</dt>
+</dl></dd>
+<dt>Appendices</dt>
+<dd><dl>
+<dt> Appendix A: Future development</dt>
+<dt><a href="boost_task/appendices.html#boost_task.appendices.acknowledgements"> Appendix B:
+ Acknowledgments</a></dt>
+</dl></dd>
+</dl>
+</div>
+<div class="section" title="Overview">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_task.overview"></a><a class="link" href="index.html#boost_task.overview" title="Overview"> Overview</a>
+</h2></div></div></div>
+
+ Boost.Task provides a framework for parallel
+ execution of tasks (a task is a small unit of code that can be executed independently).
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<code class="computeroutput">boost::task::task</code>, a callable representing
+ a fine-grained work-item:
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+<code class="computeroutput">operator()()</code>
+ to execute the fine-grained work-item
+ </li>
+<li class="listitem">
+<code class="computeroutput">get_future()</code>
+ providing an asynchronous-completion-token in order
+ to pass the result (values, exceptions) back to initiator
+ </li>
+</ul></div>
+</li>
+<li class="listitem">
+<code class="computeroutput">boost::task::handle</code>, works as a asynchronous-completion-token
+ of executed task:
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+<code class="computeroutput">interrupt()</code>,
+ <code class="computeroutput">interrupt_and_wait()</code>,
+ ... allow to cancel an cooperative task
+ </li>
+<li class="listitem">
+ interface of the asynchronous-completion-token:
+ <div class="itemizedlist"><ul class="itemizedlist" type="square">
+<li class="listitem">
+<code class="computeroutput">get()</code>
+ retrieve value or exception of task execution
+ </li>
+<li class="listitem">
+<code class="computeroutput">is_ready()</code>
+ test if task was executed
+ </li>
+<li class="listitem">
+<code class="computeroutput">wait()</code>,
+ <code class="computeroutput">wait_for()</code>
+ and <code class="computeroutput">wait_until()</code>
+ block until task is executed and the result is set
+ </li>
+</ul></div>
+</li>
+<li class="listitem">
+<code class="computeroutput">get_future()</code>
+ returns reference to internal <code class="computeroutput">boost::shared_future</code>
+</li>
+<li class="listitem">
+ functions <code class="computeroutput">boost::task::waitfor_all()</code>/<code class="computeroutput">boost::task::waitfor_any()</code>
+ to wait for all or any handles
+ </li>
+</ul></div>
+</li>
+<li class="listitem">
+<code class="computeroutput">boost::task::async()</code>,
+ executes a task by means of execution-policies
+</li>
+<li class="listitem">
+execution-policy models:
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+<code class="computeroutput">boost::task::own_thread</code>: executes task in current
+ thread
+ </li>
+<li class="listitem">
+<code class="computeroutput">boost::task::new_thread</code>: executes task in a newly-created
+ thread (thread will be destroyed after completion)
+ </li>
+<li class="listitem">
+<code class="computeroutput">boost::task::as_sub_task</code>: executes task in newly-created
+ thread or in a pool of worker-threads depending
+ on whether the parent-task is already executed in a thread-pool
+</li>
+<li class="listitem">
+thread-pool: task gets executed by a worker-thread
+ of a custom thread-pool (for instance with priority
+ or smart scheduling)
+ </li>
+</ul></div>
+</li>
+<li class="listitem">
+thread-pools with work-stealing algorithm and for/join
+ semantics
+ </li>
+<li class="listitem">
+ support of forking and joining sub-tasks
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle">
+<li class="listitem">
+ better performance
+ </li>
+<li class="listitem">
+ no deadlock because of inline-execution of sub-tasks
+ </li>
+<li class="listitem">
+ detects if parent-task runs in a thread-pool - the
+ appropriate mechanism for executing the sub-tasks is choosen
+ </li>
+</ul></div>
+</li>
+</ul></div>
+
+ In order to use the classes and functions described here, you can either include
+ the specific headers specified by the descriptions of each class or function,
+ or include the master library header:
+ 
+
+
+
+<pre class="programlisting">#include <boost/task.hpp>
+</pre>
+
+ 
+
+ which includes all the other headers in turn.
+ 
+
+ Used namespaces are:
+ 
+
+
+
+<pre class="programlisting">namespace boost::task
+namespace boost::this_task
+</pre>
+
+ 
+<a name="boost_task.overview.example"></a><h4>
+<a name="id638414"></a>
+ <a class="link" href="index.html#boost_task.overview.example">Example</a>
+ </h4>
+
+
+
+<pre class="programlisting">long fibonacci( long n)
+{
+ if ( n == 0) return 0;
+ if ( n == 1) return 1;
+ long k1( 1), k2( 0);
+ for ( int i( 2); i <= n; ++i)
+ {
+ long tmp( k1);
+ k1 = k1 + k2;
+ k2 = tmp;
+ }
+ return k1;
+}
+
+void main()
+{
+ // create a thread-pool
+ boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+ > pool( boost::task::poolsize( 5) );
+
+ // create two tasks, computing fibonacci numbers
+ boost::task< long > t1( fibonacci, 10);
+ boost::task< long > t2( fibonacci, 5);
+
+ // execute tasks in thread-pool
+ // move tasks ownership to executor
+ boost::task::handle< long > h1(
+ boost::task::async(
+ boost::move( t1),
+ pool);
+ boost::task::handle< long > h2(
+ boost::task::async(
+ boost::move( t2),
+ pool);
+
+ std::cout << "h1: is ready == " << std::boolalpha << h1.is_ready() << "\n";
+ std::cout << "h2: is ready == " << std::boolalpha << h2.is_ready() << "\n";
+
+ // wait for completion of both tasks
+ boost::task::waitfor_all( h1, h2);
+
+ std::cout << "h1: is ready == " << std::boolalpha << h1.is_ready() << "\n";
+ std::cout << "h2: is ready == " << std::boolalpha << h2.is_ready() << "\n";
+ std::cout << "h1: has value == " << std::boolalpha << h1.has_value() << "\n";
+ std::cout << "h2: has value == " << std::boolalpha << h2.has_value() << "\n";
+ std::cout << "h1: has exception == " << std::boolalpha << h1.has_exception() << "\n";
+ std::cout << "h2: has exception == " << std::boolalpha << h2.has_exception() << "\n";
+
+ // get results
+ std::cout << "fibonacci(10) == " << h1.get() << std::endl;
+ std::cout << "fibonacci(5) == " << h2.get() << std::endl;
+}
+</pre>
+
+ 
+<a name="boost_task.overview.references"></a><h4>
+<a name="id640113"></a>
+ <a class="link" href="index.html#boost_task.overview.references">References</a>
+ </h4>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ N2185: Proposed Text for Parallel Task Execution http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2185.html
+ written by Peter Dimov.
+ </li>
+<li class="listitem">
+ N2276: Thread Pools and Futures http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2276.html
+ written by Anthony Williams.
+ </li>
+<li class="listitem">
+ N2802: A plea to reconsider detach-on-destruction for thread objects http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2802.html
+ written by Hans-J. Boehm.
+ </li>
+<li class="listitem">
+ N2880: C++ object lifetime interactions with the threads API http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2880.html
+ written by Hans-J. Boehm and Lawrence Crowl.
+ </li>
+<li class="listitem">
+'Sutter’s Mill' by
+ Herb Sutter
+ </li>
+<li class="listitem">
+ mailing list of C++ standard committee's Library Working Group
+ </li>
+</ul></div>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Boost.Task uses Boost.Future from Anthony Williams (will be
+ integrated in some of the next releases of Boost.Thread).
+ </td></tr>
+</table></div>
+<div class="note" title="Note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../doc/html/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Please note that Boost.Task is not optimized
+ yet.
+ </td></tr>
+</table></div>
+<a name="boost_task.overview.tested_platforms"></a><h4>
+<a name="id640225"></a>
+ <a class="link" href="index.html#boost_task.overview.tested_platforms">Tested Platforms</a>
+ </h4>
+
+ Boost.Task has been tested on the following
+ platforms and compilers:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Debian GNU/Linux 2.6.29.2 (x86_64), GCC 4.3.3
+ </li>
+<li class="listitem">
+ Ubuntu GNU/Linux 2.6.28.11 (x86), GCC 4.3.3
+ </li>
+<li class="listitem">
+ FreeBSD 7.2 (x86), GCC 4.2.1
+ </li>
+<li class="listitem">
+ OpenSolaris 2009.06 (x86_64), GCC 4.3.2
+ </li>
+<li class="listitem">
+ Windows XP Professional (x86), MSVC 9.0
+ </li>
+</ul></div>
+<a name="boost_task.overview.how_to_build_and_install"></a><h4>
+<a name="id640269"></a>
+ <a class="link" href="index.html#boost_task.overview.how_to_build_and_install">How to build and
+ install</a>
+ </h4>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ download the sources form <a href="http://www.boost-consulting.com/vault/index.php?directory=Concurrent%20Programming" target="_top">Boost
+ Vault</a> or the latest development version from boost-sandbox
+</li>
+<li class="listitem">
+ extract the archive into the boost-source directory
+ </li>
+<li class="listitem">
+ call 'bjam toolset=<compiler-name> --with-task install'
+ in order to build and install Boost.Task
+</li>
+</ul></div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left">Last revised: June 23, 2009 at 18:15:43 GMT</td>
+<td align="right"><div class="copyright-footer"></div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav"><a accesskey="n" href="boost_task/motivation.html"><img src="../../doc/html/images/next.png" alt="Next"></a></div>
+</body>
+</html>

Added: sandbox/task/libs/task/doc/html/minimal.css
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/minimal.css 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,29 @@
+/*
+
+ © Copyright Beman Dawes, 2007
+
+ Distributed under the Boost Software License, Version 1.0.
+ See www.boost.org/LICENSE_1_0.txt
+
+*/
+
+/*******************************************************************************
+ Body
+*******************************************************************************/
+
+body { font-family: sans-serif; margin: 1em; }
+
+/*******************************************************************************
+ Table
+*******************************************************************************/
+
+table { margin: 0.5em; }
+
+/*******************************************************************************
+ Font sizes
+*******************************************************************************/
+
+p, td, li, blockquote { font-size: 10pt; }
+pre { font-size: 9pt; }
+
+/*** end ***/
\ No newline at end of file

Added: sandbox/task/libs/task/doc/html/reference.css
==============================================================================
--- (empty file)
+++ sandbox/task/libs/task/doc/html/reference.css 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -0,0 +1,11 @@
+/*============================================================================
+ Copyright 2003-2004 Douglas Gregor
+ Distributed under the Boost Software License, Version 1.0. (See accompany-
+ ing file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+============================================================================*/
+
+PRE.synopsis {
+ background-color: #e0ffff;
+ border: thin solid blue;
+ padding: 1em
+}
\ No newline at end of file

Modified: sandbox/task/libs/task/doc/introduction.qbk
==============================================================================
--- sandbox/task/libs/task/doc/introduction.qbk (original)
+++ sandbox/task/libs/task/doc/introduction.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -35,9 +35,11 @@
 // task, to be executed asynchronously
 boost::task::task< void > t( print, "Hello World!");

- boost::task::async( // dispatchs task,
- boost::move( t), // move task ownership to executor
- boost::task::new_thread() ) ); // execution-policy
+ // execute task in newly-created thread
+ // move task ownership to executor
+ boost::task::async(
+ boost::move( t),
+ boost::task::new_thread() ) );
 }
``

@@ -53,12 +55,15 @@
 // task returning the submitted string
 boost::task::task< std::string > t( echo, "Hello World!");

+ // execute task in newly-created thread
+ // move task ownership to executor
 boost::task::handle< std::string > h(
 boost::task::async(
- boost::move( t), // move task ownership to executor
- boost::task::new_thread() ) ); // execute task in a new thread
+ boost::move( t),
+ boost::task::new_thread() ) );

- std::cout << h.get() << std::endl; // wait until task is finished and return the result
+ // wait until task has finished and return the result
+ std::cout << h.get() << std::endl;
 }
``

@@ -70,17 +75,23 @@

 void main()
 {
- // long runing task
+ // create a long runing task
 boost::task::task< void > t( long_running, boost::posix_time::millisec( 500) );

+ // execute task in newly-created thread
+ // move task ownership to executor
 boost::task::handle< std::string > h(
 boost::task::async(
- boost::move( t), // move task ownership to executor
- boost::task::new_thread() ) ); // execute task in a new thread
-
- h.interrupt(); // interrupt execution of task
+ boost::move( t),
+ boost::task::new_thread() ) );

- std::cout << h.get() << std::endl; // wait until task is finished, will throw an task_interrupted exeception
+ // requests interruption of task
+ // returns immediately
+ h.interrupt();
+
+ // access the result
+ // task_interrupted exeception will be thrown
+ std::cout << h.get() << std::endl;
 }
``

@@ -99,17 +110,18 @@
 if ( n < cutof) return serial_fib( n);
 else
 {
- // fork a sub-task calculating fibonacci(n-1)
+ // create a sub-task calculating fibonacci(n-1)
 boost::task::task< long > t1(
 parallel_fib,
 n - 1,
 cutof);
- // fork a sub-task calculating fibonacci(n-2)
+ // create a sub-task calculating fibonacci(n-2)
 boost::task::task< long > t2(
 parallel_fib,
 n - 2,
 cutof);

+ // fork two sub-tasks
 boost::task::handle< long > h1(
 boost::task::async(
 boost::move( t1),
@@ -126,24 +138,28 @@

 void main()
 {
+ // create a thread-pool with five worker-threads
 boost::task::static_pool<
 boost::task::unbounded_channel<
 boost::task::fifo
>
> pool( boost::task::poolsize( 5) );

- // task calculates fibonacci-number for 10
+ // create task computing fibonacci-number for 10
 boost::task::task< long > t(
 parallel_fib,
 10,
 5);

+ // execute task in a thread-pool
+ // move task ownership to executor
 boost::task::handle< long > h(
 boost::task::async(
- boost::move( t), // move task ownership to thread-pool
- boost::task::default_pool() ) ); // execution-policy == thread-pool
+ boost::move( t),
+ pool) );

- std::cout << h.get() << std::endl;
+ // access the result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
 }
``

@@ -153,14 +169,17 @@
[link_work_stealing __work_stealing__] and [link_forkjoin inline execution] of tasks.

``
+ // create a long runing task
 boost::task::task< long > t(
 parallel_fib,
 10,
 5);

+ // move task ownership to executor
+ // sub-task executed in a new thread or inside the thread-pool
 boost::task::async(
 boost::move( t),
- boost::task::as_sub_task() ); // sub-task executed in a new thread or inside a thread-pool
+ boost::task::as_sub_task() );
``

Modified: sandbox/task/libs/task/doc/meta_functions.qbk
==============================================================================
--- sandbox/task/libs/task/doc/meta_functions.qbk (original)
+++ sandbox/task/libs/task/doc/meta_functions.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -13,12 +13,18 @@

``
+ // thread-pool with priority scheduling
+ // type of priority is int
 typdef boost::task::static_pool<
 boost::task::unbounded_channel<
- boost::task::priority< int > > // pool with priority scheduling; integer as priority type
+ boost::task::priority< int >
+ >
> pool_type;

+ // test if thread-pool supports priorities at compile time
 std::cout << std::boolalpha << boost::task::has_attribute< pool_type >::value << "\n";
+
+ // access the type used for priority
 std::cout << typeid( boost::task::attribute_type< pool_type >::type).name() << std::endl;
``

Modified: sandbox/task/libs/task/doc/new_thread.qbk
==============================================================================
--- sandbox/task/libs/task/doc/new_thread.qbk (original)
+++ sandbox/task/libs/task/doc/new_thread.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -47,13 +47,15 @@
reference gets out of scope). ]

-In the example below both `a_function()` and `another_function()` are executed synchron because the returned __handle__ joins the
-the __worker_thread__!
+In the example below both `a_function()` and `another_function()` are executed synchron because the returned __handle__ is not stored in
+a variable. Thatswhy the __worker_thread__ is joined after return from __fn_async__!

``
 boost::task::task< void > t1( a_function);
 boost::task::task< void > t2( another_function);

+ // handles are not retrieved
+ // both task executed in sequence
 boost::task::async(
 boost::move( t1),
 boost::task::new_thread() ) );

Modified: sandbox/task/libs/task/doc/overview.qbk
==============================================================================
--- sandbox/task/libs/task/doc/overview.qbk (original)
+++ sandbox/task/libs/task/doc/overview.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -8,9 +8,9 @@

[section:overview Overview]

-__boost_task__ provides an framework for parallel execution of tasks (a task is a small unit of code that can be executed independently).
+__boost_task__ provides a framework for parallel execution of tasks (a task is a small unit of code that can be executed independently).

-* __task__, __callable__ representing a fine-grained work-item:
+* __task__, a __callable__ representing a fine-grained work-item:
 * __fn_operator__ to execute the fine-grained work-item
 * __fn_get_future__ providing an __act__ in order to pass the result (values, exceptions) back to initiator

@@ -23,12 +23,12 @@
 * __fn_get_future__ returns reference to internal __shared_future__
 * functions __waitfor_all__/__waitfor_any__ to wait for all or any handles

-* __fn_async__, executes a task on behalf of __eps__
+* __fn_async__, executes a task by means of __eps__

* __ep__ models:
- * __own_thread__: executes task in current thread.
- * __new_thread__: executes task in a newly created thread (thread will be destroyed after)
- * __as_sub_task__: executes task in newly created thread or in a pool of __worker_threads__ depending on whether current task is already executed in a __thread_pool__
+ * __own_thread__: executes task in current thread
+ * __new_thread__: executes task in a newly-created thread (thread will be destroyed after completion)
+ * __as_sub_task__: executes task in newly-created thread or in a pool of __worker_threads__ depending on whether the parent-task is already executed in a __thread_pool__
 * __thread_pool__: task gets executed by a __worker_thread__ of a custom __thread_pool__ (for instance with priority or smart scheduling)

* __thread_pools__ with work-stealing algorithm and for/join semantics
@@ -36,7 +36,7 @@
* support of forking and joining sub-tasks
 * better performance
 * no deadlock because of inline-execution of sub-tasks
- * automatically detects if code runs in a __thread_pool__ so the appropriate mechanism for executing the sub-tasks is choosen
+ * detects if parent-task runs in a __thread_pool__ - the appropriate mechanism for executing the sub-tasks is choosen

In order to use the classes and functions described here, you can either include the specific headers specified by the descriptions of each class or function,
@@ -75,17 +75,27 @@

 void main()
 {
- // create two tasks for calculating fibonacci numbers
+ // create a thread-pool
+ boost::task::static_pool<
+ boost::task::unbounded_channel<
+ boost::task::fifo
+ >
+ > pool( boost::task::poolsize( 5) );
+
+ // create two tasks, computing fibonacci numbers
 boost::task< long > t1( fibonacci, 10);
 boost::task< long > t2( fibonacci, 5);

+ // execute tasks in thread-pool
 // move tasks ownership to executor
 boost::task::handle< long > h1(
 boost::task::async(
- boost::move( t1), tsk::new_thread() );
+ boost::move( t1),
+ pool);
 boost::task::handle< long > h2(
 boost::task::async(
- boost::move( t2), tsk::new_thread() );
+ boost::move( t2),
+ pool);

 std::cout << "h1: is ready == " << std::boolalpha << h1.is_ready() << "\n";
 std::cout << "h2: is ready == " << std::boolalpha << h2.is_ready() << "\n";
@@ -139,8 +149,8 @@

[heading How to build and install]

-* download the sources form [@http://www.boostpro.com/vault/index.php boost-vault] (section ['Concurrent Programing]) or the latest development version from
-[@https://svn.boost.org/svn/boost/sandbox/task/ boost-sandbox]
+* download the sources form [@http://www.boost-consulting.com/vault/index.php?directory=Concurrent%20Programming Boost Vault] or the latest
+development version from [@https://svn.boost.org/svn/boost/sandbox/task/ boost-sandbox]
* extract the archive into the boost-source directory
* call [''bjam toolset=<compiler-name> --with-task install'] in order to build and install __boost_task__

Modified: sandbox/task/libs/task/doc/pool.qbk
==============================================================================
--- sandbox/task/libs/task/doc/pool.qbk (original)
+++ sandbox/task/libs/task/doc/pool.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -23,19 +23,27 @@

 void main()
 {
+ // create a thread-pool with
+ // five worker-threads
+ // FIFO schduling of queued tasks
+ // and unlimited size of internal queue
 boost::task::static_pool<
 boost::task::unbounded_channel<
 boost::task::fifo
>
> pool( boost::task::poolsize( 5) );

+ // create task
 boost::task::task< std::string > t( echo, "Hello World!");

+ // move task to executor
+ // let the task be executed by the thread-pool
 boost::task::handle< std::string > h(
 boost::task::async(
 boost::move( t),
 pool) );

+ // access the result
 std::cout << h.get() << std::endl;
 }
``

Modified: sandbox/task/libs/task/doc/processor_binding.qbk
==============================================================================
--- sandbox/task/libs/task/doc/processor_binding.qbk (original)
+++ sandbox/task/libs/task/doc/processor_binding.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -12,11 +12,12 @@
be given to constructor instead __pool_size__ so that a __worker_thread__ is created an bound the the core.

``
- // constructs thread-pool with worker-threads as hardware_concurrency() returns
 typedef boost::task::static_pool<
 boost::task::unbounded_channel< boost::tp::fifo >
> pool_type;

+ // constructs thread-pool with worker-threads as
+ // CPUs/Cores are available on the system
 pool_type pool( pool_type::bind_to_processors() );
``

Modified: sandbox/task/libs/task/doc/ref_static_pool.qbk
==============================================================================
--- sandbox/task/libs/task/doc/ref_static_pool.qbk (original)
+++ sandbox/task/libs/task/doc/ref_static_pool.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -76,7 +76,7 @@
 template< typename R, typename Attr >
 handle< R > submit( task< R > && t, Attr const& attr);

- void swap( static_pool & other); // throw()
+ void swap( static_pool & other);

 operator unspecified_bool_type() const;
 bool operator!() const;

Modified: sandbox/task/libs/task/doc/scheduler.qbk
==============================================================================
--- sandbox/task/libs/task/doc/scheduler.qbk (original)
+++ sandbox/task/libs/task/doc/scheduler.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -21,22 +21,28 @@
Each __task__ is submitted to the pool with a priority attribute. The type and ordering of the priority is user-defined.

``
+ // thread-pool with priority scheduling
+ // tasks with higher priority are
+ // scheduled first
 boost::task::static_pool<
- boost::task::unbounded_channel< // allow unlimited tasks to be queue in global-queue
- boost::task::priority< int > > // tasks with lower priority are scheduled first
+ boost::task::unbounded_channel<
+ boost::task::priority< int > >
> pool( boost::task::poolsize( 5) );

- boost::task::task< void > t1( some_fn); // task to be executed
- boost::task::task< void > t2( another_fn); // task to be executed
+ boost::task::task< void > t1( some_fn);
+ boost::task::task< void > t2( another_fn);

+ // move task t1 with priority 5 to thread-pool
 boost::task::async(
 boost::move( t1),
- 5, // priority is 5
- pool); // thread-pool
+ 5,
+ pool);
+
+ // move task t2 with priority 3 to thread-pool
 boost::task::async(
- boost::move( t2), // task to be executed
- 3, // priority is 3
- pool); // thread-pool
+ boost::move( t2),
+ 3,
+ pool);
``

In this example the tasks get scheduled by the assigned integer (third argument of __fn_async__). The __task__ with the
@@ -44,10 +50,13 @@
of __priority__ (the default is `std::greater< Attr >`).

``
+ // thread-pool with priority scheduling
+ // tasks with lower priority are
+ // scheduled first
 boost::task::static_pool<
 boost::task::unbounded_channel<
- boost::task::priority< int > > // tasks with higher priority are scheduled first
-
+ boost::task::priority< int, std::less< int > >
+ >
> pool( boost::task::poolsize( 5) );
``

Modified: sandbox/task/libs/task/doc/shutdown.qbk
==============================================================================
--- sandbox/task/libs/task/doc/shutdown.qbk (original)
+++ sandbox/task/libs/task/doc/shutdown.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -57,7 +57,8 @@
 boost::move( t2),
 pool) );

- pool.shutdown(); // waits until all pending tasks are finished
+ // waits until all pending tasks are finished
+ pool.shutdown();

 std::cout << "fibonacci(10) == " << h1.get() << "\n";
 std::cout << "fibonacci(5) == " << h2.get() << std::endl;
@@ -111,10 +112,13 @@
 boost::move( t2),
 pool) );

+ // requests task interruption and
+ // joins all worker-threads
 pool.shutdown_now();

- std::cout << "fibonacci(10) == " << h1.get() << "\n"; // may throw broken_task or task_interrupted
- std::cout << "fibonacci(5) == " << h2.get() << std::endl; // may throw broken_task or task_interrupted
+ // accessing the result may throw task_interrupted
+ std::cout << "fibonacci(10) == " << h1.get() << "\n";
+ std::cout << "fibonacci(5) == " << h2.get() << std::endl;
 }
``

Modified: sandbox/task/libs/task/doc/static_pool.qbk
==============================================================================
--- sandbox/task/libs/task/doc/static_pool.qbk (original)
+++ sandbox/task/libs/task/doc/static_pool.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -13,14 +13,14 @@

``
- boost::task::_static_pool< // pool type
- boost::task::unbounded_channel< // queuing policy (unbounded_channel, bounded_channel)
- boost::task::fifo // scheduling policy (fifo, priority, smart)
- >
- > pool(
- boost::task::poolsize( 6), // pool with 6 pre-forked worker-threads
- boost::posix_time::posix_time::milliseconds( 50), // time to sleep if no work-item available
- boost::task::scanns( 10) ); // iterations over local-queues before sleep
+ boost::task::_static_pool< // pool type
+ boost::task::unbounded_channel< // queuing policy (unbounded_channel, bounded_channel)
+ boost::task::fifo // scheduling policy (fifo, priority, smart)
+ >
+ > pool(
+ boost::task::poolsize( 6), // pool with 6 pre-forked worker-threads
+ boost::posix_time::posix_time::milliseconds( 50), // time to sleep if no work-item available
+ boost::task::scanns( 10) ); // iterations over local-queues before sleep
``

Modified: sandbox/task/libs/task/doc/task.qbk
==============================================================================
--- sandbox/task/libs/task/doc/task.qbk (original)
+++ sandbox/task/libs/task/doc/task.qbk 2009-06-23 14:16:55 EDT (Tue, 23 Jun 2009)
@@ -78,14 +78,16 @@
``
 long cooperative( long n)
 {
- boost::this_thread::interruption_point(); // interruption point
+ // interruption point
+ boost::this_thread::interruption_point();

 if ( n == 0) return 0;
 if ( n == 1) return 1;
 long k1( 1), k2( 0);
 for ( int i( 2); i <= n; ++i)
 {
- if ( boost::this_thread::interruption_requested() ) // check if interruption was requested
+ // check if interruption was requested
+ if ( boost::this_thread::interruption_requested() )
 return;

 long tmp( k1);
@@ -93,27 +95,31 @@
 k2 = tmp;
 }

- boost::this_thread::interruption_point(); // interruption point
+ // interruption point
+ boost::this_thread::interruption_point();

 return k1;
 }

 void main()
 {
- // task for calculating fibonacci number
+ // task for computing fibonacci-number
 boost::task::task< long > t( cooperative, 10) );

 // execute task in new thread
+ // move task ownership to executor
 boost::task::handle< long > h(
 boost::task::async(
 boost::move( t),
 boost::task::new_thread() ) );

- // interrupt task an wait until it is removed by the worker-thread
+ // interrupt task an wait until
+ // the task is removed by the worker-thread
 h.interrupt_and_wait();

+ // access the result
 // throws boost::task::task_interrupted
- std::cout << h.get() << std::endl;
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
 }
``

@@ -132,15 +138,17 @@

 void main()
 {
- // task will throw std::domain_error
+ // create task throwing std::domain_error
 boost::task::task void > t( throwing);

 // execute task asynchron
+ // move task ownership to executor
 boost::task::handle< void > h(
 boost::task::async(
 boost::move( t),
 boost::task::new_thread() ) );

+ // wait for task completion
 // throws std::domain_error
 std::cout << h.wait() << std::endl;
 }
@@ -194,54 +202,56 @@
 if ( n < cutof) return serial_fib( n);
 else
 {
- // sub-task for calculating fibonacci(n-1)
+ // sub-task for computing fibonacci(n-1)
 boost::task::task< long > t1(
 parallel_fib,
 n - 1,
 cutof);
- // sub-task for calculating fibonacci(n-2)
+ // sub-task for computing fibonacci(n-2)
 boost::task::task< long > t2(
 parallel_fib,
 n - 2,
 cutof);

- // submit a sub-task to pool calculating fibonacci(n-1)
+ // submit a sub-tasks to thread-pool
+ // move task ownership to executor
 boost::task::handle< long > h1(
 boost::task::async(
 boost::move( t1) );
- // submit a sub-task to pool calculating fibonacci(n-2)
 boost::task::handle< long > h2(
 boost::task::async(
 boost::move( t2) );

- // calculate fibonacci(n) by joining results of both sub-tasks
+ // computing fibonacci(n) by
+ // joining results of both sub-tasks
 return h1.get() + h2.get();
 }
 }

 void main()
 {
- // create thread-pool
+ // create thread-pool with five worker-threads
 boost::task::static_pool<
 boost::task::unbounded_channel<
 boost::task::fifo
>
> pool( boost::task::poolsize( 5) );

- // task calculates recursivly fibonacci-numberof 10
+ // create task computing fibonacci-number for 10
 boost::task::task< long > t(
 parallel_fib,
 10,
 5);

 // execute task asynchron in thread-pool
+ // move task ownership to executor
 boost::task::handle< long > h(
 boost::task::async(
 boost::move( t),
 pool) );

- // get result
- std::cout << h.get() << std::endl;
+ // access result
+ std::cout << "fibonacci(10) == " << h.get() << std::endl;
 }
``

Next message: oliver.kowalke_at_[hidden]: "[Boost-commit] svn:boost r54287 - sandbox/task/libs/task/examples"
Previous message: john_at_[hidden]: "[Boost-commit] svn:boost r54285 - branches/release/boost/math/special_functions"

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk