[html5] r1468 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2008-04-20 15:20:47 -0700 (Sun, 20 Apr 2008)
New Revision: 1468

Modified:
   index
   source
Log:
[c] (0) Change <abbr>. It's only valid for actual expansions now.

Modified: index
===================================================================
--- index	2008-04-20 08:38:31 UTC (rev 1467)
+++ index	2008-04-20 22:20:47 UTC (rev 1468)
@@ -11221,40 +11221,39 @@
   </dl>
 
   <p>The <code><a href="#abbr">abbr</a></code> element represents an
-   abbreviation or acronym. The <dfn id=title5
-   title=attr-abbr-title><code>title</code></dfn> attribute should be used to
-   provide an expansion of the abbreviation. If present, the attribute must
-   only contain an expansion of the abbreviation.
+   abbreviation or acronym, with its expansion. The <dfn id=title5
+   title=attr-abbr-title><code>title</code></dfn> attribute must be used to
+   provide an expansion of the abbreviation. The attribute must only contain
+   an expansion of the abbreviation.
 
   <div class=example>
    <p>The paragraph below contains an abbreviation marked up with the
-    <code><a href="#abbr">abbr</a></code> element.</p>
+    <code><a href="#abbr">abbr</a></code> element. This paragraph <a
+    href="#defining" title="defining term">defines the term</a> "Web
+    Hypertext Application Technology Working Group".</p>
 
-   <pre><p>The <abbr title="Web Hypertext Application Technology
-Working Group">WHATWG</abbr> 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.</p></pre>
+   <pre><p>The <dfn id=whatwg><abbr title="Web Hypertext Application
+Technology Working Group">WHATWG</abbr></dfn> 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.</p></pre>
   </div>
-  <!-- XXX should we get rid of the following?: -->
 
-  <p>The <code title=attr-abbr-title><a href="#title5">title</a></code>
-   attribute may be omitted if there is a <code><a href="#dfn">dfn</a></code>
-   element in the document whose <a href="#defining">defining term</a> is the
-   abbreviation (the <code><a href="#textcontent">textContent</a></code> of
-   the <code><a href="#abbr">abbr</a></code> element).
+  <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 use the
+    <code><a href="#abbr">abbr</a></code> element.</p>
 
+   <pre><p>The <abbr title="Web Hypertext Application Technology Working
+Group">WHATWG</abbr> started working on HTML5 in 2004.</p></pre>
+  </div>
+
   <div class=example>
-   <p>In the example below, the word "Zat" is used as an abbreviation in the
-    second paragraph. The abbreviation is defined in the first, so the
-    explanatory <code title=attr-abbr-title><a
-    href="#title5">title</a></code> attribute has been omitted. Because of
-    the way <code><a href="#dfn">dfn</a></code> elements are defined, the
-    second <code><a href="#abbr">abbr</a></code> element in this example
-    could be connected (in some UA-specific way) to the first.</p>
+   <p>This paragraph links an abbreviation to its definition.</p>
 
-   <pre><p>The <dfn><abbr>Zat</abbr></dfn>, short for Zat'ni'catel, is a weapon.</p>
-<p>Jack used a <abbr>Zat</abbr> to make the boxes of evidence disappear.</p></pre>
+   <pre><p>The <a href="#whatwg"><abbr title="Web Hypertext Application
+Technology Working Group">WHATWG</abbr></a> community does not
+have much representation from Asia.</p></pre>
   </div>
 
   <h4 id=the-time><span class=secno>3.10.10 </span>The <dfn

Modified: source
===================================================================
--- source	2008-04-20 08:38:31 UTC (rev 1467)
+++ source	2008-04-20 22:20:47 UTC (rev 1468)
@@ -9345,41 +9345,36 @@
   </dl>
 
   <p>The <code>abbr</code> element represents an abbreviation or
-  acronym. The <dfn title="attr-abbr-title"><code>title</code></dfn>
-  attribute should be used to provide an expansion of the
-  abbreviation. If present, the attribute must only contain an
-  expansion of the abbreviation.</p>
+  acronym, with its expansion. The <dfn
+  title="attr-abbr-title"><code>title</code></dfn> attribute must be
+  used to provide an expansion of the abbreviation. The attribute must
+  only contain an expansion of the abbreviation.</p>
 
   <div class="example">
    <p>The paragraph below contains an abbreviation marked up with the
-   <code>abbr</code> element.</p>
-   <pre><p>The <abbr title="Web Hypertext Application Technology
-Working Group">WHATWG</abbr> 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.</p></pre>
+   <code>abbr</code> element. This paragraph <span title="defining
+   term">defines the term</span> "Web Hypertext Application Technology
+   Working Group".</p>
+   <pre><p>The <dfn id=whatwg><abbr title="Web Hypertext Application
+Technology Working Group">WHATWG</abbr></dfn> 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.</p></pre>
   </div>
 
-  <!-- XXX should we get rid of the following?: -->
-
-  <p>The <code title="attr-abbr-title">title</code> attribute may be
-  omitted if there is a <code>dfn</code> element in the document whose
-  <span>defining term</span> is the abbreviation (the
-  <code>textContent</code> of the <code>abbr</code> element).</p>
-
   <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
+   use the <code>abbr</code> element.</p>
+   <pre><p>The <abbr title="Web Hypertext Application Technology Working
+Group">WHATWG</abbr> started working on HTML5 in 2004.</p></pre>
+  </div>
 
-   <p>In the example below, the word "Zat" is used as an abbreviation
-   in the second paragraph. The abbreviation is defined in the first,
-   so the explanatory <code title="attr-abbr-title">title</code>
-   attribute has been omitted. Because of the way <code>dfn</code>
-   elements are defined, the second <code>abbr</code> element in this
-   example could be connected (in some UA-specific way) to the
-   first.</p>
-
-   <pre><p>The <dfn><abbr>Zat</abbr></dfn>, short for Zat'ni'catel, is a weapon.</p>
-<p>Jack used a <abbr>Zat</abbr> to make the boxes of evidence disappear.</p></pre>
-
+  <div class="example">
+   <p>This paragraph links an abbreviation to its definition.</p>
+   <pre><p>The <a href="#whatwg"><abbr title="Web Hypertext Application
+Technology Working Group">WHATWG</abbr></a> community does not
+have much representation from Asia.</p></pre>
   </div>