W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2010

html5/spec Overview.html,1.3985,1.3986

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sun, 04 Apr 2010 07:03:14 +0000
To: public-html-commits@w3.org
Message-Id: <E1NyJrW-0003oN-Ji@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv14601

Modified Files:
	Overview.html 
Log Message:
Define rel=alternate for feeds as something conforming. (whatwg r4964)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3985
retrieving revision 1.3986
diff -u -d -r1.3985 -r1.3986
--- Overview.html	4 Apr 2010 06:33:56 -0000	1.3985
+++ Overview.html	4 Apr 2010 07:03:10 -0000	1.3986
@@ -38432,75 +38432,104 @@
    * http://microformats.org/wiki/rel-enclosure
   --><h5 id="link-type-alternate"><span class="secno">4.12.3.1 </span>Link type "<dfn title="rel-alternate"><code>alternate</code></dfn>"</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword may be
   used with <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, and <code><a href="#the-area-element">area</a></code>
-  elements. For <code><a href="#the-link-element">link</a></code> elements, if the <code title="attr-link-rel"><a href="#attr-link-rel">rel</a></code> attribute does not also contain the
-  keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>, it creates a
-  <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>; but if it
-  <em>does</em> also contain the keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>, the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword instead modifies the
-  meaning of the <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>
-  keyword in the way described for that keyword, and the rest of this
-  subsection doesn't apply.<p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword
-  indicates that the referenced document is an alternate
-  representation of the current document.<p>The nature of the referenced document is given by the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes.<p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
-  used with the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>
-  attribute, it indicates that the referenced document is intended for
-  use with the media specified.<p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
-  used with the <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>
-  attribute, and that attribute's value differs from the <a href="#root-element">root
-  element</a>'s <a href="#language">language</a>, it indicates that the
-  referenced document is a translation.<p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
-  used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
-  attribute, it indicates that the referenced document is a
-  reformulation of the current document in the specified format.<p>The <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes can be combined
-  when specified with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>
-  keyword.<div class="example">
+  elements.<p>The meaning of this keyword depends on the values of the other
+  attributes.<dl class="switch"><dt>If the element is a <code><a href="#the-link-element">link</a></code> element and the <code title="attr-link-rel"><a href="#attr-link-rel">rel</a></code> attribute also contains the
+   keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code></dt>
 
-   <p>For example, the following link is a French translation that
-   uses the PDF format:</p>
+   <dd>
 
-   <pre>&lt;link rel=alternate type=application/pdf hreflang=fr href=manual-fr&gt;</pre>
+    <p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword
+    modifies the meaning of the <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword in the way
+    described for that keyword. The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword does not create a
+    link of its own.</p>
 
-  </div><div class="impl">
+   </dd>
 
-  <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
-  used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
-  attribute set to the value <code title="">application/rss+xml</code>
-  or the value <code title="">application/atom+xml</code>, then it
-  indicates that the referenced document is a syndication feed (though
-  not necessarily syndicating exactly the same content as the current
-  page).</p>
 
-  <div class="impl">
+   <dt>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+   used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
+   attribute set to the value <code title="">application/rss+xml</code> or the value <code title="">application/atom+xml</code></dt>
 
-  <p>The first <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, or <code><a href="#the-area-element">area</a></code>
-  element in the document (in tree order) with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attribute set to the value
-  <code title="">application/rss+xml</code> or the value <code title="">application/atom+xml</code> must be treated as the default
-  syndication feed for the purposes of feed autodiscovery.</p>
+   <dd>
 
