Expand on feed autodiscovery, and make it only apply to <link>

Fixes #268.

Author: domenic

source

@@ -22249,26 +22249,37 @@ interface <dfn>HTMLHyperlinkElementUtils</dfn> {
 
     <div w-nodev>
 
-    <p>The first <code>link</code> or <code>a</code> element in the document (in <span>tree
-    order</span>) with the <code data-x="rel-alternate">alternate</code> keyword used with the <code
-    data-x="attr-hyperlink-type">type</code> attribute set to the value <code
-    data-x="">application/rss+xml</code> or the value <code data-x="">application/atom+xml</code>
-    must be treated as the default syndication feed for the purposes of feed autodiscovery.</p>
+    <p>For the purposes of feed autodiscovery, user agents should consider all <code>link</code>
+    elements in the document with the <code data-x="rel-alternate">alternate</code> keyword used and
+    with their <code data-x="attr-hyperlink-type">type</code> attribute set to the value <code
+    data-x="">application/rss+xml</code> or the value <code
+    data-x="">application/atom+xml</code>. If the user agent has the concept of a default
+    syndication feed, the first such element (in <span>tree order</span>) should be used as the
+    default.</p>
+
+    </div>
 
     <div class="example">
-     <p>The following <code>link</code> element gives the syndication
-     feed for the current page:</p>
-     <pre>&lt;link rel="alternate" type="application/atom+xml" href="data.xml"></pre>
-     <p>The following extract offers various different syndication
-     feeds:</p>
+     <p>The following <code>link</code> elements give syndication feeds for a blog:</p>
+
+     <pre>&lt;link rel="alternate" type="application/atom+xml" href="posts.xml" title="Cool Stuff Blog">
+&lt;link rel="alternate" type="application/atom+xml" href="posts.xml?category=robots" title="Cool Stuff Blog: robots category">
+&lt;link rel="alternate" type="application/atom+xml" href="comments.xml" title="Cool Stuff Blog: Comments"></pre>
+
+     <p>Such <code>link</code> elements would be used by user agents engaged in feed autodiscovery,
+     with the first being the default (where applicable).</p>
+
+     <p>The following example offers various different syndication feeds to the user, using
+     <code>a</code> elements:</p>
+
      <pre>&lt;p>You can access the planets database using Atom feeds:&lt;/p>
 &lt;ul>
  &lt;li>&lt;a href="recently-visited-planets.xml" rel="alternate" type="application/atom+xml">Recently Visited Planets&lt;/a>&lt;/li>
  &lt;li>&lt;a href="known-bad-planets.xml" rel="alternate" type="application/atom+xml">Known Bad Planets&lt;/a>&lt;/li>
  &lt;li>&lt;a href="unexplored-planets.xml" rel="alternate" type="application/atom+xml">Unexplored Planets&lt;/a>&lt;/li>
 &lt;/ul></pre>
-    </div>
 
+     <p>These links would not be used in feed autodiscovery.</p>
     </div>
 
    </dd>