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

html5/markup/elements address.html,1.3,1.4 aside.html,1.3,1.4 datalist.html,1.2,1.3 dd.html,1.3,1.4 dialog.html,1.3,1.4 div.html,1.3,1.4 dl.html,1.3,1.4 dt.html,1.3,1.4 embed.html,1.3,1.4 kbd.html,1.3,1.4 meta.http-equiv.content-type.html,1.2,1.3 noscript.html,1.3,1.4 object.html,1.6,1.7 ruby.html,1.3,1.4 source.html,1.6,1.7 span.html,1.4,1.5 textarea.html,1.4,1.5

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 29 Jul 2009 11:23:49 +0000
To: public-html-commits@w3.org
Message-Id: <E1MW7G9-0002xt-Nx@lionel-hutz.w3.org>
Update of /sources/public/html5/markup/elements
In directory hutz:/tmp/cvs-serv10970/elements

Modified Files:
	address.html aside.html datalist.html dd.html dialog.html 
	div.html dl.html dt.html embed.html kbd.html 
	meta.http-equiv.content-type.html noscript.html object.html 
	ruby.html source.html span.html textarea.html 
Log Message:
further streamlined many element descriptions


Index: address.html
===================================================================
RCS file: /sources/public/html5/markup/elements/address.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- address.html	8 Jan 2009 10:19:30 -0000	1.3
+++ address.html	29 Jul 2009 11:23:46 -0000	1.4
@@ -2,11 +2,15 @@
   <h4>The address element</h4>
   <div id="shortdesc">contact information</div>
   <div id="longdesc">
-    <p>The
-      <a href="#address" class="element">address</a>
-      element represents contact information for the section
-      it applies to. If it applies to the <a href="#body">body</a>
-      element, then it instead applies to the document as a
-      whole.</p>
+    <p>The <a href="#address" class="element">address</a>
+      element represents contact information.</p>
+  </div>
+  <div id="details">
+    <p>If an <a href="#address" class="element">address</a>
+    element applies to a <a href="#body">body</a> element, then
+    it represents contact information for the document as a
+    whole. If an <a href="#address" class="element">address</a>
+    element applies to a section of a document, then it 
+    represents contact information for that section only.</p>
   </div>
 </div>

Index: dt.html
===================================================================
RCS file: /sources/public/html5/markup/elements/dt.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- dt.html	16 Jan 2009 09:31:17 -0000	1.3
+++ dt.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -1,19 +1,13 @@
 <div xmlns="http://www.w3.org/1999/xhtml">
   <h4>The dt element</h4>
-  <div id="shortdesc">term in a term-description grouping</div>
+  <div id="shortdesc">term or “talker”/speaker</div>
   <div id="longdesc">
-    <p>If a <a href="#dt" class="element">dt</a> element’s parent
-    is a <a href="#dl" class="element">dl</a> element, then the 
-    <a href="#dt" class="element">dt</a> element 
-    represents the term (or name) part of a term-description
-    (name-value) grouping in a <a
-    href="#description-list">description list</a>.
-    If a <a href="#dt" class="element">dt</a> element’s parent
-    is a <a href="#dialog" class="element">dialog</a> element,
-    then the <a href="#dt" class="element">dt</a> element
-    represents a “talker” (or speaker) part of a
-    talker-discourse (speaker-quote) pair in a <a
-      href="#conversation" class="element">conversation</a>.</p>
+    <p>The 
+    <a href="#dt" class="element">dt</a>
+    element represents either a
+    <a href="#dt-term">term</a>
+    or a
+    “<a href="#dt-talker">talker</a>”/speaker.</p>
   </div>
   <div id="tags">
     <p>A <code><a href="#dt">dt</a></code> element must have a
@@ -24,4 +18,26 @@
     followed by another <code><a href="#dt">dt</a></code> element or
     a <code><a href="#dd">dd</a></code> element.</p>
   </div>
