W3C home > Mailing lists > Public > public-html-commits@w3.org > July 2010

html5/markup/elements a.html,1.21,1.22 b.html,1.7,1.8 cite.html,1.5,1.6 em.html,1.5,1.6 hr.html,1.8,1.9 i.html,1.6,1.7 menu.html,1.10,1.11 small.html,1.6,1.7 strong.html,1.5,1.6

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 12 Jul 2010 17:34:59 +0000
To: public-html-commits@w3.org
Message-Id: <E1OYMuB-0006yC-O3@lionel-hutz.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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 12 July 2010 17:35:02 GMT