text on bundles
authorLuc Moreau <l.moreau@ecs.soton.ac.uk>
Thu, 03 May 2012 09:33:57 +0100
changeset 2683 ccf55d96f6f9
parent 2682 08a9d5d69512
child 2684 11ea3599fa93
text on bundles
model/glossary.html
model/glossary.js
model/working-copy/wd6-bundle.html
--- a/model/glossary.html	Thu May 03 08:56:36 2012 +0100
+++ b/model/glossary.html	Thu May 03 09:33:57 2012 +0100
@@ -210,5 +210,5 @@
 </span>
 
 <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 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 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.   
 </span>
--- a/model/glossary.js	Thu May 03 08:56:36 2012 +0100
+++ b/model/glossary.js	Thu May 03 09:33:57 2012 +0100
@@ -217,6 +217,6 @@
 '</span> ' + 
 ' ' +
 '<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 a URI where provenance can be found. It can further identify a bundle within provenance descriptions can be found.   ' +
+'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 can be found. It can further identify a bundle within which provenance descriptions can be found.   ' +
 '</span>' +
 ' ' ;
--- a/model/working-copy/wd6-bundle.html	Thu May 03 08:56:36 2012 +0100
+++ b/model/working-copy/wd6-bundle.html	Thu May 03 09:33:57 2012 +0100
@@ -417,11 +417,11 @@
 <div class="attributes" id="attributes-bundle">
  A <dfn title="dfn-bundle" id="dfn-bundle">bundle</dfn>, written <span class="pnExpression">bundle id description_1 ... description_n</span>, consists of:
 <ul>
-<li><span class='attribute' id="bundle.id">id</span>:  an identifier for the bundle;</li>
+<li><span class='attribute' id="bundle.id">id</span>:  an OPTIONAL identifier for the bundle;</li>
 <li><span class='attribute' id="bundle.descriptions">descriptions</span>: a set of provenance descriptions <span class="name">
 description_1</span>, ..., <span class="name">description_n</span>.</li>
 </ul>
-
+<p>A bundle without identifier is referred to as a default bundle. Since it lacks an identifier, a default bundle cannot be described, and cannot be associated with some provenance descriptions. Default bundles are provided for convenience, when provenance of provenance does not have to be expressed.</p>
 </section>
 
 
@@ -437,17 +437,20 @@
 <div class="attributes" id="attributes-hasProvenanceIn">
 A <dfn title="hasProvenanceIn">provenance locator</dfn>,
 written
-<span class="pnExpression">hasProvenance(id,b,s,p)</span>, has:
+<span class="pnExpression">hasProvenance(id,b,s,p,attrs)</span>, has:
 <ul>
 <li><span class='attribute' id="provenance.in.id">id</span>:  an identifier denoting an entity;</li>
 <li><span class='attribute' id="provenance.in.bundle">bundle</span>:  an OPTIONAL identifier (<span class="name">b</span>) for a bundle;
-<li><span class='attribute' id="provenance.in.service">service</span>:  an OPTIONAL URI (<span class="name">s</span>) denoting a <a href="http://www.w3.org/TR/prov-aq/#provenance-service">provenance service</a> at which provenance can be retrieved according to [[PROV-AQ]];
-<li><span class='attribute' id="provenance.in.provenance">provenance</span>:  an OPTIONAL URI (<span class="name">p</span>) where provenance descriptions can be found.
+<li><span class='attribute' id="provenance.in.service">service</span>:  an OPTIONAL URI (<span class="name">s</span>) denoting a <a href="http://www.w3.org/TR/prov-aq/#provenance-service">provenance service</a> from which provenance can be retrieved according to [[PROV-AQ]];
+<li><span class='attribute' id="provenance.in.provenance">provenance</span>:  an OPTIONAL URI (<span class="name">p</span>) where provenance descriptions can be found;
+<li><span class='attribute' id="derivation.attributes">attributes</span>: an OPTIONAL set (<span class="name">attrs</span>) of attribute-value pairs representing additional information about this locator.</li>
 </ul>
-<p>In <span class="pnExpression">hasProvenance(id, b, s, p)</span>, <span class="name">s</span> and <span class="name">p</span> are both optional and mutually exclusive: if specified at all, either <span class="name">s</span> or <span class="name">p</span> is provided.</p>
+<p>In <span class="pnExpression">hasProvenance(id, b, s, p)</span>, <span class="name">s</span> and <span class="name">p</span> are both optional and mutually exclusive: if specified, either <span class="name">s</span> or <span class="name">p</span> is provided.</p>
 </div>
 
-<p>A provenance locator not only provides information about the location of provenance descriptions, it also defines a specialization relation between the entity identified by <span class="name">id</span> and the eponym entity described where indicated by the provenance locator. This is specialization since the entity <span class="name">id</span> is more constrained in the current context than in the located one.</p>
+<p>A provenance locator not only provides information about the location of provenance descriptions, it also defines a <a>specialization</a> relation between the entity identified by <span class="name">id</span> and the eponym entity described where indicated by the provenance locator. This is specialization since the entity <span class="name">id</span> is more constrained in the current context than in the located one.</p>
+
+<div class='note'>Should the subject be restricted to an entity?</div>
 
 <div class="anexample" id="anexample-provenance-locator">
 <p>According to the following provenance locator, provenance descriptions about <span class="name">ex:e1</span> can be found in bundle <span class="name">uuid:01</span>.</p>
@@ -498,7 +501,7 @@
 </pre>
 <p>In bundle <span class="name">uuid:02</span>, there is a description for entity <span class="name">ex:e1</span>, and 
 a provenance locator pointing to bundle <span class="name">uuid:01</span>.  
-This attribute indicates that some provenance description for <span class="name">ex:e1</span> can be found in bundle <span class="name">uuid:01</span>. The purpose of this attribute is twofold. First, it allows for <a href="http://www.w3.org/TR/prov-aq/#incremental-provenance-retrieval">incremental navigation</a> of provenance [[PROV-AQ]].  Second, it makes entity <span class="name">ex:e1</span> described in <span class="name">uuid:02</span> a <a>specialization</a> of <span class="name">ex:e1</span> described in <span class="name">uuid:01</span>.
+The locator indicates that some provenance description for <span class="name">ex:e1</span> can be found in bundle <span class="name">uuid:01</span>. The purpose of the locator is twofold. First, it allows for <a href="http://www.w3.org/TR/prov-aq/#incremental-provenance-retrieval">incremental navigation</a> of provenance [[PROV-AQ]].  Second, it makes entity <span class="name">ex:e1</span> described in <span class="name">uuid:02</span> a <a>specialization</a> of <span class="name">ex:e1</span> described in <span class="name">uuid:01</span>.
 </p>
 
 </div>