6c6
<   the management of tasks and tasklists for people.   jBPM allows to 
---
>   the management of tasks and task-lists for people.   jBPM allows to 
23c23
<     <literal>task-node</literal>, the default behaviour is to wait for all the 
---
>     <literal>task-node</literal>, the default behavior is to wait for all the 
37c37
<     TaskInstances can change this initial priority afterwards.</para>
---
>     TaskInstances can change this initial priority afterward.</para>
45c45
<     all task instances for a given actorId, you get the task list for that perticular user.
---
>     all task instances for a given actorId, you get the task list for that particular user.
54,55c54,55
<       <title>Task instance lifecycle</title>
<       <para>The task instance lifecycle is straightforward: After creation, task instances can optionally 
---
>       <title>Task instance life-cycle</title>
>       <para>The task instance life-cycle is straightforward: After creation, task instances can optionally 
63c63
<       Then, a user interface component will query the database for the tasklists using the 
---
>       Then, a user interface component will query the database for the task lists using the 
68c68
<       <para>A task instance maintains it's state by means of date-properties : <literal>create</literal>, 
---
>       <para>A task instance maintains its state by means of date-properties : <literal>create</literal>, 
78c78
<       <para>Task instances are the items in an actor's tasklist.  Task instances 
---
>       <para>Task instances are the items in an actor's task list.  Task instances 
92,97c92,97
<         <listitem><emphasis role="bold">last</emphasis>: This is the default.  Proceeds execution when the last task instance is completed. When no tasks are created on entrance of this node, execution is continued.</listitem>
<         <listitem><emphasis role="bold">last-wait</emphasis>:                  Proceeds execution when the last task instance is completed. When no tasks are created on entrance of this node, execution waits in the task node till tasks are created.</listitem>
<         <listitem><emphasis role="bold">first</emphasis>:                      Proceeds execution when the first task instance is completed. When no tasks are created on entrance of this node, execution is continued.</listitem>
<         <listitem><emphasis role="bold">first-wait</emphasis>:                 Proceeds execution when the first task instance is completed. When no tasks are created on entrance of this node, execution waits in the task node till tasks are created.</listitem>
<         <listitem><emphasis role="bold">unsynchronized</emphasis>: Execution always continues, regardless wether tasks are created or still unfinished.</listitem>
<         <listitem><emphasis role="bold">never</emphasis>: Execution never continues, regardless wether tasks are created or still unfinished.</listitem>
---
>         <listitem><para><emphasis role="bold">last</emphasis>: This is the default.  Proceeds execution when the last task instance is completed. When no tasks are created on entrance of this node, execution is continued.</para></listitem>
>         <listitem><para><emphasis role="bold">last-wait</emphasis>:                  Proceeds execution when the last task instance is completed. When no tasks are created on entrance of this node, execution waits in the task node until tasks are created.</para></listitem>
>         <listitem><para><emphasis role="bold">first</emphasis>:                      Proceeds execution when the first task instance is completed. When no tasks are created on entrance of this node, execution is continued.</para></listitem>
>         <listitem><para><emphasis role="bold">first-wait</emphasis>:                 Proceeds execution when the first task instance is completed. When no tasks are created on entrance of this node, execution waits in the task node until tasks are created.</para></listitem>
>         <listitem><para><emphasis role="bold">unsynchronized</emphasis>: Execution always continues, regardless whether tasks are created or still unfinished.</para></listitem>
>         <listitem><para><emphasis role="bold">never</emphasis>: Execution never continues, regardless whether tasks are created or still unfinished.</para></listitem>
105c105
<       <programlisting>public class CreateTasks implements ActionHandler {
---
>       <programlisting language="java">public class CreateTasks implements ActionHandler {
143,144c143,144
<     <para>With jBPM, <link linkend="thepersonaltasklist">push (personal task list)</link> and 
<     <link linkend="thegrouptasklist">pull (group task list)</link> model (see below) of 
---
>     <para>With jBPM, push (personal task list)<footnote><para><xref linkend="thepersonaltasklist"/>.</para></footnote> and 
>     pull (group task list)<footnote><para><xref linkend="thegrouptasklist"/>.</para></footnote> model (see below) of 
146c146
<     The process can calculate the responsible for a task and push it in his/her tasklist.
---
>     The process can calculate the responsible for a task and push it in his/her task list.
149c149
<     personal tasklist.
---
>     personal task list.
157c157
<       <programlisting>public interface AssignmentHandler extends Serializable {
---
>       <programlisting language="java">public interface AssignmentHandler extends Serializable {
169c169
<       <programlisting>public interface Assignable {
---
>       <programlisting language="java">public interface Assignable {
183c183
<       or group of actors, consider the usage of a <link linkend="swimlanes">swimlane</link></para>
---
>       or group of actors, consider the usage of a swimlane<footnote><para><xref linkend="swimlanes"/>.</para></footnote></para>
192c192
<       <para>The datamodel for managing assignments of task instances and swimlane instances to 
---
>       <para>The data model for managing assignments of task instances and swimlane instances to 
198c198
<         <mediaobject><imageobject><imagedata align="center" fileref="images/assignment.model.gif"/></imageobject></mediaobject>
---
>         <mediaobject><imageobject><imagedata  fileref="images/assignment.model.png"/></imageobject></mediaobject>
215,217c215,217
<         <listitem>Specify an expression in the attribute <literal>actor-id</literal> of the task element in the process</listitem>
<         <listitem>Use TaskInstance.setActorId(String) from anywhere in your code</listitem>
<         <listitem>Use assignable.setActorId(String) in an AssignmentHandler</listitem>
---
>         <listitem><para>Specify an expression in the attribute <literal>actor-id</literal> of the task element in the process</para></listitem>
>         <listitem><para>Use TaskInstance.setActorId(String) from anywhere in your code</para></listitem>
>         <listitem><para>Use assignable.setActorId(String) in an AssignmentHandler</para></listitem>
232c232
<       groupIds in the pooledActorIds.  So specify the pooled actors, use one of the following:
---
>       groupIds in the pooledActorIds.  To specify the pooled actors, use one of the following:
235,237c235,237
<         <listitem>Specify an expression in the attribute <literal>pooled-actor-ids</literal> of the task element in the process</listitem>
<         <listitem>Use TaskInstance.setPooledActorIds(String[]) from anywhere in your code</listitem>
<         <listitem>Use assignable.setPooledActorIds(String[]) in an AssignmentHandler</listitem>
---
>         <listitem><para>Specify an expression in the attribute <literal>pooled-actor-ids</literal> of the task element in the process</para></listitem>
>         <listitem><para>Use TaskInstance.setPooledActorIds(String[]) from anywhere in your code</para></listitem>
>         <listitem><para>Use assignable.setPooledActorIds(String[]) in an AssignmentHandler</para></listitem>
268c268
<     <para>The controller can be used to create populate and submit variables between 
---
>     <para>The controller can be used to create, populate and submit variables between 
284,286c284,286
<       <listitem>a) create copies of variables in the task instances so that intermediate updates 
<         to the task instance variables don't affect the process variables untill the process 
<         is finished and the copies are submitted back into the process variables.
---
>       <listitem><para>a) create copies of variables in the task instances so that intermediate updates 
>         to the task instance variables don't affect the process variables until the process 
>         is finished and the copies are submitted back into the process variables.</para>
288,290c288,290
<       <listitem>b) the task instance variables do not relate one-on-one with the process variables.
<         E.g. suppose the process has variables 'sales in januari' 'sales in februari' and 'sales in march'.
<         Then the form for the task instance might need to show the average sales in the 3 months.
---
>       <listitem><para>b) the task instance variables do not relate one-on-one with the process variables.
>         E.g. suppose the process has variables 'sales in January' 'sales in February' and 'sales in march'.
>         Then the form for the task instance might need to show the average sales in the 3 months.</para>
308c308
<       <mediaobject><imageobject><imagedata align="center" fileref="images/task.controllers.jpg"/></imageobject></mediaobject>
---
>       <mediaobject><imageobject><imagedata  fileref="images/task.controllers.png"/></imageobject></mediaobject>
321c321
<     <programlisting>&lt;task name=&quot;clean ceiling&quot;&gt;
---
>     <programlisting language="xml">&lt;task name=&quot;clean ceiling&quot;&gt;
338c338
<       creation, will be written back to the process variables at task end and wether it is 
---
>       creation, will be written back to the process variables at task end and whether it is 
352c352
<     <programlisting>public interface TaskControllerHandler extends Serializable {
---
>     <programlisting language="java">public interface TaskControllerHandler extends Serializable {
359c359
<     <programlisting>&lt;task name=&quot;clean ceiling&quot;&gt;
---
>     <programlisting language="xml">&lt;task name=&quot;clean ceiling&quot;&gt;
373c373
<     <link linkend="assignment"><literal>assignment</literal></link>
---
>     <literal>assignment</literal><footnote><para><xref linkend="assignment"/>.</para></footnote>
375c375
<     <link linkend="assignment"><literal>assignment</literal></link>. 
---
>     <literal>assignment</literal><footnote><para><xref linkend="assignment"/>.</para></footnote>. 
383c383
<     propagate to the swimlane instance.  This behaviour is implemented as the default 
---
>     propagate to the swimlane instance.  This behavior is implemented as the default 
385c385
<     have the knowledge of that perticular process.  So all subsequent assignements 
---
>     have the knowledge of that particular process.  So all subsequent assignments 
400c400
<     <link linkend="authentication">Authentication.getAuthenticatedActorId()</link>
---
>     Authentication.getAuthenticatedActorId()<footnote><para><xref linkend="authentication"/>.</para></footnote>
404c404
<     <programlisting>&lt;process-definition&gt;
---
>     <programlisting language="xml">&lt;process-definition&gt;
410d409
<   ...
442c441
<     for task timers can be customized.  By default, a timer on a task will be cancelled when 
---
>     for task timers can be customized.  By default, a timer on a task will be canceled when 
473,475c472,474
<     includes knowledge of the organisational model.
<     Task assignment is typically done with organisational knowledge. 
<     So this implies knowledge of an organisational model, describing the 
---
>     includes knowledge of the organizational model.
>     Task assignment is typically done with organizational knowledge. 
>     So this implies knowledge of an organizational model, describing the 
477c476
<     permissions and roles can be included too in an organisational model.
---
>     permissions and roles can be included too in an organizational model.
479c478
<     organisational model can be created that fits every organisation.
---
>     organizational model can be created that fits every organization.
484c483
<     actorId.  jBPM has only knowledge about actorId's and they are represented 
---
>     actorId.  jBPM has only knowledge about actorIds and they are represented 
486c485
<     knowledge about the organisational model and the structure of that data 
---
>     knowledge about the organizational model and the structure of that data 
499c498
<     the organisational structure of users involved in a process.</para>
---
>     the organizational structure of users involved in a process.</para>
506c505
<         <mediaobject><imageobject><imagedata align="center" fileref="images/identity.model.gif"/></imageobject></mediaobject>
---
>         <mediaobject><imageobject><imagedata  fileref="images/identity.model.png"/></imageobject></mediaobject>
517c516
<       haircolor groups. <literal>Membership</literal>s represent the 
---
>       hair color groups. <literal>Membership</literal>s represent the 
520c519
<       can be used to indicate the role that the user fullfills in the 
---
>       can be used to indicate the role that the user fulfills in the 
530,531c529
<       <programlisting>&lt;process-definition&gt;
<   ...
---
>       <programlisting language="xml">&lt;process-definition&gt;
537,538c535
<   &lt;/task-node&gt;
<   ...</programlisting>
---
>   &lt;/task-node&gt;</programlisting>
602,603c599,600
<       <para>When you want to use your own datasource for organisational 
<       information such as your company's user database or ldap system, 
---
>       <para>When you want to use your own datasource for organizational 
>       information such as your company's user database or LDAP system, 
606c603
<       <programlisting>&lt;mapping resource="org/jbpm/identity/User.hbm.xml"/&gt;
---
>       <programlisting language="xml">&lt;mapping resource="org/jbpm/identity/User.hbm.xml"/&gt;
617c614
<       <programlisting>protected ExpressionSession getExpressionSession(AssignmentContext assignmentContext);</programlisting>
---
>       <programlisting language="java">protected ExpressionSession getExpressionSession(AssignmentContext assignmentContext);</programlisting>
