Fix some section cross-references; rename 'prov:hasProvenanceService' as 'prov:hasQueryService'
authorGraham Klyne
Fri, 04 Jan 2013 13:11:24 +0000
changeset 5380 7b4580bd6d52
parent 5379 f00efdbb4f6e
child 5381 a374c48027b9
Fix some section cross-references; rename 'prov:hasProvenanceService' as 'prov:hasQueryService'
paq/prov-aq.html
--- a/paq/prov-aq.html	Fri Jan 04 13:03:57 2013 +0000
+++ b/paq/prov-aq.html	Fri Jan 04 13:11:24 2013 +0000
@@ -464,15 +464,15 @@
         <section>
           <h2>Specifying Provenance Query Services</h2>
           <p>
-            The resource provider may indicate that provenance descriptions about the resource are provided by a <a class="internalDFN">provenance query service</a>. This is done through the use of a <code>hasProvenanceService</code> link relation type following the same pattern as above:
+            The resource provider may indicate that provenance descriptions about the resource are provided by a <a class="internalDFN">provenance query service</a>. This is done through the use of a <code>hasQueryService</code> link relation type following the same pattern as above:
           </p>
           <pre class="pattern">
-Link: &lt;<cite>provenance-service-URI</cite>&gt;; rel="http://www.w3.org/ns/prov#hasProvenanceService"; anchor="<cite>target-URI</cite>"</pre>
+Link: &lt;<cite>provenance-service-URI</cite>&gt;; rel="http://www.w3.org/ns/prov#hasQueryService"; anchor="<cite>target-URI</cite>"</pre>
           <p>
-            The <code>hasProvenanceService</code> link identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to submit a query to retrieve a <a class="internalDFN">provenance description</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-query-services" class="sectionRef"></a> for more details.
+            The <code>hasQueryService</code> link identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to submit a query to retrieve a <a class="internalDFN">provenance description</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-query-services" class="sectionRef"></a> for more details.
           </p>
           <p>
-          There may be multiple <code>hasProvenanceService</code> link header fields, and these may appear in an HTTP response together with <code>hasProvenance</code> link header fields (though, in simple cases, we anticipate that <code>hasProvenance</code> and <code>hasProvenanceService</code> link relations will not be used together).
+          There may be multiple <code>hasQueryService</code> link header fields, and these may appear in an HTTP response together with <code>hasProvenance</code> link header fields (though, in simple cases, we anticipate that <code>hasProvenance</code> and <code>hasQueryService</code> link relations will not be used together).
         </p>
         </section>
 
@@ -555,7 +555,7 @@
             <pre class="pattern">
   &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt;
      &lt;head&gt;
-        &lt;link rel="http://www.w3.org/ns/prov#hasProvenanceService" href="<cite>service-URI</cite>"&gt;
+        &lt;link rel="http://www.w3.org/ns/prov#hasQueryService" href="<cite>service-URI</cite>"&gt;
         &lt;link rel="http://www.w3.org/ns/prov#hasAnchor" href="<cite>target-URI</cite>"&gt;
         &lt;title&gt;Welcome to example.com&lt;/title&gt;
      &lt;/head&gt;
@@ -564,10 +564,10 @@
      &lt;/body&gt;
   &lt;/html&gt;</pre>
           <p>
-            The <code>hasProvenanceService</code> link element identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to query for <a class="internalDFN">provenance description</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-query-services" class="sectionRef"></a> for more details.
+            The <code>hasQueryService</code> link element identifies the <a class="internalDFN">service-URI</a>.  Dereferencing this URI yields a service description that provides further information to enable a client to query for <a class="internalDFN">provenance description</a> for a <a class="internalDFN">resource</a>; see <a href="#provenance-query-services" class="sectionRef"></a> for more details.
           </p>
           <p>
-            There MAY be multiple <code>hasProvenanceService</code> link elements, and these MAY appear in the same document as <code>provenance</code> link elements (though, in simple cases, we anticipate that <code>hasProvenance</code> and <code>hasProvenanceService</code> link relations would not be used together).
+            There MAY be multiple <code>hasQueryService</code> link elements, and these MAY appear in the same document as <code>provenance</code> link elements (though, in simple cases, we anticipate that <code>hasProvenance</code> and <code>hasQueryService</code> link relations would not be used together).
           </p>
         </section>
       </section>
@@ -575,7 +575,7 @@
       <section>
         <h2>Resource represented as RDF</h2>
         <p>
-          If a resource is represented as RDF (in any of its recognized syntaxes, including RDFa), it may contain references to its own provenance using additional RDF statements.  For this purpose the link relations introduced above (<a href="#locating-provenance-descriptions" class="sectionRef"></a>) may be used as RDF properties: <code>prov:hasProvenance</code>, <code>prov:hasAnchor</code>, and <code>prov:hasProvenanceService</code>, where the <code>prov:</code> prefix here indicates the PROV namespace URI <code>http://www.w3.org/ns/prov#</code>.
+          If a resource is represented as RDF (in any of its recognized syntaxes, including RDFa), it may contain references to its own provenance using additional RDF statements.  For this purpose the link relations introduced above (<a href="#locating-provenance-descriptions" class="sectionRef"></a>) may be used as RDF properties: <code>prov:hasProvenance</code>, <code>prov:hasAnchor</code>, and <code>prov:hasQueryService</code>, where the <code>prov:</code> prefix here indicates the PROV namespace URI <code>http://www.w3.org/ns/prov#</code>.
           (These terms may be used to indicate provenance of arbitrary other resources too, but discussion of such usage is beyond the scope of this section.)
         </p>
         <p>
