[] (0) Breadcrumbs. More complicated than necessary.

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

index

@@ -22,7 +22,7 @@
 
    <h1 id=html-5>HTML 5</h1>
 
-   <h2 class="no-num no-toc" id=working>Working Draft &mdash; 30 October 2007</h2>
+   <h2 class="no-num no-toc" id=working>Working Draft &mdash; 31 October 2007</h2>
 
    <p>You can take part in this work. <a
     href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -32025,7 +32025,9 @@ at the first element with the given ID must be treated as if it was cloned and r
 
   <p>The <code title=rel-index><a href="#index">index</a></code> keyword
    indicates that the document is part of a hierarchical structure, and that
-   the link is leading to the document that is the top of the hierarchy.
+   the link is leading to the document that is the top of the hierarchy. It
+   conveys more information when used with the <code title=rel-up><a
+   href="#up">up</a></code> keyword (q.v.).
 
   <p><strong>Synonyms</strong>: For historical reasons, user agents must also
    treat the keywords "<code title="">top</code>", "<code
@@ -32093,18 +32095,53 @@ at the first element with the given ID must be treated as if it was cloned and r
 
   <p>The <code title=rel-up><a href="#up">up</a></code> keyword indicates
    that the document is part of a hierarchical structure, and that the link
-   is leading to the document that is the parent of the current document.</p>
-  <!-- idea: rel="up" vs rel="up up" vs rel="up up up top"
-    this would allow you to do breadcrumbs:
-     <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>
-   -->
+   is leading to the document that is the parent of the current document.
+
+  <p>The <code title=rel-up><a href="#up">up</a></code> keyword may be
+   repeated within a <code title=attr-hyperlink-rel><a
+   href="#rel3">rel</a></code> attribute to indicate the hierarchical
+   distance from the current document to the referenced document. Each
+   occurance of the keyword represents one further level. If the <code
+   title=rel-index><a href="#index">index</a></code> keyword is also present,
+   then the number of <code title=rel-up><a href="#up">up</a></code> keywords
+   is the depth of the current page relative to the top of the hierarchy.
+
+  <p>If the page is part of multiple hierarchies, then they should be
+   described in different <a href="#paragraph"
+   title=paragraph>paragraphs</a>. User agents must scope any interpretation
+   of the <code title=rel-up><a href="#up">up</a></code> and <code
+   title=rel-index><a href="#index">index</a></code> keywords together
+   indicating the depth of the hierarchy to the <a
+   href="#paragraph">paragraph</a> in which the link finds itself, if any, or
+   to the document otherwise.
+
+  <p>When two links have both the <code title=rel-up><a
+   href="#up">up</a></code> and <code title=rel-index><a
+   href="#index">index</a></code> keywords specified together in the same
+   scope and contradict each other by having a different number of <code
+   title=rel-up><a href="#up">up</a></code> keywords, the link with the
+   greater number of <code title=rel-up><a href="#up">up</a></code> keywords
+   must be taken as giving the depth of the document.
+
+  <div class=example>
+   <p>This can be used to mark up a navigation style sometimes known as
+    breadcrumbs. In the following example, the current page can be reached
+    via two paths.</p>
+
+   <pre>&lt;nav>
+ &lt;p>
+  &lt;a href="/" rel="index up up up">Main&lt;/a> &gt;
+  &lt;a href="/products/" rel="up up">Products&lt;/a> &gt;
+  &lt;a href="/products/dishwashers/" rel="up">Dishwashers&lt;/a> &gt;
+  &lt;a>Second hand&lt;/a>
+ &lt;/p>
+ &lt;p>
+  &lt;a href="/" rel="index up up">Main&lt;/a> &gt;
+  &lt;a href="/second-hand/" rel="up">Second hand&lt;/a> &gt;
+  &lt;a>Dishwashers&lt;/a>
+ &lt;/p>
+&lt;/nav></pre>
+  </div>
 
   <h5 id=other0><span class=secno>4.12.3.19. </span>Other link types</h5>
 

source

@@ -29486,7 +29486,9 @@ at the first element with the given ID must be treated as if it was cloned and r
 
   <p>The <code title="rel-index">index</code> keyword indicates that
   the document is part of a hierarchical structure, and that the link
-  is leading to the document that is the top of the hierarchy.</p>
+  is leading to the document that is the top of the hierarchy. It
+  conveys more information when used with the <code
+  title="rel-up">up</code> keyword (q.v.).</p>
 
   <p><strong>Synonyms</strong>: For historical reasons, user agents
   must also treat the keywords "<code title="">top</code>", "<code
@@ -29553,18 +29555,51 @@ at the first element with the given ID must be treated as if it was cloned and r
   leading to the document that is the parent of the current
   document.</p>
 
-  <!-- idea: rel="up" vs rel="up up" vs rel="up up up top"
-    this would allow you to do breadcrumbs:
-     <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>
-   -->
+  <p>The <code title="rel-up">up</code> keyword may be repeated within
+  a <code title="attr-hyperlink-rel">rel</code> attribute to indicate
+  the hierarchical distance from the current document to the
+  referenced document. Each occurance of the keyword represents one
+  further level. If the <code title="rel-index">index</code> keyword
+  is also present, then the number of <code title="rel-up">up</code>
+  keywords is the depth of the current page relative to the top of the
+  hierarchy.</p>
+
+  <p>If the page is part of multiple hierarchies, then they should be
+  described in different <span
+  title="paragraph">paragraphs</span>. User agents must scope any
+  interpretation of the <code title="rel-up">up</code> and <code
+  title="rel-index">index</code> keywords together indicating the
+  depth of the hierarchy to the <span>paragraph</span> in which the
+  link finds itself, if any, or to the document otherwise.</p>
+
+  <p>When two links have both the <code title="rel-up">up</code> and
+  <code title="rel-index">index</code> keywords specified together in
+  the same scope and contradict each other by having a different
+  number of <code title="rel-up">up</code> keywords, the link with the
+  greater number of <code title="rel-up">up</code> keywords must be
+  taken as giving the depth of the document.</p>
+
+  <div class="example">
+
+   <p>This can be used to mark up a navigation style sometimes known
+   as breadcrumbs. In the following example, the current page can be
+   reached via two paths.</p>
 
+   <pre>&lt;nav>
+ &lt;p>
+  &lt;a href="/" rel="index up up up">Main&lt;/a> &gt;
+  &lt;a href="/products/" rel="up up">Products&lt;/a> &gt;
+  &lt;a href="/products/dishwashers/" rel="up">Dishwashers&lt;/a> &gt;
+  &lt;a>Second hand&lt;/a>
+ &lt;/p>
+ &lt;p>
+  &lt;a href="/" rel="index up up">Main&lt;/a> &gt;
+  &lt;a href="/second-hand/" rel="up">Second hand&lt;/a> &gt;
+  &lt;a>Dishwashers&lt;/a>
+ &lt;/p>
+&lt;/nav></pre>
+
+  </div>
 
   <h5>Other link types</h5>