- From: poot <cvsmail@w3.org>
- Date: Wed, 13 Apr 2011 19:54:08 -0400
- To: public-html-diffs@w3.org
hixie: Add <u> to HTML and WebVTT. (whatwg r6004)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4826&r2=1.4827&f=h
http://html5.org/tools/web-apps-tracker?from=6003&to=6004
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4826
retrieving revision 1.4827
diff -u -d -r1.4826 -r1.4827
--- Overview.html 13 Apr 2011 22:09:40 -0000 1.4826
+++ Overview.html 13 Apr 2011 23:50:21 -0000 1.4827
@@ -724,16 +724,17 @@
<li><a href="#the-sub-and-sup-elements"><span class="secno">4.6.15 </span>The <code>sub</code> and <code>sup</code> elements</a></li>
<li><a href="#the-i-element"><span class="secno">4.6.16 </span>The <code>i</code> element</a></li>
<li><a href="#the-b-element"><span class="secno">4.6.17 </span>The <code>b</code> element</a></li>
- <li><a href="#the-mark-element"><span class="secno">4.6.18 </span>The <code>mark</code> element</a></li>
- <li><a href="#the-ruby-element"><span class="secno">4.6.19 </span>The <code>ruby</code> element</a></li>
- <li><a href="#the-rt-element"><span class="secno">4.6.20 </span>The <code>rt</code> element</a></li>
- <li><a href="#the-rp-element"><span class="secno">4.6.21 </span>The <code>rp</code> element</a></li>
- <li><a href="#the-bdi-element"><span class="secno">4.6.22 </span>The <code>bdi</code> element</a></li>
- <li><a href="#the-bdo-element"><span class="secno">4.6.23 </span>The <code>bdo</code> element</a></li>
- <li><a href="#the-span-element"><span class="secno">4.6.24 </span>The <code>span</code> element</a></li>
- <li><a href="#the-br-element"><span class="secno">4.6.25 </span>The <code>br</code> element</a></li>
- <li><a href="#the-wbr-element"><span class="secno">4.6.26 </span>The <code>wbr</code> element</a></li>
- <li><a href="#usage-summary"><span class="secno">4.6.27 </span>Usage summary</a></ol></li>
+ <li><a href="#the-u-element"><span class="secno">4.6.18 </span>The <code>u</code> element</a></li>
+ <li><a href="#the-mark-element"><span class="secno">4.6.19 </span>The <code>mark</code> element</a></li>
+ <li><a href="#the-ruby-element"><span class="secno">4.6.20 </span>The <code>ruby</code> element</a></li>
+ <li><a href="#the-rt-element"><span class="secno">4.6.21 </span>The <code>rt</code> element</a></li>
+ <li><a href="#the-rp-element"><span class="secno">4.6.22 </span>The <code>rp</code> element</a></li>
+ <li><a href="#the-bdi-element"><span class="secno">4.6.23 </span>The <code>bdi</code> element</a></li>
+ <li><a href="#the-bdo-element"><span class="secno">4.6.24 </span>The <code>bdo</code> element</a></li>
+ <li><a href="#the-span-element"><span class="secno">4.6.25 </span>The <code>span</code> element</a></li>
+ <li><a href="#the-br-element"><span class="secno">4.6.26 </span>The <code>br</code> element</a></li>
+ <li><a href="#the-wbr-element"><span class="secno">4.6.27 </span>The <code>wbr</code> element</a></li>
+ <li><a href="#usage-summary"><span class="secno">4.6.28 </span>Usage summary</a></ol></li>
<li><a href="#edits"><span class="secno">4.7 </span>Edits</a>
<ol>
<li><a href="#the-ins-element"><span class="secno">4.7.1 </span>The <code>ins</code> element</a></li>
@@ -1763,7 +1764,7 @@
pages.<p>It is also worth noting that some elements that were previously
presentational have been redefined in this specification to be
media-independent: <code><a href="#the-b-element">b</a></code>, <code><a href="#the-i-element">i</a></code>, <code><a href="#the-hr-element">hr</a></code>,
- <code><a href="#the-s-element">s</a></code>, and <code><a href="#the-small-element">small</a></code>.<h4 id="syntax-errors"><span class="secno">1.9.2 </span>Syntax errors</h4><p><i>This section is non-normative.</i><p>The syntax of HTML is constrained to avoid a wide variety of
+ <code><a href="#the-s-element">s</a></code>, <code><a href="#the-small-element">small</a></code>, and <code><a href="#the-u-element">u</a></code>.<h4 id="syntax-errors"><span class="secno">1.9.2 </span>Syntax errors</h4><p><i>This section is non-normative.</i><p>The syntax of HTML is constrained to avoid a wide variety of
problems.<dl><dt>Unintuitive error-handling behavior</dt>
<dd>
@@ -9018,6 +9019,7 @@
<li><code><a href="#the-table-element">table</a></code></li>
<li><code><a href="#the-textarea-element">textarea</a></code></li>
<li><code><a href="#the-time-element">time</a></code></li>
+ <li><code><a href="#the-u-element">u</a></code></li>
<li><code><a href="#the-ul-element">ul</a></code></li>
<li><code><a href="#the-var-element">var</a></code></li>
<li><code><a href="#video">video</a></code></li>
@@ -9102,6 +9104,7 @@
<li><code><a href="#svg">svg</a></code></li>
<li><code><a href="#the-textarea-element">textarea</a></code></li>
<li><code><a href="#the-time-element">time</a></code></li>
+ <li><code><a href="#the-u-element">u</a></code></li>
<li><code><a href="#the-var-element">var</a></code></li>
<li><code><a href="#video">video</a></code></li>
<li><code><a href="#the-wbr-element">wbr</a></code></li>
@@ -17038,9 +17041,9 @@
</dl><p>The <code><a href="#the-i-element">i</a></code> element <a href="#represents">represents</a> a span of text
in an alternate voice or mood, or otherwise offset from the normal
prose, such as a taxonomic designation, a technical term, an
- idiomatic phrase from another language, a thought, a ship name, or
- some other prose whose typical typographic presentation is
- italicized.<p>Terms in languages different from the main text should be
+ idiomatic phrase from another language, a thought, a ship name in
+ Western texts, or some other prose whose typical typographic
+ presentation is italicized.<p>Terms in languages different from the main text should be
annotated with <code title="attr-lang"><a href="#attr-lang">lang</a></code> attributes (or,
in XML, <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code>
attributes in the <span>XML namespace</span></a>).<div class="example">
@@ -17124,7 +17127,34 @@
</div><p class="note">Style sheets can be used to format <code><a href="#the-b-element">b</a></code>
elements, just like any other element can be restyled. Thus, it is
not the case that content in <code><a href="#the-b-element">b</a></code> elements will
- necessarily be boldened.<h4 id="the-mark-element"><span class="secno">4.6.18 </span>The <dfn><code>mark</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ necessarily be boldened.<h4 id="the-u-element"><span class="secno">4.6.18 </span>The <dfn><code>u</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ <dd><a href="#flow-content">Flow content</a>.</dd>
+ <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
+ <dt>Contexts in which this element can be used:</dt>
+ <dd>Where <a href="#phrasing-content">phrasing content</a> is expected.</dd>
+ <dt>Content model:</dt>
+ <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
+ <dt>Content attributes:</dt>
+ <dd><a href="#global-attributes">Global attributes</a></dd>
+ <dt>DOM interface:</dt>
+ <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
+ </dl><p>The <code><a href="#the-u-element">u</a></code> element <a href="#represents">represents</a> a span of text
+ with an unarticulated, though explicitly rendered, non-textual
+ annotation, such as labeling the text as being a proper name in
+ Chinese text (a Chinese proper name mark), or labeling the text as
+ being misspelt.<p>In most cases, another element is likely to be more appropriate:
+ for marking stress emphasis, the <code><a href="#the-em-element">em</a></code> element should be
+ used; for marking key words or phrases either the <code><a href="#the-b-element">b</a></code>
+ element or the <code><a href="#the-mark-element">mark</a></code> element should be used, depending
+ on the context; for marking book titles, the <code><a href="#the-cite-element">cite</a></code>
+ element should be used; for labeling text with explicit textual
+ annotations, the <code><a href="#the-ruby-element">ruby</a></code> element should be used; for
+ labeling ship names in Western texts, the <code><a href="#the-i-element">i</a></code> element
+ should be used.<p class="note">The default rendering of the <code><a href="#the-u-element">u</a></code> element
+ in visual presentations clashes with the conventional rendering of
+ hyperlinks (underlining). Authors are encouraged to avoid using the
+ <code><a href="#the-u-element">u</a></code> element where it could be confused for a
+ hyperlink.<h4 id="the-mark-element"><span class="secno">4.6.19 </span>The <dfn><code>mark</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17155,6 +17185,9 @@
</blockquote>
<p lang="en-US">As we can tell from the <em>spelling</em> of the word,
the person writing this quote is clearly not American.</p></pre>
+ <p>(If the goal was to mark the element as misspelt, however, the
+ <code><a href="#the-u-element">u</a></code> element, possibly with a class, would be more
+ appropriate.</p>
</div><div class="example">
<p>Another example of the <code><a href="#the-mark-element">mark</a></code> element is highlighting
@@ -17254,7 +17287,7 @@
<p><mark>An obstruction in a gate will prevent it from accepting a
wormhole connection.</mark></p></pre>
- </div><h4 id="the-ruby-element"><span class="secno">4.6.19 </span>The <dfn><code>ruby</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-ruby-element"><span class="secno">4.6.20 </span>The <dfn><code>ruby</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17318,7 +17351,7 @@
<p><img alt="The two main ideographs, each with its pinyin annotation rendered in a smaller font above it." height="79" src="http://dev.w3.org/html5/spec/images/sample-ruby-pinyin.png" width="173"></p>
- </div><h4 id="the-rt-element"><span class="secno">4.6.20 </span>The <dfn><code>rt</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-rt-element"><span class="secno">4.6.21 </span>The <dfn><code>rt</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd>None.</dd>
<dt>Contexts in which this element can be used:</dt>
<dd>As a child of a <code><a href="#the-ruby-element">ruby</a></code> element.</dd>
@@ -17339,7 +17372,7 @@
<code><a href="#the-ruby-element">ruby</a></code> element represents the same thing as its
children.</p>
- </div><h4 id="the-rp-element"><span class="secno">4.6.21 </span>The <dfn><code>rp</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-rp-element"><span class="secno">4.6.22 </span>The <dfn><code>rp</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd>None.</dd>
<dt>Contexts in which this element can be used:</dt>
<dd>As a child of a <code><a href="#the-ruby-element">ruby</a></code> element, either immediately before or immediately after an <code><a href="#the-rt-element">rt</a></code> element.</dd>
@@ -17375,7 +17408,7 @@
<pre lang="ja">... 漢 (かん) 字 (じ) ...</pre>
- </div><h4 id="the-bdi-element"><span class="secno">4.6.22 </span>The <dfn><code>bdi</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-bdi-element"><span class="secno">4.6.23 </span>The <dfn><code>bdi</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17428,7 +17461,7 @@
<li>User <bdi><bdo dir="rtl">إيان</bdo></bdi>: 3 posts.
</ul></pre>
- </div><h4 id="the-bdo-element"><span class="secno">4.6.23 </span>The <dfn><code>bdo</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-bdo-element"><span class="secno">4.6.24 </span>The <dfn><code>bdo</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17468,7 +17501,7 @@
these requirements by implementing the CSS 'unicode-bidi' property.
<a href="#refsCSS">[CSS]</a></p>
- </div><h4 id="the-span-element"><span class="secno">4.6.24 </span>The <dfn><code>span</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-span-element"><span class="secno">4.6.25 </span>The <dfn><code>span</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17499,7 +17532,7 @@
<span class="keyword">break</span>;
}</code></pre></pre>
- </div><h4 id="the-br-element"><span class="secno">4.6.25 </span>The <dfn><code>br</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-br-element"><span class="secno">4.6.26 </span>The <dfn><code>br</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17562,7 +17595,7 @@
implementing the CSS 'unicode-bidi' property. <a href="#refsBIDI">[BIDI]</a> <a href="#refsCSS">[CSS]</a></p>
- </div><h4 id="the-wbr-element"><span class="secno">4.6.26 </span>The <dfn><code>wbr</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-wbr-element"><span class="secno">4.6.27 </span>The <dfn><code>wbr</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -17590,7 +17623,7 @@
<p>Any content inside <code><a href="#the-wbr-element">wbr</a></code> elements must not be
considered part of the surrounding text.</p>
- </div><h4 id="usage-summary"><span class="secno">4.6.27 </span>Usage summary</h4><p><i>This section is non-normative.</i><table><thead><tr><th>Element
+ </div><h4 id="usage-summary"><span class="secno">4.6.28 </span>Usage summary</h4><p><i>This section is non-normative.</i><table><thead><tr><th>Element
<th>Purpose
<th>Example
<tbody><tr><td><code><a href="#the-a-element">a</a></code>
@@ -17665,6 +17698,10 @@
<td>Keywords
<td><pre class="example">Take a <strong><b>lemon</b></strong> and squeeze it with a <strong><b>juicer</b></strong>.</pre>
+ <tr><td><code><a href="#the-u-element">u</a></code>
+ <td>Annotations
+ <td><pre class="example">The mixture of apple juice and <u class="spelling">eldeflower</u> juice is very pleasant.</pre>
+
<tr><td><code><a href="#the-mark-element">mark</a></code>
<td>Highlight
<td><pre class="example">Elderflower cordial, with one <strong><mark>part</mark></strong> cordial to ten <strong><mark>part</mark></strong>s water, stands a<strong><mark>part</mark></strong> from the rest.</pre>
@@ -53780,7 +53817,7 @@
<code><a href="#the-em-element">em</a></code>, <code><a href="#font">font</a></code>, <code><a href="#the-i-element">i</a></code>,
<code><a href="#nobr">nobr</a></code>, <code><a href="#the-s-element">s</a></code>, <code><a href="#the-small-element">small</a></code>,
<code><a href="#strike">strike</a></code>, <code><a href="#the-strong-element">strong</a></code>, <code><a href="#tt">tt</a></code>, and
- <code><a href="#u">u</a></code>.</dd>
+ <code><a href="#the-u-element">u</a></code>.</dd>
<dt><dfn id="ordinary">Ordinary</dfn></dt>
<dd><p>All other elements found while parsing an HTML
@@ -62658,9 +62695,13 @@
of WebVTT Node Objects</span>, if supported.</p>
<p>The 'font-style' property on <span title="WebVTT Italic
Object">WebVTT Italic Objects</span> must be set to 'italic'.</p>
+
<p>The 'font-weight' property on <span title="WebVTT Bold
Object">WebVTT Bold Objects</span> must be set to 'bold'.</p>
+ <p>The 'text-decoration' property on <span title="WebVTT Underline
+ Object">WebVTT Underline Objects</span> must be set to 'underline'.</p>
+
<p>The 'display' property on <span title="WebVTT Ruby Object">WebVTT
Ruby Objects</span> must be set to 'ruby'. <a href="#refsCSSRUBY">[CSSRUBY]</a></p>
@@ -62771,6 +62812,9 @@
<tr><td><span title="WebVTT Bold Object">WebVTT Bold Objects</span>
<td><code title="">b</code>
+ <tr><td><span title="WebVTT Underline Object">WebVTT Underline Objects</span>
+ <td><code title="">u</code>
+
<tr><td><span title="WebVTT Ruby Object">WebVTT Ruby Objects</span>
<td><code title="">ruby</code>
@@ -64275,7 +64319,6 @@
<dt><dfn id="nobr"><code>nobr</code></dfn></dt>
<dt><dfn id="spacer"><code>spacer</code></dfn></dt>
<dt><dfn id="tt"><code>tt</code></dfn></dt>
- <dt><dfn id="u"><code>u</code></dfn></dt>
<dd>
@@ -64287,12 +64330,12 @@
code, consider the <code><a href="#the-code-element">code</a></code> element; and for computer
output, consider the <code><a href="#the-samp-element">samp</a></code> element.</p>
- <p>Similarly, if the <code><a href="#u">u</a></code> element is being used to
- indicate emphasis, consider using the <code><a href="#the-em-element">em</a></code> element; if
- it is being used for marking up keywords, consider the
- <code><a href="#the-b-element">b</a></code> element; and if it is being used for highlighting
- text for reference purposes, consider the <code><a href="#the-mark-element">mark</a></code>
- element.</p>
+ <p>Similarly, if the <code><a href="#big">big</a></code> element is being used to
+ denote a heading, consider using the <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code> element; if
+ it is being used for marking up important passages, consider the
+ <code><a href="#the-strong-element">strong</a></code> element; and if it is being used for
+ highlighting text for reference purposes, consider the
+ <code><a href="#the-mark-element">mark</a></code> element.</p>
<p>See also the <a href="#usage-summary">text-level semantics
usage summary</a> for more suggestions with examples.</p>
@@ -67010,7 +67053,15 @@
<code title="attr-track-src"><a href="#attr-track-src">src</a></code>;
<code title="attr-track-srclang"><a href="#attr-track-srclang">srclang</a></code></td>
<td><code><a href="#htmltrackelement">HTMLTrackElement</a></code></td>
- </tr><tr><th><code><a href="#the-ul-element">ul</a></code></th>
+ </tr><tr><th><code><a href="#the-u-element">u</a></code></th>
+ <td>Keywords</td>
+ <td><a href="#flow-content" title="Flow content">flow</a>;
+ <a href="#phrasing-content" title="Phrasing content">phrasing</a></td>
+ <td><a href="#phrasing-content" title="Phrasing content">phrasing</a></td>
+ <td><a href="#phrasing-content" title="Phrasing content">phrasing</a></td>
+ <td><a href="#global-attributes" title="global attributes">globals</a></td>
+ <td><code><a href="#htmlelement">HTMLElement</a></code></td>
+ <tr><th><code><a href="#the-ul-element">ul</a></code></th>
<td>List</td>
<td><a href="#flow-content" title="Flow content">flow</a></td>
<td><a href="#flow-content" title="Flow content">flow</a></td>
@@ -67145,6 +67196,7 @@
<code><a href="#the-table-element">table</a></code>;
<code><a href="#the-textarea-element">textarea</a></code>;
<code><a href="#the-time-element">time</a></code>;
+ <code><a href="#the-u-element">u</a></code>;
<code><a href="#the-ul-element">ul</a></code>;
<code><a href="#the-var-element">var</a></code>;
<code><a href="#video">video</a></code>;
@@ -67220,6 +67272,7 @@
<code><a href="#svg">svg</a></code>;
<code><a href="#the-textarea-element">textarea</a></code>;
<code><a href="#the-time-element">time</a></code>;
+ <code><a href="#the-u-element">u</a></code>;
<code><a href="#the-var-element">var</a></code>;
<code><a href="#video">video</a></code>;
<code><a href="#the-wbr-element">wbr</a></code>;
@@ -68680,6 +68733,9 @@
<tr><td> <code><a href="#the-track-element">track</a></code>
<td> <code><a href="#htmltrackelement">HTMLTrackElement</a></code> : <code><a href="#htmlelement">HTMLElement</a></code>
+ <tr><td> <code><a href="#the-u-element">u</a></code>
+ <td> <code><a href="#htmlelement">HTMLElement</a></code>
+
<tr><td> <code><a href="#the-ul-element">ul</a></code>
<td> <code><a href="#htmlulistelement">HTMLUListElement</a></code> : <code><a href="#htmlelement">HTMLElement</a></code>
Received on Wednesday, 13 April 2011 23:54:10 UTC