dm minor edits
authorLuc Moreau <l.moreau@ecs.soton.ac.uk>
Fri, 25 May 2012 10:32:13 +0100
changeset 2980 e2f24ffc93cf
parent 2979 ddd6e33c8459
child 2981 fca0cea59846
dm minor edits
model/glossary.html
model/glossary.js
model/prov-dm.html
--- a/model/glossary.html	Fri May 25 10:14:06 2012 +0100
+++ b/model/glossary.html	Fri May 25 10:32:13 2012 +0100
@@ -221,5 +221,7 @@
 
 
 <span class="glossary" id="glossary-provenance-locator">  
-A <dfn id="concept-provenance-locator">provenance locator</dfn> is information that helps locate provenance descriptions.  It may identify a service, or may consist of a URI where provenance descriptions can be found. It can further identify a bundle within which provenance descriptions can be found.   
+A <dfn id="concept-provenance-locator">provenance locator</dfn> is information that helps locate provenance descriptions.
+ It can identify a bundle within which provenance descriptions can be found.   
+  It may further identify a service, or may offer a IRI where provenance descriptions can be found.
 </span>
--- a/model/glossary.js	Fri May 25 10:14:06 2012 +0100
+++ b/model/glossary.js	Fri May 25 10:32:13 2012 +0100
@@ -3,7 +3,7 @@
 //  with <script src="glossary.js" class="remove"></script>
 //Insert glossary definitions with the following 
 // <div class="glossary-ref" ref="glossary-generation"></div>
-glossary_hg='http://dvcs.w3.org/hg/prov/file/45a595d80e4c/model/glossary.html';
+glossary_hg='http://dvcs.w3.org/hg/prov/file/ddd6e33c8459/model/glossary.html';
 glossary_string= 
 ' ' + 
 '<html> ' + 
@@ -228,6 +228,8 @@
 ' ' + 
 ' ' + 
 '<span class="glossary" id="glossary-provenance-locator">   ' + 
-'A <dfn id="concept-provenance-locator">provenance locator</dfn> is information that helps locate provenance descriptions.  It may identify a service, or may consist of a URI where provenance descriptions can be found. It can further identify a bundle within which provenance descriptions can be found.    ' + 
+'A <dfn id="concept-provenance-locator">provenance locator</dfn> is information that helps locate provenance descriptions. ' + 
+' It can identify a bundle within which provenance descriptions can be found.    ' + 
+'  It may further identify a service, or may offer a IRI where provenance descriptions can be found. ' + 
 '</span> ' + 
 ' ' ;
--- a/model/prov-dm.html	Fri May 25 10:14:06 2012 +0100
+++ b/model/prov-dm.html	Fri May 25 10:32:13 2012 +0100
@@ -1722,7 +1722,10 @@
 wasGeneratedBy  (ex:bbcNews2012-04-03, -, 2012-04-03T00:00:01)
 wasInvalidatedBy(ex:bbcNews2012-04-03, -, 2012-04-03T23:59:59)
 </pre>
-We refer to example <a href="#anexample-specialization">anexample-specialization</a> for further descriptions of the BBC Web site, and to  <a href="#term-dictionary-membership">Section 5.6.5</a> for a description of the relation <a>memberOf</a>.
+
+We refer to example
+<a href="#anexample-specialization" class="anexample-ref"><span>Example REF</span></a>
+ for further descriptions of the BBC Web site, and to  <a href="#term-dictionary-membership">Section 5.6.5</a> for a description of the relation <a>memberOf</a>.
 </div>
 
 
@@ -2493,7 +2496,7 @@
 <h3>Provenance Locator</h3>
 
 