@@ -586,7 +586,7 @@
           This corresponds to use of the <code>anchor</code> parameter in an HTTP provenance <code>Link</code> header field, or a <code>hasAnchor</code> link relation</a> in an HTML <code>&lt;link&gt;</code> element, which similarly indicate a URI used by the provenance description to refer to the described document.
         </p>
         <p>
-          Property <code>prov:hasProvenanceService</code> specifies a <a class="internalDFN">service-URI</a> associated with the RDF document for accessing provenance descriptions.  This property corresponds to a <code>hasProvenanceService</code> link relation used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element.
+          Property <code>prov:hasQueryService</code> specifies a <a class="internalDFN">service-URI</a> associated with the RDF document for accessing provenance descriptions.  This property corresponds to a <code>hasQueryService</code> link relation used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element.
         </p>
         <pre class="example code">
     @prefix prov: &lt;http://www.w3.org/ns/prov#&gt;
@@ -594,7 +594,7 @@
     &lt;&gt; dcterms:title      "Welcome to example.com" ;
        prov:hasAnchor     &lt;http://example.com/data/resource.rdf&gt; ;
        prov:hasProvenance &lt;http://example.com/provenance/resource.rdf&gt; ;
-       prov:hasProvenanceService &lt;http://example.com/provenance-query-service/&gt; .
+       prov:hasQueryService &lt;http://example.com/provenance-query-service/&gt; .
         :
        (RDF data)
         :
@@ -760,14 +760,14 @@
           Previously, <a href="#locating-provenance-descriptions" class="sectionRef"></a> has described use of HTTP <code>Link:</code> header fields and HTML <code>&lt;link&gt;</code> elements to indicate provenance query services. Beyond that, this specification does not define any specific mechanism for discovering query services.  Applications may use any appropriate mechanism, including but not limited to: prior configuration, search engines, service registries, etc.
         </p>
         <p>
-          To facilitate service discovery, we recommend that RDF publication of dataset and service descriptions use the property <code>prov:hasProvenanceService</code> and the provenance service type <code>prov:ProvenanceQueryService</code> as appropriate (see the appendix <a href="#prov-namespace" class="sectionRef"></a>).
+          To facilitate service discovery, we recommend that RDF publication of dataset and service descriptions use the property <code>prov:hasQueryService</code> and the provenance service type <code>prov:ProvenanceQueryService</code> as appropriate (see the appendix <a href="#prov-namespace" class="sectionRef"></a>).
         </p>
         <p>
           For example, a VoID description [[VoID]] of a dataset might indicate a provenance query service providing information about that dataset:
         </p>
         <pre class="pattern">
   &lt;http://example.org/dataset/&gt; a void:Dataset ;
-    prov:hasProvenanceService &lt;http://example.org/provenance/&gt; .</pre>
+    prov:hasQueryService &lt;http://example.org/provenance/&gt; .</pre>
         <p>
           The RDF service description example in <a href="#provenance-query-service-description" class="sectionRef"></a> shows use of the <code>prov:ProvenanceQueryService</code> type.
         </p>
@@ -897,7 +897,7 @@
           <tr style="vertical-align: top;">
             <td><code>ProvenanceQueryService</code></td>
             <td>Class for a provenance query service. Mainly for use in RDF provenance query service descriptions, to facilitate discovery.</td>
-            <td><a href="#provenance-service-description" class="sectionRef"></a></td>
+            <td><a href="#provenance-query-service-description" class="sectionRef"></a></td>
           </tr>
           <tr style="vertical-align: top;">
             <td><code>hasAnchor</code></td>
@@ -911,14 +911,14 @@
             <td><a href="#resource-accessed-by-http" class="sectionRef"></a>, <a href="#resource-represented-as-html" class="sectionRef"></a></td>
           </tr>
           <tr style="vertical-align: top;">
-            <td><code>hasProvenanceService</code></td>
-            <td>Indicates a <a class="internalDFN">provenance service</a> that can provide provenance descriptions about its subject or anchor resource.</td>
-            <td><a href="#specifying-provenance-services" class="sectionRef"></a></td>
+            <td><code>hasQueryService</code></td>
+            <td>Indicates a <a class="internalDFN">provenance query service</a> that can provide provenance descriptions related to its subject or anchor resource.</td>
+            <td><a href="#specifying-provenance-query-services" class="sectionRef"></a></td>
           </tr>
           <tr style="vertical-align: top;">
             <td><code>provenanceUriTemplate</code></td>
-            <td>Relates a provenance service to a URI template string for constructing provenance-URIs</td>
-            <td><a href="#provenance-service-description" class="sectionRef"></a></td>
+            <td>Indicates a URI template string for constructing provenance-URIs</td>
+            <td><a href="#direct-http-query-service" class="sectionRef"></a></td>
           </tr>
           <tr style="vertical-align: top;">
             <td><code>provPingback</code></td>