+  <div id="details">
+    <p>If a <a href="#dt" class="element">dt</a> element’s parent
+    is a <a href="#dl" class="element">dl</a> element, then the 
+    <a href="#dt" class="element">dt</a> element 
+    represents the
+    <dfn
+      id="dt-term"
+      title="dt-term"
+      >term</dfn>
+    (or name) part of a term-description (name-value) grouping in a
+    <a href="#description-list">description list</a>.</p>
+    <p>If a <a href="#dt" class="element">dt</a> element’s parent
+    is a <a href="#dialog" class="element">dialog</a> element,
+    then the <a href="#dt" class="element">dt</a> element
+    represents a 
+    “<dfn
+      id="dt-talker"
+      title="dt-talker"
+      >talker</dfn>”
+    (or speaker) part of a talker-discourse (speaker-quote) pair in a
+    <a href="#conversation">conversation</a>.</p>
+  </div>
 </div>

Index: dialog.html
===================================================================
RCS file: /sources/public/html5/markup/elements/dialog.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- dialog.html	16 Jan 2009 09:31:17 -0000	1.3
+++ dialog.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -3,11 +3,19 @@
   <div id="shortdesc">conversation</div>
   <div id="longdesc">
     <p>The <a href="#dialog" class="element">dialog</a> element
-    represents a <dfn id="conversation">conversation</dfn>, which
-    consists of zero or more talker-discourse (speaker-quote)
+    represents a <a href="#conversation">conversation</a>.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#dialog" class="element">dialog</a> element
+    represents a
+    <dfn
+      id="conversation"
+      title="conversation"
+      >conversation</dfn>,
+    which consists of zero or more talker-discourse (speaker-quote)
     pairs; each pair associates a “talker”/speaker (represented by
     a <a href="#dt" class="element">dt</a> element) with a span of
-    discourse/quote (represented by a <a href="#dd"
-    class="element">dd</a> element).</p>
+    span of discourse/quote
+    (represented by a <a href="#dd" class="element">dd</a> element).</p>
   </div>
 </div>

Index: source.html
===================================================================
RCS file: /sources/public/html5/markup/elements/source.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- source.html	7 Jun 2009 05:27:02 -0000	1.6
+++ source.html	29 Jul 2009 11:23:47 -0000	1.7
@@ -3,10 +3,20 @@
   <div id="shortdesc">media resource</div>
   <div id="longdesc">
     <p>The <a href="#source" class="element">source</a> element
-    allows authors to specify multiple media resources for media
-    elements (each <dfn id="media-resource">media resource</dfn>
-    is a complete set of media data — for example, a complete
-    video file, or a complete audio file).</p>
+    allows authors to specify multiple
+    <a href="#media-resource">media resources</a>
+    for media elements.</p>
+  </div>
+  <div id="details">
+    <p>Each separate
+    <dfn
+      id="media-resource"
+      title="media-resource"
+      >media resource</dfn>
+    specified within a
+    <a href="#source" class="element">source</a>
+    element is a complete set of media data — for example, a
+    complete video file, or a complete audio file).</p>
   </div>
   <div id="attributes">
     <dl>

Index: meta.http-equiv.content-type.html
===================================================================
RCS file: /sources/public/html5/markup/elements/meta.http-equiv.content-type.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- meta.http-equiv.content-type.html	13 Feb 2009 12:07:30 -0000	1.2
+++ meta.http-equiv.content-type.html	29 Jul 2009 11:23:47 -0000	1.3
@@ -10,10 +10,21 @@
       href="#meta.http-equiv.attrs.content.content-type"
       >content</a> attribute and value represents a <a
       href="#encoding-declaration">character encoding