-In <a href="#anexample-provenance-of-provenance" class="anexample-ref"><span>Example REF</span></a>, we initially presented a scenario involving two entities <span class="name">report1</span> and <span class="name">report2</span>, and showed how the descriptions can be organized into two bundles.  There is no explicit indication that the second bundle "continues" the description offered by the first bundle.  Given that bundles may be retrieved separately [[PROV-AQ]], it is not obvious for a provenance consumer to navigate descriptions across bundles.  To aid consumers,
+In <a href="#anexample-provenance-of-provenance" class="anexample-ref"><span>Example REF</span></a>, we initially presented a scenario involving two entities <span class="name">report1</span> and <span class="name">report2</span>, and showed how their descriptions can be organized into two bundles.  There is no explicit indication that the second bundle "is a continuation" of the description offered by the first bundle.  Given that bundles may be retrieved separately [[PROV-AQ]], it is not obvious for a provenance consumer to navigate descriptions across bundles.  To aid consumers,
  Alice may wish to express that there is further provenance information about <span class="name">report1</span> in bundle <span class="name">bob:bundle1</span>.  To this end, PROV introduces the notion of provenance locator, inspired by [[PROV-AQ]].
 
 
@@ -2520,7 +2523,7 @@
 </div>
 
 <p>When the subject and optional target denote entities,
-a provenance locator not only provides a located context, but it also expresses an <a>alternate</a> relation between the entity denoted by <span class="name">subject</span> and the  entity described in the located context. This is a alternate since the entity denoted by <span class="name">subject</span> in the current context presents other aspects than the entity in the located one.</p>
+a provenance locator not only provides a <em>located context</em>, but it also expresses an <a>alternate</a> relation between the entity denoted by <span class="name">subject</span> and the  entity described in the located context. This is an alternate since the entity denoted by <span class="name">subject</span> in the current context presents other aspects than the entity in the located one.</p>
 
 <div class="anexample" id="anexample-provenance-locator">
 <p>According to the following provenance locator, provenance descriptions about <span class="name">ex:report1</span> can be found in bundle <span class="name">bob:bundle1</span>.</p>
@@ -2579,7 +2582,7 @@
 </div>
 
 <div class="anexample" id="aexample-note">
-<p>Consider that the following bundle of descriptions, in which derivation and generations have been identified.
+<p>Consider the following bundle of descriptions, in which derivation and generations have been identified.
 <pre class="codeexample"> 
 bundle obs:bundle7
   entity(ex:report1, [prov:type="report", ex:version=1])
@@ -2597,11 +2600,11 @@
   entity(tool:bundle8, [ prov:type='viz:Configuration', prov:type='prov:Bundle' ])
   wasAttributedTo(tool:bundle8, viz:Visualizer)
 
-  entity(ex:report1, [viz:color="orange"])
+  entity(ex:report1, [viz:color="orange"])              // ex:report1 is a reused identifier
   hasProvenanceIn(ex:report1, obs:bundle7, -)
 
-  entity(ex:report2, [viz:color="blue"])
-  hasProvenanceIn(ex:report2, obs:bundle7, -)
+  entity(tool:r2, [viz:color="blue"])                   // tool:r2  is a new identifier
+  hasProvenanceIn(tool:r2, obs:bundle7, ex:report2)
 
   wasDerivedBy(ex:d; ex:report2, ex:report1, [viz:style="dotted"])
   hasProvenanceIn(ex:d, obs:bundle7, -)
@@ -2613,7 +2616,9 @@
 <p>Bundle <span class="name">tool:bundle8</span> is given type <span class="name">viz:Configuration</span> to indicate that it consists of descriptions that pertain to the configuration of the visualisation tool. This type attribute can be used for searching bundles containing visualization-related descriptions.
 </p>
 
-<p>Alternates of the entities <span class="name">ex:report1</span> and <span class="name">ex:report2</span> have a visualization attribute for the color to be used when rendering these entities. 
+<p>For the purpose of illustration, we show that the visualisation tool
+reused identifier <span class="name">ex:report1</span>, but created a new identifier <span class="name">tool:r2</span>.
+They denote entities which are alternates of with <span class="name">ex:report1</span> and <span class="name">ex:report2</span>, described in bundle <span class="name">obs:bundle7</span>, with visualization attribute for the color to be used when rendering these entities.  
 Likewise, the derivation has a style attribute. </p>
 
 <p>According to their definition,