- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 29 Jul 2009 11:23:49 +0000
- To: public-html-commits@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 UTC