make definitions of linktypes more consistent with each other. define…

… 'alternate'. move comment down

git-svn-id: http://svn.whatwg.org/webapps@324 340c8d12-0b0e-0410-8428-c7bf67bfef74

index

@@ -678,7 +678,11 @@
        <li><a href="#linkTypes"><span class=secno>4.5.3. </span>Link
         types</a>
 
-       <li><a href="#image"><span class=secno>4.5.4. </span>Image maps</a>
+       <li><a href="#link-type"><span class=secno>4.5.4. </span>Link type
+        "<dfn id=alternate
+        title=rel-alternate><code>alternate</code></dfn>"</a>
+
+       <li><a href="#image"><span class=secno>4.5.5. </span>Image maps</a>
       </ul>
 
      <li><a href="#tabular0"><span class=secno>4.6. </span>Tabular data</a>
@@ -14764,75 +14768,14 @@ XXX selection ranges -->
 
   <h4 id=linkTypes><span class=secno>4.5.3. </span>Link types</h4>
 
-  <p class=big-issue>This section might at some future point list a small set
-   of link <code>rel</code>ationship types and more exactly define their
-   semantics than HTML4. This section (or indeed this specification in
-   general) is unlikely to specify anything related to the <code
-   title=attr-head-profile><a href="#profile">profile</a></code> attribute
-   and how to extend the link types in HTML. Work in this area is currently
-   being done by <a href="http://gmpg.org/">GMPG</a> and <a
-   href="http://protogenius.com/rel-schemas/draft-scheid-rel-schemas-00.htm">others</a>.</p>
-  <!--
-this section defines whether a particular link type is an external resource or a hyperlink
+  <p>The following table summarises the link types that are defined by this
+   specification. This table is non-normative; the actual definitions for the
+   link types are given in the next few sections.
 
