- 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