W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2011

html5/spec Overview.html,1.4826,1.4827

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 13 Apr 2011 23:50:25 +0000
To: public-html-commits@w3.org
Message-Id: <E1QA9pJ-0004F6-Jk@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv16273

Modified Files:
	Overview.html 
Log Message:
Add <u> to HTML and WebVTT. (whatwg r6004)

Index: Overview.html
===================================================================
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 @@
 &lt;/blockquote&gt;
 &lt;p lang="en-US"&gt;As we can tell from the &lt;em&gt;spelling&lt;/em&gt; of the word,
 the person writing this quote is clearly not American.&lt;/p&gt;</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 @@
 &lt;p&gt;&lt;mark&gt;An obstruction in a gate will prevent it from accepting a
 wormhole connection.&lt;/mark&gt;&lt;/p&gt;</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">... &#28450; (&#12363;&#12435;) &#23383; (&#12376;) ...</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 @@
  &lt;li&gt;User &lt;bdi&gt;<bdo dir="rtl">&#1573;&#1610;&#1575;&#1606;</bdo>&lt;/bdi&gt;: 3 posts.
 &lt;/ul&gt;</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 @@
     &lt;span class="keyword"&gt;break&lt;/span&gt;;
 }&lt;/code&gt;&lt;/pre&gt;</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>&lt;b&gt;lemon&lt;/b&gt;</strong> and squeeze it with a <strong>&lt;b&gt;juicer&lt;/b&gt;</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 &lt;u class="spelling"&gt;eldeflower&lt;/u&gt; 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>&lt;mark&gt;part&lt;/mark&gt;</strong> cordial to ten <strong>&lt;mark&gt;part&lt;/mark&gt;</strong>s water, stands a<strong>&lt;mark&gt;part&lt;/mark&gt;</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:50:27 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 13 April 2011 23:52:46 GMT