spec/Overview.html 1.1637 2466 Add some examples for <dfn> and <abbr>.

Add some examples for <dfn> and <abbr>. (whatwg r2466)

4.6.9 The abbr element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1637.html#the-abbr-element
4.5.12 The dd element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1637.html#the-dd-element
4.6 Text-level semantics
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1637.html#text-level-semantics

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1636&r2=1.1637&f=h
http://html5.org/tools/web-apps-tracker?from=2465&to=2466

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1636
retrieving revision 1.1637
diff -u -d -r1.1636 -r1.1637
--- Overview.html 26 Nov 2008 22:21:18 -0000 1.1636
+++ Overview.html 26 Nov 2008 22:48:59 -0000 1.1637
@@ -9468,7 +9468,26 @@
   </dl><p>The <code><a href=#the-dd-element>dd</a></code> element represents the description,
   definition, or value, part of a term-description group in a
   description list (<code><a href=#the-dl-element>dl</a></code> element), and the discourse, or
-  quote, part in a conversation (<code><a href=#the-dialog-element>dialog</a></code> element).<h3 id=text-level-semantics><span class=secno>4.6 </span>Text-level semantics</h3><!-- XXX ew, find a better section name --><h4 id=the-a-element><span class=secno>4.6.1 </span>The <dfn><code>a</code></dfn> element</h4><dl class=element><dt>Categories</dt>
+  quote, part in a conversation (<code><a href=#the-dialog-element>dialog</a></code> element).<div class=example>
+
+   <p>A <code><a href=#the-dl-element>dl</a></code> can be used to define a vocabulary list, like
+   in a dictionary. In the following example, each entry, given by a
+   <code><a href=#the-dt-element>dt</a></code> with a <code><a href=#the-dfn-element>dfn</a></code>, has several
+   <code><a href=#the-dd-element>dd</a></code>s, showing the various parts of the definition.</p>
+
+   <!-- the actual pronunciations below are nonsense. -->
+   <pre>&lt;dl&gt;
+ &lt;dt&gt;&lt;dfn&gt;happiness&lt;/dfn&gt;&lt;/dt&gt;
+ &lt;dd class="pronunciation"&gt;/'h&aelig; p. nes/&lt;/dd&gt;
+ &lt;dd class="part-of-speech"&gt;&lt;i&gt;&lt;abbr&gt;n.&lt;/abbr&gt;&lt;/i&gt;&lt;/dd&gt;
+ &lt;dd&gt;The state of being happy.&lt;/dd&gt;
+ &lt;dd&gt;Good fortune; success. &lt;q&gt;Oh &lt;b&gt;happiness&lt;/b&gt;! It worked!&lt;/q&gt;&lt;/dd&gt;
+ &lt;dt&gt;&lt;dfn&gt;rejoice&lt;/dfn&gt;&lt;/dt&gt;
+ &lt;dd class="pronunciation"&gt;/ri jois'/&lt;/dd&gt;
+ &lt;dd&gt;&lt;i class="part-of-speech"&gt;&lt;abbr&gt;v.intr.&lt;/abbr&gt;&lt;/i&gt; To be delighted oneself.&lt;/dd&gt;
+ &lt;dd&gt;&lt;i class="part-of-speech"&gt;&lt;abbr&gt;v.tr.&lt;/abbr&gt;&lt;/i&gt; To cause one to be delighted.&lt;/dd&gt;
+&lt;/dl&gt;</pre>
+  </div><h3 id=text-level-semantics><span class=secno>4.6 </span>Text-level semantics</h3><!-- XXX ew, find a better section name --><h4 id=the-a-element><span class=secno>4.6.1 </span>The <dfn><code>a</code></dfn> element</h4><dl class=element><dt>Categories</dt>
    <dd><a href=#interactive-content-0>Interactive content</a>.</dd>
    <dd>When the element only contains <a href=#phrasing-content-0>phrasing content</a>: <a href=#phrasing-content-0>phrasing content</a>.</dd>
    <dd>Otherwise: <a href=#flow-content-0>flow content</a>.</dd>
@@ -10057,21 +10076,7 @@
 &lt;p&gt;Teal'c activated his &lt;a href=#gdo&gt;&lt;abbr title="Garage Door Opener"&gt;GDO&lt;/abbr&gt;&lt;/a&gt;
 and so Hammond ordered the iris to be opened.&lt;/p&gt;</pre>
 
-  </div><!--XXX
-> One useful line of retreat would be to specify that in the following
-> code, "the state of being happy" is unambiguously a definition of
-> "happiness" and not of any other subset of the <dt>.
->
->     <dl>
->       <dt><dfn>happiness</dfn> /'h&aelig; p. nes/ <i><abbr>n.</abbr></i></dt>
->       <dd>the state of being happy</dd>
->     </dl>
->
-> This could be encouraged by "dt dfn {font-weight: bold; font-style:
-> normal;}" in browsers' default style sheets, which would be quite
-> backward-compatible because of the rarity of <dt><dfn> up to now.
-- mpt
---><h4 id=the-abbr-element><span class=secno>4.6.9 </span>The <dfn><code>abbr</code></dfn> element</h4><dl class=element><dt>Categories</dt>
+  </div><h4 id=the-abbr-element><span class=secno>4.6.9 </span>The <dfn><code>abbr</code></dfn> element</h4><dl class=element><dt>Categories</dt>
    <dd><a href=#phrasing-content-0>Phrasing content</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href=#phrasing-content-0>phrasing content</a> is expected.</dd>
@@ -10095,6 +10100,13 @@
 unofficial collaboration of Web browser manufacturers and interested
 parties who wish to develop new technologies designed to allow authors
 to write and deploy Applications over the World Wide Web.&lt;/p&gt;</pre>
+   <p>An alternative way to write this would be:</p>
+   <pre>&lt;p&gt;The &lt;dfn id=whatwg&gt;Web Hypertext Application Technology
+Working Group&lt;/dfn&gt; (&lt;abbr title="Web Hypertext Application
+Technology Working Group"&gt;WHATWG&lt;/abbr&gt;) is a loose unofficial
+collaboration of Web browser manufacturers and interested parties who
+wish to develop new technologies designed to allow authors to write
+and deploy Applications over the World Wide Web.&lt;/p&gt;</pre>
   </div><div class=example>
    <p>This paragraph has two abbreviations. Notice how only one is
    defined; the other, with no expansion associated with it, does not

Received on Wednesday, 26 November 2008 22:52:20 UTC