-
-  issues for rel="", etc:
-   rel="alternate" with hreflang=""
-   rel="alternate" with type=""
-   rel="alternate" with media=""
-   rel="alternate stylesheet"
-   rel="up" vs rel="up up" vs rel="up up up top"
-   rel="feed" vs rel="alternate" type="application/rss+xml"
-   rel="icon"
-   rel="script"
-   rel="related" // see also
-   rel="prefetch"
-   rel="help" (Charles McCathieNevile): alternative to help="". give algo for nearest con.-sen. help
-    `-> "Nearness" seems in general like a really bad way to guess where the 
-      > help is. Do you mean closest in the markup, or in the laid-out
-      > rendering? If the link were required to be inside a label in order to be
-      > associated with a form control, that might make sense though.
-   rev=""
-   rel="nofollow" - http://www.google.com/googleblog/2005/01/preventing-comment-spam.html
-       Refers to a resource that may be related to the linking
-       document, but is not endorsed by the author. This should
-       not be counted as a negative rating for the resource,
-       however. - http://www.w3.org/mid/41F0E7FA.4060301@iinet.net.au
-     - http://radio.weblogs.com/0001011/2005/01/31.html#a9301 (scoble on why it isn't bad)
-   which relationship combinations are allowed
-   what multiple values might mean (multiple rel="top")
-   removal of redundancy
-   http://www.euronet.nl/~tekelenb/WWW/LINK/
-   http://shift.freezope.org/konq_rellinks/development_html
-   http://hixie.ch/specs/html/link/001
-   http://hixie.ch/specs/html/link/002
-   http://www.hixie.ch/specs/html/metadata
-
-   <nav>
-    <p>
-     <a href="/" rel="top up up up">Main</a> &gt;
-     <a href="/products/" rel="up up">Products</a> &gt;
-     <a href="/products/dishwashers" rel="up">Dishwashers</a> &gt;
-     Second hand
-    </p>
-   </nav>
-
-mpt says:
-> "As with <a> elements, when <link> elements that use these relationships    
-> are present, UAs should render them. As with <a> elements, when <link>
-> elements that use these relationships do not exist, UAs should not
-> render them. UAs should not make <link> rendering any easier to hide
-> than <a> rendering."
-
-   rel="bookmark" gives permalink of nearest sectioning element
-   <dd>The first <code>a</code> element with a <code>rel</code>
-   attribute having as one of its values the keyword
-   <code>bookmark</code> in a depth first search of the
-   <code>article</code> element is the article's permalink.
-
-disallow: http://microformats.org/wiki/rel-enclosure
-
-  -->
+  <p>In this section, the term <em>referenced document</em> refers to the
+   resource identified by the element representing the link, and the term
+   <em>current document</em> refers to the resource within which the element
+   representing the link finds itself.
 
   <table>
    <thead>
@@ -14851,14 +14794,14 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
    <tbody>
     <tr>
-     <td><code title=rel-alternate>alternate</code></td>
+     <td><code title=rel-alternate><a href="#alternate0">alternate</a></code></td>
      <!-- second most used <link rel> value -->
 
      <td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Gives alternate representations of the document.
+     <td>Gives alternate representations of the current document.
 
     <tr>
      <td><code title=rel-archives>archives</code>
@@ -14877,7 +14820,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Gives a link to the document's author.
+     <td>Gives a link to the current document's author.
 
     <tr>
      <td><code title=rel-bookmark>bookmark</code></td>
@@ -14897,7 +14840,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Gives a link to contact information for the document.
+     <td>Gives a link to contact information for the current document.
 
     <tr>
      <td><code title=rel-external>external</code></td>
@@ -14907,8 +14850,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the target resource is not part of the site that the
-      document is part of.
+     <td>Indicates that the target document is not part of the same site as
+      the current document.
 
     <tr>
      <td><code title=rel-feed>feed</code>
@@ -14917,7 +14860,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Gives the address of a syndication feed for the document.
+     <td>Gives the address of a syndication feed for the current document.
 
     <tr>
      <td><code title=rel-first>first</code>
@@ -14926,8 +14869,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the document is a part of a series, and that the
-      first document in the series is the target document.
+     <td>Indicates that the current document is a part of a series, and that
+      the first document in the series is the target document.
 
     <tr>
      <td><code title=rel-help>help</code>
@@ -14947,7 +14890,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><em>not allowed</em>
 
-     <td>Imports an icon to represent the document.
+     <td>Imports an icon to represent the current document.
 
     <tr>
      <td><code title=rel-index>index</code></td>
@@ -14967,8 +14910,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the document is a part of a series, and that the last
-      document in the series is the target document.
+     <td>Indicates that the current document is a part of a series, and that
+      the last document in the series is the target document.
 
     <tr>
      <td><code title=rel-license>license</code></td>
@@ -14978,8 +14921,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the document is covered by the copyright license
-      described by the target document.
+     <td>Indicates that the current document is covered by the copyright
+      license described by the target document.
 
     <tr>
      <td><code title=rel-next>next</code>
@@ -14988,8 +14931,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the document is a part of a series, and that the next
-      document in the series is the target document.
+     <td>Indicates that the current document is a part of a series, and that
+      the next document in the series is the target document.
 
     <tr>
      <td><code title=rel-nofollow>nofollow</code></td>
@@ -14999,8 +14942,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the document's original author or publisher does not
-      endorse the target document.
+     <td>Indicates that the current document's original author or publisher
+      does not endorse the target document.
 
     <tr>
      <td><code title=rel-pingback>pingback</code>
@@ -15011,7 +14954,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
      <td><em>not allowed</em>
 
      <td>Gives the address of the pingback server that handles pingbacks to
-      this document.
+      the current document.
 
     <tr>
      <td><code title=rel-prefetch>prefetch</code>
@@ -15031,8 +14974,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Indicates that the document is a part of a series, and that the
-      previous document in the series is the target document.
+     <td>Indicates that the current document is a part of a series, and that
+      the previous document in the series is the target document.
 
     <tr>
      <td><code title=rel-search>search</code></td>
@@ -15075,8 +15018,8 @@ disallow: http://microformats.org/wiki/rel-enclosure
 
      <td><a href="#hyperlinks">Hyperlink</a>
 
-     <td>Gives a tag (identified by the given address) that applies to this
-      document.
+     <td>Gives a tag (identified by the given address) that applies to the
+      current document.
 
     <tr>
      <td><code title=rel-up>up</code>
@@ -15089,7 +15032,112 @@ disallow: http://microformats.org/wiki/rel-enclosure
       document.
   </table>
 
-  <h4 id=image><span class=secno>4.5.4. </span>Image maps</h4>
+  <h4 id=link-type><span class=secno>4.5.4. </span>Link type "<dfn
+   id=alternate0 title=rel-alternate><code>alternate</code></dfn>"</h4>
+
+  <p>On the <code><a href="#link0">link</a></code> element, if the the <code
+   title=attr-link-rel><a href="#rel">rel</a></code> attribute also contains
+   the keyword <code title=rel-stylesheet>stylesheet</code>, the <code
+   title=rel-alternate><a href="#alternate0">alternate</a></code> keyword
+   modifies the meaning of the <code title=rel-stylesheet>stylesheet</code>
+   keyword in the way described for that keyword, and the rest of this
+   subsection doesn't apply.
+
+  <p>Otherwise, the <code title=rel-alternate><a
+   href="#alternate0">alternate</a></code> keyword indicates that the
+   referenced document is an alternate representation of the current
+   document.
+
+  <p>The nature of the target document is given by the <code
+   title=attr-hyperlink-media><a href="#media5">media</a></code>, <code
+   title=attr-hyperlink-hreflang><a href="#hreflang3">hreflang</a></code>,
+   and <code title=attr-hyperlink-type><a href="#type14">type</a></code>
+   attributes.
+
+  <p>If the <code title=rel-alternate><a
+   href="#alternate0">alternate</a></code> keyword is used with the <code
+   title=attr-hyperlink-media><a href="#media5">media</a></code> attribute,
+   it indicates that the target document is intended for use with the media
+   specified.
+
+  <p>If the <code title=rel-alternate><a
+   href="#alternate0">alternate</a></code> keyword is used with the <code
+   title=attr-hyperlink-hreflang><a href="#hreflang3">hreflang</a></code>
+   attribute, it indicates that the target document is a translation.
+
+  <p>If the <code title=rel-alternate><a
+   href="#alternate0">alternate</a></code> keyword is used with the <code
+   title=attr-hyperlink-type><a href="#type14">type</a></code> attribute, it
+   indicates that the target document is a reformulation of the current
+   document in the specified format.
+
+  <p>If the <code title=rel-alternate><a
+   href="#alternate0">alternate</a></code> keyword is used with the <code
+   title=attr-hyperlink-type><a href="#type14">type</a></code> attribute set
+   to the value <code title="">application/rss+xml</code> or the value <code
+   title="">application/atom+xml</code>, then the user agent must treat the
+   link as it would if it had the <code title=rel-feed>feed</code> keyword
+   specified as well.</p>
+  <!--
+this section defines whether a particular link type is an external resource or a hyperlink
+
+
+  issues for rel="", etc:
+   rel="alternate stylesheet"
+   rel="up" vs rel="up up" vs rel="up up up top"
+   rel="feed" vs rel="alternate" type="application/rss+xml"
+   rel="icon"
+   rel="script"
+   rel="related" // see also
+   rel="prefetch"
+   rel="help" (Charles McCathieNevile): alternative to help="". give algo for nearest con.-sen. help
+    `-> "Nearness" seems in general like a really bad way to guess where the 
+      > help is. Do you mean closest in the markup, or in the laid-out
+      > rendering? If the link were required to be inside a label in order to be
+      > associated with a form control, that might make sense though.
+   rev=""
+   rel="nofollow" - http://www.google.com/googleblog/2005/01/preventing-comment-spam.html
+       Refers to a resource that may be related to the linking
+       document, but is not endorsed by the author. This should
+       not be counted as a negative rating for the resource,
+       however. - http://www.w3.org/mid/41F0E7FA.4060301@iinet.net.au
+     - http://radio.weblogs.com/0001011/2005/01/31.html#a9301 (scoble on why it isn't bad)
+   which relationship combinations are allowed
+   what multiple values might mean (multiple rel="top")
+   removal of redundancy
+   http://www.euronet.nl/~tekelenb/WWW/LINK/
+   http://shift.freezope.org/konq_rellinks/development_html
+   http://hixie.ch/specs/html/link/001
+   http://hixie.ch/specs/html/link/002
+   http://www.hixie.ch/specs/html/metadata
+
+   <nav>
+    <p>
+     <a href="/" rel="top up up up">Main</a> &gt;
+     <a href="/products/" rel="up up">Products</a> &gt;
+     <a href="/products/dishwashers" rel="up">Dishwashers</a> &gt;
+     Second hand
+    </p>
+   </nav>
+
+mpt says:
+> "As with <a> elements, when <link> elements that use these relationships    
+> are present, UAs should render them. As with <a> elements, when <link>
+> elements that use these relationships do not exist, UAs should not
+> render them. UAs should not make <link> rendering any easier to hide
+> than <a> rendering."
+
+   rel="bookmark" gives permalink of nearest sectioning element
+   <dd>The first <code>a</code> element with a <code>rel</code>
+   attribute having as one of its values the keyword
+   <code>bookmark</code> in a depth first search of the
+   <code>article</code> element is the article's permalink.
+
+disallow: http://microformats.org/wiki/rel-enclosure
+
+  -->
+
+  <h4 id=image><span class=secno>4.5.5. </span>Image maps</h4>
 
   <p class=big-issue>...<dfn id=image0>image map</dfn>, <dfn id=valid5>valid
    area</dfn>, <dfn id=usemap1