- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 26 Nov 2008 23:14:12 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv17864 Modified Files: Overview.html Log Message: Add explanatory text around <abbr> uses. (whatwg r2467) Index: Overview.html =================================================================== 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:14:21 UTC