--- a/model/prov-dm.html	Thu Jun 07 12:27:02 2012 +0100
+++ b/model/prov-dm.html	Thu Jun 07 17:46:09 2012 +0100
@@ -2477,6 +2477,9 @@
 
 <span class="glossary-ref" data-ref="glossary-contextualization"></span>
 
+<div class="note">
+contextualization is the specialization of a "nonlocal" entity by "fixing" the bundle that it is in. Once this is done, one can then use specialization _again_ to link a "local" entity to a "nonlocal" entity. 
+</div>
 
 <p><div class="attributes" id="attributes-contextualization">A <dfn title="contextualizationOf">contextualization</dfn> relation<span class="withPn">, written <span class="pnExpression">contextualizationOf(i2, i1, b)</span> in PROV-N,</span> has:
 <ul>
@@ -2501,19 +2504,19 @@
     wasAssociatedWith(ex:a2,ex:Bob,[prov:role="controller"])
 endBundle
 </pre> 
-<p>A performance rating tool reads these bundles, and rates the performance of the agent described in these bundles. The performance rating tool creates a new bundle <span class="name">tool:analysis01</span> containing the following. A new agent <span class="name">tool:Bob1</span> is declared as a contextualization of <span class="name">ex:Bob</span> as described in context <span class="name">ex:run1</span>, and likewise for  <span class="name">tool:Bob2</span> with respect to <span class="name">ex:run2</span>. The tool then defines two specializations of these contextualized agents with an associated rating. The performance of the agent in the first bundle is judged to be good since the duration of <span class="name">ex:a1</span> is one hour, whereas it is judged to be bad in the second bundle since <span class="name">ex:a2</span>'s duration is seven hours.
+<p>A performance rating tool reads these bundles, and rates the performance of the agent described in these bundles. The performance rating tool creates a new bundle <span class="name">tool:analysis01</span> containing the following. A new agent <span class="name">tool:Bob-2011-11-16</span> is declared as a contextualization of <span class="name">ex:Bob</span> as described in context <span class="name">ex:run1</span>, and likewise for  <span class="name">tool:Bob-2011-11-17</span> with respect to <span class="name">ex:run2</span>. The tool then defines two specializations of these contextualized agents with an associated rating. The performance of the agent in the first bundle is judged to be good since the duration of <span class="name">ex:a1</span> is one hour, whereas it is judged to be bad in the second bundle since <span class="name">ex:a2</span>'s duration is seven hours.
 
 <pre class="codeexample">
 bundle tool:analysis01
-    agent(tool:Bob1)
-    contextualizationOf(tool:Bob1, ex:Bob, ex:run1)
-    agent(tool:ratedBob1, [perf:rating="good"])
-    specialization(tool:ratedBob1, tool:Bob1)
-
-    agent(tool:Bob2)
-    contextualizationOf(tool:Bob2, ex:Bob, ex:run2)
-    agent(tool:ratedBob2, [perf:rating="bad"])
-    specialization(tool:ratedBob2, tool:Bob2)
+    agent(tool:Bob-2011-11-16)
+    contextualizationOf(tool:Bob-2011-11-16, ex:Bob, ex:run1)
+    agent(tool:rated-Bob-2011-11-16, [perf:rating="good"])
+    specialization(tool:rated-Bob-2011-11-16, tool:Bob-2011-11-16)
+
+    agent(tool:Bob-2011-11-17)
+    contextualizationOf(tool:Bob-2011-11-17, ex:Bob, ex:run2)
+    agent(tool:rated-Bob-2011-11-17, [perf:rating="bad"])
+    specialization(tool:rated-Bob-2011-11-17, tool:Bob-2011-11-17)
 endBundle
 </pre>
 </div>