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>

  <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>

   <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>

     <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>

     <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>

     <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>

     <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>

     <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>

     <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>

     <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>

     <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>

     <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>

     <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>
     <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>

     <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>

     <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>
      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