Further editorial changes suggestred by Stian's comments 28,29,30,33; quote anchor parameters in Link: header examples
authorGraham Klyne
Tue, 26 Feb 2013 10:24:22 +0000
changeset 5746 fd2f1476c795
parent 5740 87298592ebd4
child 5747 a87d5f3c056c
Further editorial changes suggestred by Stian's comments 28,29,30,33; quote anchor parameters in Link: header examples
paq/prov-aq.html
--- a/paq/prov-aq.html	Mon Feb 25 23:57:25 2013 -0700
+++ b/paq/prov-aq.html	Tue Feb 26 10:24:22 2013 +0000
@@ -652,26 +652,28 @@
           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-records" 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>.
         </p>
         <p>
-          The RDF property <code>prov:hasProvenance</code> is a relation between two resources, where the object of the property is a <a class="internalDFN">provenance-URI</a> that denotes a provenance record about the subject resource.  Multiple <code>prov:hasProvenance</code> assertions may be made about a subject resource.  This property corresponds to a <code>#hasProvenance</code> link relation</a> used with an HTTP <code>Link</code> header field, or HTML <code>&lt;link&gt;</code> element (see above).
+          The RDF property <code>prov:hasProvenance</code> is a relation between two resources, where the object of the property is a <a class="internalDFN">provenance-URI</a> that denotes a provenance record about the subject resource.  Multiple <code>prov:hasProvenance</code> assertions may be made about a subject resource.
         </p>
         <p>
           Property <code>prov:hasAnchor</code> specifies an <a class="internalDFN">entity-URI</a> used in the indicated provenance to refer to the containing RDF document.
-          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 in the provenance record to refer to the described document.
         </p>
         <p>
-          Property <code>prov:hasQueryService</code> specifies a <a class="internalDFN">service-URI</a> for provenance queries.  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.
+          Property <code>prov:hasQueryService</code> specifies a <a class="internalDFN">service-URI</a> for provenance queries.
         </p>
         <pre class="example code">
     @prefix prov: &lt;http://www.w3.org/ns/prov#&gt;.
 
-    &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; ;
+    &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:hasQueryService &lt;http://example.com/provenance-query-service/&gt; .
-        :
-       (RDF data)
-        :
+
+       # (More RDF data ...)
+
         </pre>
+        <p>
+          (The above example uses Turtle RDF syntax [[TURTLE]].)
+        </p>          
         <p class="note">
           These terms (<code>prov:hasProvenance</code>, <code>prov:hasAnchor</code>, and <code>prov:hasQueryService</code>) may be also used in RDF statements with other subjects to indicate provenance of other resources, but discussion of such use is beyond the scope of this document.
         </p>
@@ -917,10 +919,10 @@
   S: 200 OK
   S: Link: &lt;http://acme.example.org/provenance/super-widget&gt;; 
            rel=http://www.w3.org/ns/prov#hasProvenance;
-           anchor=http://acme.example.org/super-widget
+           anchor="http://acme.example.org/super-widget"
   S: Link: &lt;http://acme.example.org/pingback/super-widget&gt;; 
            rel=http://www.w3.org/ns/prov#provPingback;
-           anchor=http://acme.example.org/super-widget</pre>
+           anchor="http://acme.example.org/super-widget"</pre>
       <p class="TODO">
         Details to change with Stian's proposal
       </p>