-  <div class="example">
-   <p>The following <code><a href="#the-link-element">link</a></code> element gives the syndication
-   feed for the current page:</p>
-   <pre>&lt;link rel="alternate" type="application/atom+xml" href="data.xml"&gt;</pre>
-   <p>The following extract offers various different syndication
-   feeds:</p>
-   <pre>&lt;p&gt;You can access the planets database using Atom feeds:&lt;/p&gt;
+    <p>The link is a <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>
+    referencing a syndication feed (though not necessarily syndicating
+    exactly the same content as the current page).</p>
+
+    <div class="impl">
+
+    <p>The first <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, or <code><a href="#the-area-element">area</a></code>
+    element in the document (in tree order) with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attribute set to the value
+    <code title="">application/rss+xml</code> or the value <code title="">application/atom+xml</code> must be treated as the default
+    syndication feed for the purposes of feed autodiscovery.</p>
+
+    <div class="example">
+     <p>The following <code><a href="#the-link-element">link</a></code> element gives the syndication
+     feed for the current page:</p>
+     <pre>&lt;link rel="alternate" type="application/atom+xml" href="data.xml"&gt;</pre>
+     <p>The following extract offers various different syndication
+     feeds:</p>
+     <pre>&lt;p&gt;You can access the planets database using Atom feeds:&lt;/p&gt;
 &lt;ul&gt;
  &lt;li&gt;&lt;a href="recently-visited-planets.xml" rel="alternate" type="application/atom+xml"&gt;Recently Visited Planets&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="known-bad-planets.xml" rel="alternate" type="application/atom+xml"&gt;Known Bad Planets&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="unexplored-planets.xml" rel="alternate" type="application/atom+xml"&gt;Unexplored Planets&lt;/a&gt;&lt;/li&gt;
 &lt;/ul&gt;</pre>
-  </div>
+    </div>
 
-  </div>
+    </div>
 
+   </dd>
 
 
+   <dt>Otherwise</dt>
 
-  </div><p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> link
-  relationship is transitive &mdash; that is, if a document links to
-  two other documents with the link type "<code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>", then, in addition to
-  implying that those documents are alternative representations of the
-  first document, it is also implying that those two documents are
-  alternative representations of each other.<h5 id="link-type-archives"><span class="secno">4.12.3.2 </span>Link type "<dfn title="rel-archives"><code>archives</code></dfn>"</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="rel-archives"><a href="#link-type-archives">archives</a></code> keyword may be
+   <dd>
+
+    <p>The link is a <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>
+    referencing an alternate representation of the current
+    document.</p>
+
+    <p>The nature of the referenced document is given by the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes.</p>
+
+    <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+    used with the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>
+    attribute, it indicates that the referenced document is intended for
+    use with the media specified.</p>
+
+    <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+    used with the <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>
+    attribute, and that attribute's value differs from the <a href="#root-element">root
+    element</a>'s <a href="#language">language</a>, it indicates that the
+    referenced document is a translation.</p>
+
+    <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+    used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
+    attribute, it indicates that the referenced document is a
+    reformulation of the current document in the specified format.</p>
+
+    <p>The <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes can be combined
+    when specified with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>
+    keyword.</p>
+
+    <div class="example">
+
+     <p>For example, the following link is a French translation that
+     uses the PDF format:</p>
+
+     <pre>&lt;link rel=alternate type=application/pdf hreflang=fr href=manual-fr&gt;</pre>
+
+    </div>
+
+    <p>This relationship is transitive &mdash; that is, if a document
+    links to two other documents with the link type "<code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>", then, in addition to
+    implying that those documents are alternative representations of
+    the first document, it is also implying that those two documents
+    are alternative representations of each other.</p>
+
+   </dd>
+
+  </dl><h5 id="link-type-archives"><span class="secno">4.12.3.2 </span>Link type "<dfn title="rel-archives"><code>archives</code></dfn>"</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="rel-archives"><a href="#link-type-archives">archives</a></code> keyword may be
   used with <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, and <code><a href="#the-area-element">area</a></code>
   elements. For <code><a href="#the-link-element">link</a></code> elements, it creates a <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>.<p>The <code title="rel-archives"><a href="#link-type-archives">archives</a></code> keyword indicates
   that the referenced document describes a collection of records,
Received on Sunday, 4 April 2010 07:03:16 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 4 April 2010 07:03:18 GMT