-      declaration</a>. Such a <a href="#meta"
-      class="element">meta</a> element is said to be in the <dfn
-      id="encoding-declaration-state">encoding declaration
-      state</dfn>.</p>
+      declaration</a>.</p>
+  </div>
+  <div id="details">
+    <p>A <a href="#meta" class="element">meta</a> element with a
+    <span class="attribute">http-equiv</span> attribute whose
+      value is "<a
+      href="#meta.http-equiv.attrs.http-equiv.content-type"
+      >content-type</a>" and which has an accompanying <a
+      href="#meta.http-equiv.attrs.content.content-type"
+      >content</a> attribute and value is said to 
+      be in the
+      <dfn
+      id="encoding-declaration-state"
+      title="encoding-declaration-state"
+      >encoding declaration state</dfn>.</p>
   </div>
   <div id="attributes">
     <dl>

Index: div.html
===================================================================
RCS file: /sources/public/html5/markup/elements/div.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- div.html	20 Jan 2009 18:42:29 -0000	1.3
+++ div.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -4,8 +4,11 @@
   <div id="longdesc">
     <p>The <a href="#div" class="element">div</a> element is a
     generic container for flow content that by itself does not
-    represent anything.
-    It can be used with attributes such as
+    represent anything.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#div" class="element">div</a>
+    can be used with attributes such as
     <a href="#common.attrs.class">class</a>,
     <a href="#common.attrs.lang">lang</a>/<a
       href="#common.attrs.xmllang">xml:lang</a>,

Index: ruby.html
===================================================================
RCS file: /sources/public/html5/markup/elements/ruby.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- ruby.html	15 Feb 2009 18:31:39 -0000	1.3
+++ ruby.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -3,7 +3,6 @@
   <div id="shortdesc">ruby annotation</div>
   <div id="longdesc">
     <p>The <a href="#ruby" class="element">ruby</a> element allows
-    one or more spans of phrasing content to be marked with ruby
-    annotations.</p>
+    spans of phrasing content to be marked with ruby annotations.</p>
   </div>
 </div>

Index: textarea.html
===================================================================
RCS file: /sources/public/html5/markup/elements/textarea.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- textarea.html	19 Feb 2009 03:00:11 -0000	1.4
+++ textarea.html	29 Jul 2009 11:23:47 -0000	1.5
@@ -4,8 +4,14 @@
   <div id="longdesc">
     <p>The <a href="#textarea" class="element">textarea</a>
     element represents a multi-line plain-text edit control for
-    the element’s raw value. The contents of the element represent
-    the control’s default value.</p>
+    the element’s raw value.</p>
+  </div>
+  <div id="details">
+    <p>The 
+    <a href="#contents">contents</a>
+    of the
+    <a href="#textarea" class="element">textarea</a>
+    element represent the control’s default value.</p>
   </div>
   <div class="attributes">
     <dl>

Index: datalist.html
===================================================================
RCS file: /sources/public/html5/markup/elements/datalist.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- datalist.html	20 Jan 2009 18:42:29 -0000	1.2
+++ datalist.html	29 Jul 2009 11:23:47 -0000	1.3
@@ -5,10 +5,15 @@
     <p>The <a href="#datalist" class="element">datalist</a>
     element represents a
     set of <a href="#option" class="element">option</a> elements
-    that represent predefined options for other controls. The
-    content of the element represents fallback content for legacy
-    user agents, intermixed with <a href="#option"
-      class="element">option</a> elements that represent the
-    predefined options.</p>
+    that represent predefined options for other controls.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#contents">contents</a>
+    of the
+    <a href="#datalist" class="element">datalist</a>
+    element represent fallback content for legacy
+    user agents, intermixed with
+    <a href="#option" class="element">option</a>
+    elements that represent the predefined options.</p>
   </div>
 </div>

Index: dd.html
===================================================================
RCS file: /sources/public/html5/markup/elements/dd.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- dd.html	16 Jan 2009 09:31:17 -0000	1.3
+++ dd.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -1,19 +1,13 @@
 <div xmlns="http://www.w3.org/1999/xhtml">
   <h4>The dd element</h4>
