- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 02 Mar 2011 01:03:03 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11641
Modified Files:
Overview.html
Log Message:
Drop support for rel=up, rel=last, rel=index, rel=first, and any related synonyms. (whatwg r5924)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4764
retrieving revision 1.4765
diff -u -d -r1.4764 -r1.4765
--- Overview.html 1 Mar 2011 23:18:29 -0000 1.4764
+++ Overview.html 2 Mar 2011 01:02:58 -0000 1.4765
@@ -343,7 +343,7 @@
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-1-march-2011">Editor's Draft 1 March 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-2-march-2011">Editor's Draft 2 March 2011</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -485,7 +485,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 1 March 2011 Editor's Draft.
+ This specification is the 2 March 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -963,23 +963,18 @@
<li><a href="#link-type-stylesheet"><span class="secno">4.12.4.14 </span>Link type "<code>stylesheet</code>"</a></li>
<li><a href="#link-type-sidebar"><span class="secno">4.12.4.15 </span>Link type "<code>sidebar</code>"</a></li>
<li><a href="#link-type-tag"><span class="secno">4.12.4.16 </span>Link type "<code>tag</code>"</a></li>
- <li><a href="#hierarchical-link-types"><span class="secno">4.12.4.17 </span>Hierarchical link types</a>
- <ol>
- <li><a href="#link-type-index"><span class="secno">4.12.4.17.1 </span>Link type "<code>index</code>"</a></li>
- <li><a href="#link-type-up"><span class="secno">4.12.4.17.2 </span>Link type "<code>up</code>"</a></ol></li>
- <li><a href="#sequential-link-types"><span class="secno">4.12.4.18 </span>Sequential link types</a>
+ <li><a href="#sequential-link-types"><span class="secno">4.12.4.17 </span>Sequential link types</a>
<ol>
- <li><a href="#link-type-first"><span class="secno">4.12.4.18.1 </span>Link type "<code>first</code>"</a></li>
- <li><a href="#link-type-last"><span class="secno">4.12.4.18.2 </span>Link type "<code>last</code>"</a></li>
- <li><a href="#link-type-next"><span class="secno">4.12.4.18.3 </span>Link type "<code>next</code>"</a></li>
- <li><a href="#link-type-prev"><span class="secno">4.12.4.18.4 </span>Link type "<code>prev</code>"</a></ol></li>
- <li><a href="#other-link-types"><span class="secno">4.12.4.19 </span>Other link types</a></ol></ol></li>
+ <li><a href="#link-type-next"><span class="secno">4.12.4.17.1 </span>Link type "<code>next</code>"</a></li>
+ <li><a href="#link-type-prev"><span class="secno">4.12.4.17.2 </span>Link type "<code>prev</code>"</a></ol></li>
+ <li><a href="#other-link-types"><span class="secno">4.12.4.18 </span>Other link types</a></ol></ol></li>
<li><a href="#common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</a>
<ol>
<li><a href="#the-main-part-of-the-content"><span class="secno">4.13.1 </span>The main part of the content</a></li>
- <li><a href="#tag-clouds"><span class="secno">4.13.2 </span>Tag clouds</a></li>
- <li><a href="#conversations"><span class="secno">4.13.3 </span>Conversations</a></li>
- <li><a href="#footnotes"><span class="secno">4.13.4 </span>Footnotes</a></ol></li>
+ <li><a href="#rel-up"><span class="secno">4.13.2 </span>Bread crumb navigation</a></li>
+ <li><a href="#tag-clouds"><span class="secno">4.13.3 </span>Tag clouds</a></li>
+ <li><a href="#conversations"><span class="secno">4.13.4 </span>Conversations</a></li>
+ <li><a href="#footnotes"><span class="secno">4.13.5 </span>Footnotes</a></ol></li>
<li><a href="#matching-html-elements-using-selectors"><span class="secno">4.14 </span>Matching HTML elements using selectors</a>
<ol>
<li><a href="#selectors"><span class="secno">4.14.1 </span>Case-sensitivity</a></li>
@@ -40591,10 +40586,6 @@
<td><em>not allowed</em></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td>Indicates that the referenced document is not part of the same site as the current document.</td>
- <tr><td><code title="rel-first"><a href="#link-type-first">first</a></code></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td>Indicates that the current document is a part of a series, and that the first document in the series is the referenced document.</td>
<tr><td><code title="rel-help"><a href="#link-type-help">help</a></code></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td><a href="#hyperlink">Hyperlink</a></td>
@@ -40603,14 +40594,6 @@
<td><a href="#external-resource-link" title="external resource link">External Resource</a></td>
<td><em>not allowed</em></td>
<td>Imports an icon to represent the current document.</td>
- <tr><td><code title="rel-index"><a href="#link-type-index">index</a></code></td> <!-- used more than "top" and "contents" on <link> (though on <a>, "contents" wins) -->
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td>Gives a link to the document that provides a table of contents or index listing the current document.</td>
- <tr><td><code title="rel-last"><a href="#link-type-last">last</a></code></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td>Indicates that the current document is a part of a series, and that the last document in the series is the referenced document.</td>
<tr><td><code title="rel-license"><a href="#link-type-license">license</a></code></td> <!-- seventh most used <a rel> value -->
<td><a href="#hyperlink">Hyperlink</a></td>
<td><a href="#hyperlink">Hyperlink</a></td>
@@ -40655,10 +40638,6 @@
<td><a href="#hyperlink">Hyperlink</a></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td>Gives a tag (identified by the given address) that applies to the current document.</td>
- <tr><td><code title="rel-up"><a href="#link-type-up">up</a></code></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td>Provides a link to a document giving the context for the current document.</td>
</table><div class="impl">
<p>Some of the types described below list synonyms for these
@@ -41107,102 +41086,14 @@
current document.<p class="note">Since it indicates that the tag <em>applies to the
current document</em>, it would be inappropriate to use this keyword
in the markup of a <a href="#tag-cloud">tag cloud</a>, which lists
- the popular tag across a set of pages.<h5 id="hierarchical-link-types"><span class="secno">4.12.4.17 </span>Hierarchical link types</h5><p>Some documents form part of a hierarchical structure of
- documents.<p>A hierarchical structure of documents is one where each document
- can have various subdocuments. The document of which a document is a
- subdocument is said to be the document's <em>parent</em>. A document
- with no parent forms the top of the hierarchy.<p>A document may be part of multiple hierarchies.<h6 id="link-type-index"><span class="secno">4.12.4.17.1 </span>Link type "<dfn title="rel-index"><code>index</code></dfn>"</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/118">ISSUE-118</a> (broken-link-types) blocks progress to Last Call</span><p>The <code title="rel-index"><a href="#link-type-index">index</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. This keyword creates a <a href="#hyperlink">hyperlink</a>.<p>The <code title="rel-index"><a href="#link-type-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. It
- conveys more information when used with the <code title="rel-up"><a href="#link-type-up">up</a></code> keyword (q.v.).<div class="impl">
-
- <p><strong>Synonyms</strong>: For historical reasons, user agents
- must also treat the keywords "<code title="">top</code>", "<code title="">contents</code>", and "<code title="">toc</code>" like the
- <code title="rel-index"><a href="#link-type-index">index</a></code> keyword.</p>
-
- </div><h6 id="link-type-up"><span class="secno">4.12.4.17.2 </span>Link type "<dfn title="rel-up"><code>up</code></dfn>"</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/119">ISSUE-119</a> (rel-repetition) blocks progress to Last Call</span><p>The <code title="rel-up"><a href="#link-type-up">up</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. This keyword creates a <a href="#hyperlink">hyperlink</a>.<p>The <code title="rel-up"><a href="#link-type-up">up</a></code> keyword indicates that the
- document is part of a hierarchical structure, and that the link is
- leading to a document that is an ancestor of the current
- document.<p>The <code title="rel-up"><a href="#link-type-up">up</a></code> keyword may be repeated within
- a <code title="attr-hyperlink-rel"><a href="#attr-hyperlink-rel">rel</a></code> attribute to indicate
- the hierarchical distance from the current document to the
- referenced document. If it occurs only once, then the link is
- leading to the current document's parent; each additional occurrence
- of the keyword represents one further level. If the <code title="rel-index"><a href="#link-type-index">index</a></code> keyword is also present, then the
- number of <code title="rel-up"><a href="#link-type-up">up</a></code> keywords is the depth of
- the current page relative to the top of the hierarchy. Only one link
- is created for the set of one or more <code title="rel-up"><a href="#link-type-up">up</a></code>
- keywords and, if present, the <code title="rel-index"><a href="#link-type-index">index</a></code>
- keyword.<p>If the page is part of multiple hierarchies, then they should be
- described in different <a href="#paragraph" title="paragraph">paragraphs</a>. <span class="impl">User agents
- must scope any interpretation of the <code title="rel-up"><a href="#link-type-up">up</a></code>
- and <code title="rel-index"><a href="#link-type-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.</span><div class="impl">
-
- <p>When two links have both the <code title="rel-up"><a href="#link-type-up">up</a></code> and
- <code title="rel-index"><a href="#link-type-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="#link-type-up">up</a></code> keywords, the link with the
- greater number of <code title="rel-up"><a href="#link-type-up">up</a></code> keywords must be
- taken as giving the depth of the document.</p>
-
- </div><div class="example">
-
- <p>This can be used to mark up a navigation style sometimes known
- as bread crumbs. In the following example, the current page can be
- reached via two paths.</p>
-
- <pre><nav>
- <p>
- <a href="/" rel="index up up up">Main</a> >
- <a href="/products/" rel="up up">Products</a> >
- <a href="/products/dishwashers/" rel="up">Dishwashers</a> >
- <a>Second hand</a>
- </p>
- <p>
- <a href="/" rel="index up up">Main</a> >
- <a href="/second-hand/" rel="up">Second hand</a> >
- <a>Dishwashers</a>
- </p>
-</nav></pre>
-
- </div><p class="note">The <code title="dom-a-relList"><a href="#dom-a-rellist">relList</a></code> IDL
- attribute (e.g. on the <code><a href="#the-a-element">a</a></code> element) does not currently
- represent multiple <code title="rel-up"><a href="#link-type-up">up</a></code> keywords (the
- interface hides duplicates).<h5 id="sequential-link-types"><span class="secno">4.12.4.18 </span>Sequential link types</h5><p>Some documents form part of a sequence of documents.<p>A sequence of documents is one where each document can have a
+ the popular tag across a set of pages.<h5 id="sequential-link-types"><span class="secno">4.12.4.17 </span>Sequential link types</h5><p>Some documents form part of a sequence of documents.<p>A sequence of documents is one where each document can have a
<em>previous sibling</em> and a <em>next sibling</em>. A document
with no previous sibling is the start of its sequence, a document
- with no next sibling is the end of its sequence.<p>A document may be part of multiple sequences.<h6 id="link-type-first"><span class="secno">4.12.4.18.1 </span>Link type "<dfn title="rel-first"><code>first</code></dfn>"</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/118">ISSUE-118</a> (broken-link-types) blocks progress to Last Call</span><p>The <code title="rel-first"><a href="#link-type-first">first</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. This keyword creates a <a href="#hyperlink">hyperlink</a>.<p>The <code title="rel-first"><a href="#link-type-first">first</a></code> keyword indicates that
- the document is part of a sequence, and that the link is leading to
- the document that is the first logical document in the sequence.<div class="impl">
-
- <p><strong>Synonyms</strong>: For historical reasons, user agents
- must also treat the keywords "<code title="">begin</code>" and
- "<code title="">start</code>" like the <code title="rel-first"><a href="#link-type-first">first</a></code> keyword.</p>
-
- </div><h6 id="link-type-last"><span class="secno">4.12.4.18.2 </span>Link type "<dfn title="rel-last"><code>last</code></dfn>"</h6><p>The <code title="rel-last"><a href="#link-type-last">last</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. This keyword creates a <a href="#hyperlink">hyperlink</a>.<p>The <code title="rel-last"><a href="#link-type-last">last</a></code> keyword indicates that the
- document is part of a sequence, and that the link is leading to the
- document that is the last logical document in the sequence.<div class="impl">
-
- <p><strong>Synonyms</strong>: For historical reasons, user agents
- must also treat the keyword "<code title="">end</code>" like the
- <code title="rel-last"><a href="#link-type-last">last</a></code> keyword.</p>
-
- </div><h6 id="link-type-next"><span class="secno">4.12.4.18.3 </span>Link type "<dfn title="rel-next"><code>next</code></dfn>"</h6><p>The <code title="rel-next"><a href="#link-type-next">next</a></code> keyword may be used with
+ with no next sibling is the end of its sequence.<p>A document may be part of multiple sequences.<h6 id="link-type-next"><span class="secno">4.12.4.17.1 </span>Link type "<dfn title="rel-next"><code>next</code></dfn>"</h6><p>The <code title="rel-next"><a href="#link-type-next">next</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. This keyword creates a <a href="#hyperlink">hyperlink</a>.<p>The <code title="rel-next"><a href="#link-type-next">next</a></code> keyword indicates that the
document is part of a sequence, and that the link is leading to the
- document that is the next logical document in the sequence.<h6 id="link-type-prev"><span class="secno">4.12.4.18.4 </span>Link type "<dfn title="rel-prev"><code>prev</code></dfn>"</h6><p>The <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword may be used with
+ document that is the next logical document in the sequence.<h6 id="link-type-prev"><span class="secno">4.12.4.17.2 </span>Link type "<dfn title="rel-prev"><code>prev</code></dfn>"</h6><p>The <code title="rel-prev"><a href="#link-type-prev">prev</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. This keyword creates a <a href="#hyperlink">hyperlink</a>.<p>The <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword indicates that the
document is part of a sequence, and that the link is leading to the
@@ -41212,7 +41103,7 @@
must also treat the keyword "<code title="">previous</code>" like
the <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword.</p>
- </div><h5 id="other-link-types"><span class="secno">4.12.4.19 </span>Other link types</h5><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/127">ISSUE-127</a> (link-type-flags) blocks progress to Last Call</span><p><dfn id="concept-rel-extensions" title="concept-rel-extensions">Extensions to the predefined
+ </div><h5 id="other-link-types"><span class="secno">4.12.4.18 </span>Other link types</h5><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/127">ISSUE-127</a> (link-type-flags) blocks progress to Last Call</span><p><dfn id="concept-rel-extensions" title="concept-rel-extensions">Extensions to the predefined
set of link types</dfn> may be registered in the <a href="http://wiki.whatwg.org/wiki/RelExtensions">WHATWG Wiki
RelExtensions page</a>. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><p>Anyone is free to edit the WHATWG Wiki RelExtensions page at any
time to add a type. Extension types must be specified with the
@@ -41522,7 +41413,30 @@
</body>
</html></pre>
- </div><h4 id="tag-clouds"><span class="secno">4.13.2 </span>Tag clouds</h4><p id="tag-cloud">This specification does not define any markup
+ </div><h4 id="rel-up"><span class="secno">4.13.2 </span>Bread crumb navigation</h4><p>This specification does not provide a machine-readable way of
+ describing bread-crumb navigation menus. Authors are encouraged to
+ just use a series of links in a paragraph. The <code><a href="#the-nav-element">nav</a></code>
+ element can be used to mark the section containing these
+ paragraphs as being navigation blocks.<div class="example">
+
+ <p>In the following example, the current page can be reached via
+ two paths.</p>
+
+ <pre><nav>
+ <p>
+ <a href="/">Main</a> >
+ <a href="/products/">Products</a> >
+ <a href="/products/dishwashers/">Dishwashers</a> >
+ <a>Second hand</a>
+ </p>
+ <p>
+ <a href="/">Main</a> >
+ <a href="/second-hand/">Second hand</a> >
+ <a>Dishwashers</a>
+ </p>
+</nav></pre>
+
+ </div><h4 id="tag-clouds"><span class="secno">4.13.3 </span>Tag clouds</h4><p id="tag-cloud">This specification does not define any markup
specifically for marking up lists of keywords that apply to a group
of pages (also known as <i>tag clouds</i>). In general, authors are
encouraged to either mark up such lists using <code><a href="#the-ul-element">ul</a></code>
@@ -41567,7 +41481,7 @@
that apply to the page itself; they are just part of an index
listing the tags themselves.</p>
- </div><h4 id="conversations"><span class="secno">4.13.3 </span>Conversations</h4><!-- http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2009-September/022576.html --><p>This specification does not define a specific element for marking
+ </div><h4 id="conversations"><span class="secno">4.13.4 </span>Conversations</h4><!-- http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2009-September/022576.html --><p>This specification does not define a specific element for marking
up conversations, meeting minutes, chat transcripts, dialogues in
screenplays, instant message logs, and other situations where
different players take turns in discourse.<p>Instead, authors are encouraged to mark up conversations using
@@ -41600,7 +41514,7 @@
<p> <time>14:24</time> <b>kaj</b> you are not helping your case</pre>
<!-- with thanks to http://bash.org/?854262 -->
- </div><h4 id="footnotes"><span class="secno">4.13.4 </span>Footnotes</h4><p>HTML does not have a dedicated mechanism for marking up
+ </div><h4 id="footnotes"><span class="secno">4.13.5 </span>Footnotes</h4><p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.<hr><p>For short inline annotations, the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute should be used.<div class="example">
<p>In this example, two parts of a dialogue are annotated with
Received on Wednesday, 2 March 2011 01:03:05 UTC