- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 12 Jul 2010 17:34:59 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/markup/elements In directory hutz:/tmp/cvs-serv26285/elements Modified Files: a.html b.html cite.html em.html hr.html i.html menu.html small.html strong.html Log Message: for "changed" elements, make it more clear what exactly the changes has been Index: hr.html =================================================================== RCS file: /sources/public/html5/markup/elements/hr.html,v retrieving revision 1.8 retrieving revision 1.9 diff -u -d -r1.8 -r1.9 --- hr.html 10 Feb 2010 12:49:09 -0000 1.8 +++ hr.html 12 Jul 2010 17:34:57 -0000 1.9 @@ -2,15 +2,24 @@ <h4>The hr element</h4> <div id="shortdesc" class="changed">thematic break</div> <div id="longdesc"> - <p>The <a href="#hr" class="element">hr</a> element represents - a paragraph-level thematic break.</p> + <p>The + <a href="#hr" class="element">hr</a> + element represents a paragraph-level thematic break.</p> </div> <div id="prose-model">Empty</div> <div id="details"> <p>Some examples of thematic breaks that can be marked up - using the hr element include a scene change in a story, or a - transition to another topic within a section of a reference - book.</p> + using the + <a href="#hr" class="element">hr</a> + element include a scene change in a story, or a transition to + another topic within a section of a reference book.</p> + </div> + <div id="changes"> + <p>Although previous versions of HTML defined the + <a class="element" href="#hr">hr</a> + element only in presentational terms, the element has now been + given the specific semantic purpose of representing a + “paragraph-level thematic break”.</p> </div> <div id="dom-interface">HTMLHRElement</div> </div> Index: small.html =================================================================== RCS file: /sources/public/html5/markup/elements/small.html,v retrieving revision 1.6 retrieving revision 1.7 diff -u -d -r1.6 -r1.7 --- small.html 3 Feb 2010 10:27:05 -0000 1.6 +++ small.html 12 Jul 2010 17:34:57 -0000 1.7 @@ -3,8 +3,16 @@ <div id="shortdesc" class="changed">small print</div> <div id="longdesc"> <p>The <a href="#small" class="element">small</a> element - represents so-called “small print” such as legal disclaimers - and caveats.</p> + represents so-called “fine print” or “small print”, such as + legal disclaimers and caveats.</p> + </div> + <div id="changes"> + <p>Although previous versions of HTML defined the + <a class="element" href="#small">small</a> + element only in presentational terms, the element has now been + given the specific semantic purpose of representing those + parts of documents that are often referred to as “the fine + print” or “the small print”.</p> </div> <div id="prose-model">Phrasing content</div> </div> Index: strong.html =================================================================== RCS file: /sources/public/html5/markup/elements/strong.html,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -r1.5 -r1.6 --- strong.html 3 Feb 2010 10:27:05 -0000 1.5 +++ strong.html 12 Jul 2010 17:34:57 -0000 1.6 @@ -1,6 +1,6 @@ <div xmlns="http://www.w3.org/1999/xhtml"> <h4>The strong element</h4> - <div id="shortdesc" class="changed">strong importance</div> + <div id="shortdesc">strong importance</div> <div id="longdesc"> <p>The <a href="#strong" class="element">strong</a> element represents a span of text with strong importance.</p> Index: cite.html =================================================================== RCS file: /sources/public/html5/markup/elements/cite.html,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -r1.5 -r1.6 --- cite.html 8 Mar 2010 18:25:10 -0000 1.5 +++ cite.html 12 Jul 2010 17:34:57 -0000 1.6 @@ -2,10 +2,23 @@ <h4>The cite element</h4> <div id="shortdesc" class="changed">cited title of a work</div> <div id="longdesc"> - <p>The <a href="#cite" class="element">cite</a> element - represents the cited title of a work; for example, the title - of a book mentioned within the main text flow of a + <p>The + <a href="#cite" class="element">cite</a> + element represents the cited title of a work; for example, the + title of a book mentioned within the main text flow of a document.</p> </div> + <div id="changes"> + <p>Although previous versions of HTML implied that the + <a href="#cite" class="element">cite</a> + element can be used to mark up the name of a person, that + usage is no longer considered conforming. The + <a href="#cite" class="element">cite</a> + element now solely represents the cited title of a work; for + example, the title of a book, paper, essay, poem, score, song, + script, film, TV show, game, sculpture, painting, theater + production, play, opera, musical, exhibition, legal case + report, or other such work.</p> + </div> <div id="prose-model">Phrasing content</div> </div> Index: i.html =================================================================== RCS file: /sources/public/html5/markup/elements/i.html,v retrieving revision 1.6 retrieving revision 1.7 diff -u -d -r1.6 -r1.7 --- i.html 29 Jan 2010 10:17:09 -0000 1.6 +++ i.html 12 Jul 2010 17:34:57 -0000 1.7 @@ -1,18 +1,23 @@ <div xmlns="http://www.w3.org/1999/xhtml"> <h4>The i element</h4> - <div id="shortdesc">offset text typically styled in italic</div> + <div id="shortdesc" class="changed">offset text conventionally styled in italic</div> <div id="longdesc"> <p>The <a href="#i" class="element">i</a> element represents a - span of text in an alternate voice or mood, or otherwise - offset from the normal prose (content whose typical - typographic presentation is italicized).</p> + span of text offset from its surrounding content without + conveying any extra emphasis or importance, and for which the + conventional typographic presentation is italic text; for + example, a taxonomic designation, a technical term, an + idiomatic phrase from another language, a thought, or a ship + name.</p> </div> <div id="prose-model">Phrasing content</div> - <div id="details"> - <p>Some examples of spans that might use the i element include - 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> + <div id="changes"> + <p>Although previous versions of HTML defined the + <a class="element" href="#i">i</a> + element only in presentational terms, the element has now been + given the specific semantic purpose of representing text + “offset from its surrounding content without conveying any + extra emphasis or importance, and for which the conventional + typographic presentation is italic text”.</p> </div> </div> Index: em.html =================================================================== RCS file: /sources/public/html5/markup/elements/em.html,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -r1.5 -r1.6 --- em.html 22 Feb 2010 09:36:44 -0000 1.5 +++ em.html 12 Jul 2010 17:34:57 -0000 1.6 @@ -1,6 +1,6 @@ <div xmlns="http://www.w3.org/1999/xhtml"> <h4>The em element</h4> - <div id="shortdesc" class="changed">emphatic stress</div> + <div id="shortdesc">emphatic stress</div> <div id="longdesc"> <p>The <a href="#em" class="element">em</a> element represents a span of text with emphatic stress.</p> Index: b.html =================================================================== RCS file: /sources/public/html5/markup/elements/b.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- b.html 3 Feb 2010 10:27:03 -0000 1.7 +++ b.html 12 Jul 2010 17:34:57 -0000 1.8 @@ -1,12 +1,22 @@ <div xmlns="http://www.w3.org/1999/xhtml"> <h4>The b element</h4> - <div id="shortdesc" class="changed">offset text typically styled in bold</div> + <div id="shortdesc" class="changed">offset text conventionally styled in bold</div> <div id="longdesc"> <p>The <a href="#b" class="element">b</a> element represents a span of text offset from its surrounding content without - conveying any extra importance; for example, keywords in a - document abstract, product names in a review, or other spans - of text whose typical typographic presentation is bold text.</p> + conveying any extra emphasis or importance, and for which the + conventional typographic presentation is bold text; for + example, keywords in a document abstract, or product names in + a review.</p> + </div> + <div id="changes"> + <p>Although previous versions of HTML defined the + <a class="element" href="#b">b</a> + element only in presentational terms, the element has now been + given the specific semantic purpose of representing text + “offset from its surrounding content without conveying any + extra emphasis or importance, and for which the conventional + typographic presentation is bold text”.</p> </div> <div id="prose-model">Phrasing content</div> </div> Index: a.html =================================================================== RCS file: /sources/public/html5/markup/elements/a.html,v retrieving revision 1.21 retrieving revision 1.22 diff -u -d -r1.21 -r1.22 --- a.html 12 Jul 2010 14:16:42 -0000 1.21 +++ a.html 12 Jul 2010 17:34:57 -0000 1.22 @@ -1,6 +1,6 @@ <div xmlns="http://www.w3.org/1999/xhtml"> <h4>The a element</h4> - <div id="shortdesc">hyperlink</div> + <div id="shortdesc" class="changed">hyperlink</div> <div id="longdesc"> <p>The <a class="element" href="#a">a</a> @@ -77,18 +77,25 @@ <dfn id="empty-hyperlink" title="empty-hyperlink">empty hyperlink</dfn>.</p> - <p class="note">Although previous versions of HTML restricted - the + </div> + <div id="changes"> + <p>Although previous versions of HTML restricted the <a class="element" href="#a">a</a> - element to only containing - <a href="#phrasing-content">phrasing content</a>, - the + element to only containing + <a href="#phrasing-content">phrasing content</a> + (essentially, what was in previous versions referred to as + “inline” content), the <a class="element" href="#a">a</a> element is now <a href="#transparent">transparent</a>; - and so is now also allowed to contain + that is, an instance of the + <a class="element" href="#a">a</a> + element is now allowed to also contain <a href="#flow-content">flow content</a> - if its parent element is is allowed to contain + (essentially, what was in previous versions referred to as + “block” content)—if the parent element of that instance of the + <a class="element" href="#a">a</a> + element is an element that is allowed to contain <a href="#flow-content">flow content</a>.</p> </div> <div id="examples"> Index: menu.html =================================================================== RCS file: /sources/public/html5/markup/elements/menu.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -d -r1.10 -r1.11 --- menu.html 29 Mar 2010 20:43:59 -0000 1.10 +++ menu.html 12 Jul 2010 17:34:57 -0000 1.11 @@ -36,5 +36,12 @@ <dd>The label of the menu.</dd> </dl> </div> + <div id="changes"> + <p>Although previous versions of HTML defined the + <a class="element" href="#menu">menu</a> + element as a generic “single column menu list”, + the element has now been given the very specific purpose of + representing a list of <em>commands</em>.</p> + </div> <div id="dom-interface">HTMLMenuElement</div> </div>
Received on Monday, 12 July 2010 17:35:01 UTC