-  <div id="shortdesc">description in a term-description grouping</div>
+  <div id="shortdesc">description or span of discourse</div>
   <div id="longdesc">
-    <p>If a <a href="#dd" class="element">dd</a> element’s parent
-    is a <a href="#dl" class="element">dl</a> element, then the 
-    <a href="#dd" class="element">dd</a> element represents
-    the description (or value) part of a term-description
-    (name-value) grouping in a <a
-      href="#description-list">description list</a>.
-    If a <a href="#dd" class="element">dd</a> element’s parent
-    is a <a href="#dialog" class="element">dialog</a> element,
-    then the <a href="#dd" class="element">dd</a> element
-    represents a span of discourse (a quote) in a talker-discourse
-    (speaker-quote) pair in a <a href="#conversation"
-    class="element">conversation</a>.</p>
+    <p>The 
+    <a href="#dd" class="element">dd</a>
+    element represents either a
+    <a href="#dd-description">description</a>
+    or a
+    <a href="#dd-discourse">span of discourse</a>.</p>
   </div>
   <div id="tags">
     <p>A <code><a href="#dd">dd</a></code> element must have a
@@ -25,4 +19,27 @@
     a <code><a href="#dt">dt</a></code> element, or if there is no
     more content in the parent element.</p>
   </div>
+  <div id="details">
+    <p>If a <a href="#dd" class="element">dd</a> element’s parent
+    is a <a href="#dl" class="element">dl</a> element, then the 
+    <a href="#dd" class="element">dd</a> element represents
+    the
+    <dfn
+      id="dd-description"
+      title="dd-description"
+      >description</dfn>
+    (or value) part of a term-description (name-value) grouping in a
+    <a href="#description-list">description list</a>.</p>
+    <p>If a <a href="#dd" class="element">dd</a> element’s parent
+    is a <a href="#dialog" class="element">dialog</a> element,
+    then the <a href="#dd" class="element">dd</a> element
+    represents a
+    <dfn
+      id="dd-discourse"
+      title="dd-discourse"
+      >span of discourse</dfn>
+    (a quote) in a talker-discourse
+    (speaker-quote) pair in a
+    <a href="#conversation">conversation</a>.</p>
+  </div>
 </div>

Index: span.html
===================================================================
RCS file: /sources/public/html5/markup/elements/span.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- span.html	25 Feb 2009 08:07:57 -0000	1.4
+++ span.html	29 Jul 2009 11:23:47 -0000	1.5
@@ -4,8 +4,11 @@
   <div id="longdesc">
     <p>The <a href="#span" class="element">span</a> element is a
     generic wrapper for phrasing content that by itself does not
-    represent anything.
-    It can be used with attributes such as
+    represent anything.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#span" class="element">span</a> element is a
+    can be used with attributes such as
     <a href="#common.attrs.class">class</a>,
     <a href="#common.attrs.lang">lang</a>/<a
       href="#common.attrs.xmllang">xml:lang</a>,

Index: embed.html
===================================================================
RCS file: /sources/public/html5/markup/elements/embed.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- embed.html	20 Jan 2009 18:42:29 -0000	1.3
+++ embed.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -3,11 +3,7 @@
   <div id="shortdesc">integration point for plugins</div>
   <div id="longdesc">
     <p>The <a href="#embed" class="element">embed</a> element
-    represents an integration point for an external resource —
-    typically, a non-HTML resource such as an application or some
-    other type of interactive content which involves use of a
-    third-party plugin as a content handler (rather than being
-    natively supported by the UA).</p>
+    represents an integration point for an external resource.</p>
   </div>
   <div id="attributes">
     <dl>
@@ -27,4 +23,12 @@
       <dd>The height the embedded content, in CSS pixels.</dd>
     </dl>
   </div>
