Added back specification of attribute "token"

w3c · Sep 17, 2019 · 91f7988 · 91f7988
1 parent b4ede17
commit 91f7988
Showing 1 changed file with 42 additions and 15 deletions.
diff --git a/conneg-by-ap/index.html b/conneg-by-ap/index.html
@@ -1156,11 +1156,7 @@ <h3>Token mappings</h3>
             </tr>
             </tbody>
           </table>
-          <p>
-            The ABNF for the profile attribute's value is <code>(token / quoted-string)</code>,
-            where "token"and "quoted-string" are defined as in
-            <a href="https://tools.ietf.org/html/rfc7230#section-3.2.6">section 3.2.6</a>
-            of [[RFC7230]]. The rules for <code>link-param</code> values defined in
+	    The rules for <code>link-param</code> values defined in
             <a href="https://tools.ietf.org/html/rfc8288#section-3">section 3</a> of [[RFC8288]] apply.
           </p>
           <p>
@@ -1177,16 +1173,7 @@ <h3>Token mappings</h3>
   rel="type";
   token="igsn-r1";
   anchor=&lt;http://schema.igsn.org/description/1.0&gt;
-	      </pre>
-
-          <p>
-            It should be noted that the use of the token as an alternative to the profile URI
-            is, by default, limited to the current resource
-            (i. e. the resource identified by the current request URI).
-            Servers MAY use a larger scope for this
-            but clients should not depend on that
-            unless the server documentation explicitly gives other instructions through some other means.
-          </p>
+          </pre>
           <p>
             Servers MAY add more attributes to a <code>Link</code> header alongside token/URI mappings, for example
             Alternate Representations data model content. <a href="#eg-uri-token-multi"></a> shows tokens a
@@ -1749,6 +1736,46 @@ <h4>QSA key discovery</h4>
       </section>
     </section>
   </section>
+  <section id="link-attributes">
+    <h2>Link Attributes</h2>
+      <section id="link-attributes-token">
+	<h3>Token</h3>
+	<p>
+	  When used in a <code>Link</code> header field,
+	  the attribute <code>token</code> is used to specify
+	  a <a>token</<a> that a client MAY use
+	  as an alternative to the full profile URI
+	  given in the <code>anchor</code> attribute.
+	</p>
+	<p>
+	  It should be noted that the use of the token as an alternative to the profile URI
+	  is per default limited to the current resource
+	  (i. e. the resource identified by the current request URI).
+	  Servers MAY use a larger scope for their this
+	  but clients should not depend on that
+	  unless the server documentation explicitly gives other instructions through some other means.
+	</p>
+	<p>
+	  The ABNF for the profile attribute's value is <code>token / quoted-string</code>,
+	  where "token" and "quoted-string" are defined as in 
+		<a href="https://tools.ietf.org/html/rfc7230#section-3.2.6">section 3.2.6</a>
+	  of [[RFC7230]]. The rules for <code>link-param</code> values defined in
+		<a href="https://tools.ietf.org/html/rfc8288#section-3">section 3</a> of [[RFC8288]] apply.
+	</p>
+	<pre id="eg-link-attribute-token" class="example nohighlight" aria-busy="false" aria-live="polite"
+           title="Using the Link attribute &quot;token&quot; to link a profile URI to a token">
+# The profile URI in the "anchor" element is linked to the token "igsn-r1"
+
+# Further, the relation "type" is used to inform
+# that the anchor resource is of type "prof:Profile"
+
+Link: &lt;http://www.w3.org/ns/dx/prof/Profile&gt;;
+  rel="type";
+  token="igsn-r1";
+  anchor=&lt;http://schema.igsn.org/description/1.0&gt;
+	</pre>
+      </section>
+  </section>
   <section id="testsuites">
     <h2>Test Suites</h2>
     <p>