- From: poot <cvsmail@w3.org>
- Date: Thu, 27 Nov 2008 08:16:57 +0900 (JST)
- To: public-html-diffs@w3.org
Add explanatory text around <abbr> uses. (whatwg r2467) http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1637&r2=1.1638&f=h http://html5.org/tools/web-apps-tracker?from=2466&to=2467 =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.1637 retrieving revision 1.1638 diff -u -d -r1.1637 -r1.1638 --- Overview.html 26 Nov 2008 22:48:59 -0000 1.1637 +++ Overview.html 26 Nov 2008 23:14:09 -0000 1.1638 @@ -10143,7 +10143,23 @@ this specification: the <abbr>WHATWG</abbr> and the <abbr>HTMLWG</abbr>.</p></pre> - </div><p title=note>Providing an expansion in a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute once will not necessarily + </div><p>Abbreviations do not have to be marked up using this element. It + is expected to be useful in the following cases:<ul><li>Abbreviations for which the author wants to give expansions, + where using the <code><a href=#the-abbr-element>abbr</a></code> element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is an alternative to + including the expansion inline (e.g. in parentheses).</li> + + <li>Abbreviations that are likely to be unfamiliar to the + document's readers, for which authors are encouraged to either mark + up the abbreviation using a <code><a href=#the-abbr-element>abbr</a></code> element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute or include the expansion + inline in the text the first time the abbreviation is used.</li> + + <li>Abbreviations whose presence needs to be semantically + annotated, e.g. so that they can be identified from a style sheet + and given specific styles, for which the <code><a href=#the-abbr-element>abbr</a></code> element + can be used without a <code title=attr-title><a href=#the-title-attribute>title</a></code> + attribute.</li> + + </ul><p title=note>Providing an expansion in a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute once will not necessarily cause other <code><a href=#the-abbr-element>abbr</a></code> elements in the same document with the same contents but without a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute to behave as if they had the same expansion. Every
Received on Wednesday, 26 November 2008 23:17:34 UTC