+  <div id="details">
+    <p>The <a href="#embed" class="element">embed</a> element
+    represents an integration point for an external resource —
+    typically, a non-HTML resource such as an application or some
+    other type of interactive content which involves use of a
+    third-party plugin as a content handler (rather than being
+    natively supported by the UA).</p>
+  </div>
 </div>

Index: noscript.html
===================================================================
RCS file: /sources/public/html5/markup/elements/noscript.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- noscript.html	15 Feb 2009 02:07:27 -0000	1.3
+++ noscript.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -4,7 +4,7 @@
   <div id="longdesc">
     <p>The <a href="#noscript" class="element">noscript</a>
     element is used to present different markup to user agents
-    that don't support scripting, by affecting how the document is
+    that don’t support scripting, by affecting how the document is
     parsed.</p>
   </div>
   <div id="constraints">

Index: object.html
===================================================================
RCS file: /sources/public/html5/markup/elements/object.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- object.html	7 Jun 2009 23:07:55 -0000	1.6
+++ object.html	29 Jul 2009 11:23:47 -0000	1.7
@@ -3,6 +3,10 @@
   <div id="shortdesc">generic external resource</div>
   <div id="longdesc">
     <p>The <a href="#object" class="element">object</a> element
+    represents an external resource.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#object" class="element">object</a> element
     represents an external resource, which, depending on the type
     of the resource, will either be treated as an image, as a
     nested browsing context, or as an external resource to be

Index: kbd.html
===================================================================
RCS file: /sources/public/html5/markup/elements/kbd.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- kbd.html	13 Feb 2009 12:07:30 -0000	1.3
+++ kbd.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -3,8 +3,11 @@
   <div id="shortdesc">user input</div>
   <div id="longdesc">
     <p>The <a href="#kbd" class="element">kbd</a> element
-    represents user input (typically keyboard input, although it
-    may also be used to represent other input, such as voice
-    commands).</p>
+    represents user input.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#kbd" class="element">kbd</a> element
+    typically represents keyboard input, though it may also
+    represent other input, such as voice commands.</p>
   </div>
 </div>

Index: dl.html
===================================================================
RCS file: /sources/public/html5/markup/elements/dl.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- dl.html	16 Jan 2009 09:31:17 -0000	1.3
+++ dl.html	29 Jul 2009 11:23:47 -0000	1.4
@@ -3,8 +3,16 @@
   <div id="shortdesc">description list</div>
   <div id="longdesc">
     <p>The <a href="#dl" class="element">dl</a> element represents
-    a <dfn id="description-list">description list</dfn>, which
-    consists of zero or more term-description (name-value)
+    a <a href="#description-list">description list</a>.</p>
+  </div>
+  <div id="details">
+    <p>The <a href="#dl" class="element">dl</a> element represents
+    a
+    <dfn
+      id="description-list"
+      title="description-list"
+      >description list</dfn>,
+    which consists of zero or more term-description (name-value)
     groupings; each grouping associates one or more terms/names
     (the contents of <a href="#dt" class="element">dt</a>
     elements) with one or more descriptions/values (the

Index: aside.html
===================================================================
RCS file: /sources/public/html5/markup/elements/aside.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- aside.html	8 Jan 2009 10:19:31 -0000	1.3
+++ aside.html	29 Jul 2009 11:23:46 -0000	1.4
@@ -4,8 +4,11 @@
   <div id="longdesc">
     <p>The <a href="#aside" class="element">aside</a> element
     represents content that is tangentially related to the content
-    that forms the main textual flow of a document. In printed
-    documents, such tangential content is sometimes formatted as a
-    sidebar or annotation or footnote.</p>
+    that forms the main textual flow of a document.</p>
+  </div>
+  <div id="details">
+    <p>In printed documents, the type of tangential content that
+    the <a href="#aside">aside</a> element represents is sometimes
+    formatted as a sidebar or annotation or footnote.</p>
   </div>
 </div>
Received on Wednesday, 29 July 2009 11:24:00 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 29 July 2009 11:24:08 GMT