[html5] r7622 - [c] (0) Be clearer about the content models of <option>, <textarea>, <title>. Fi [...]
whatwg at whatwg.org
whatwg at whatwg.org
Sun Dec 30 20:39:22 PST 2012
Author: ianh
Date: 2012-12-30 20:39:20 -0800 (Sun, 30 Dec 2012)
New Revision: 7622
Modified:
complete.html
index
source
Log:
[c] (0) Be clearer about the content models of <option>, <textarea>, <title>.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=20472
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2012-12-30 20:58:34 UTC (rev 7621)
+++ complete.html 2012-12-31 04:39:20 UTC (rev 7622)
@@ -248,7 +248,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 30 December 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 31 December 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -12103,13 +12103,11 @@
content can only contain elements that are themselves categorized as
phrasing content, not any flow content.</p>
- <p><dfn id=text-content title="text content">Text</dfn>, in the context of content
- models, means <code><a href=#text>Text</a></code> nodes. <a href=#text-content title="text
- content">Text</a> is sometimes used as a content model on its
- own, but is also <a href=#phrasing-content>phrasing content</a>, and can be
- <a href=#inter-element-whitespace>inter-element whitespace</a> (if the <code><a href=#text>Text</a></code>
- nodes are empty or contain just <a href=#space-character title="space character">space
- characters</a>).</p>
+ <p><dfn id=text-content title="text content">Text</dfn>, in the context of content models, means either nothing,
+ or <code><a href=#text>Text</a></code> nodes. <a href=#text-content title="text content">Text</a> is sometimes used as a content
+ model on its own, but is also <a href=#phrasing-content>phrasing content</a>, and can be <a href=#inter-element-whitespace>inter-element
+ whitespace</a> (if the <code><a href=#text>Text</a></code> nodes are empty or contain just <a href=#space-character title="space
+ character">space characters</a>).</p>
<p><code><a href=#text>Text</a></code> nodes and attribute values must consist of
<a href=#unicode-character title="Unicode character">Unicode characters</a>, must not
@@ -13932,6 +13930,12 @@
<p>There must be no more than one <code><a href=#the-title-element>title</a></code> element per
document.</p>
+ <p>The <code><a href=#the-title-element>title</a></code> element must not be empty.</p>
+
+ <p class=note>If it's reasonable for the <code><a href=#document>Document</a></code> to have no title, then the
+ <code><a href=#the-title-element>title</a></code> element is probably not required. See the <code><a href=#the-head-element>head</a></code> element's content
+ model for a description of when the element is required.</p>
+
<!--TOPIC:DOM APIs-->
<dl class=domintro><dt><var title="">title</var> . <code title=dom-title-text><a href=#dom-title-text>text</a></code> [ = <var title="">value</var> ]</dt>
@@ -52823,6 +52827,9 @@
element is the value of the <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if there
is one, or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL attribute.</p>
+ <p>The <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if specified, must not be
+ empty. If the attribute is not specified, then the element itself must not be empty.</p>
+
<p>The <dfn id=attr-option-value title=attr-option-value><code>value</code></dfn>
attribute provides a value for element. The <dfn id=concept-option-value title=concept-option-value>value</dfn> of an <code><a href=#the-option-element>option</a></code>
element is the value of the <code title=attr-option-value><a href=#attr-option-value>value</a></code> content attribute, if there
@@ -101705,7 +101712,7 @@
<td><code><a href=#the-select-element>select</a></code>;
<code><a href=#the-datalist-element>datalist</a></code>;
<code><a href=#the-optgroup-element>optgroup</a></code></td>
- <td><a href=#text-content title="text content">text</a></td>
+ <td><a href=#text-content title="text content">text</a>*</td>
<td><a href=#global-attributes title="global attributes">globals</a>;
<code title=attr-option-disabled><a href=#attr-option-disabled>disabled</a></code>;
<code title=attr-option-label><a href=#attr-option-label>label</a></code>;
@@ -102020,7 +102027,7 @@
<td>Document title</td>
<td><a href=#metadata-content title="Metadata content">metadata</a></td>
<td><code><a href=#the-head-element>head</a></code></td>
- <td><a href=#text-content title="text content">text</a></td>
+ <td><a href=#text-content title="text content">text</a>*</td>
<td><a href=#global-attributes title="global attributes">globals</a></td>
<td><code><a href=#htmltitleelement>HTMLTitleElement</a></code></td>
<tr><th><code><a href=#the-tr-element>tr</a></code></th>
Modified: index
===================================================================
--- index 2012-12-30 20:58:34 UTC (rev 7621)
+++ index 2012-12-31 04:39:20 UTC (rev 7622)
@@ -248,7 +248,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 30 December 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 31 December 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -12103,13 +12103,11 @@
content can only contain elements that are themselves categorized as
phrasing content, not any flow content.</p>
- <p><dfn id=text-content title="text content">Text</dfn>, in the context of content
- models, means <code><a href=#text>Text</a></code> nodes. <a href=#text-content title="text
- content">Text</a> is sometimes used as a content model on its
- own, but is also <a href=#phrasing-content>phrasing content</a>, and can be
- <a href=#inter-element-whitespace>inter-element whitespace</a> (if the <code><a href=#text>Text</a></code>
- nodes are empty or contain just <a href=#space-character title="space character">space
- characters</a>).</p>
+ <p><dfn id=text-content title="text content">Text</dfn>, in the context of content models, means either nothing,
+ or <code><a href=#text>Text</a></code> nodes. <a href=#text-content title="text content">Text</a> is sometimes used as a content
+ model on its own, but is also <a href=#phrasing-content>phrasing content</a>, and can be <a href=#inter-element-whitespace>inter-element
+ whitespace</a> (if the <code><a href=#text>Text</a></code> nodes are empty or contain just <a href=#space-character title="space
+ character">space characters</a>).</p>
<p><code><a href=#text>Text</a></code> nodes and attribute values must consist of
<a href=#unicode-character title="Unicode character">Unicode characters</a>, must not
@@ -13932,6 +13930,12 @@
<p>There must be no more than one <code><a href=#the-title-element>title</a></code> element per
document.</p>
+ <p>The <code><a href=#the-title-element>title</a></code> element must not be empty.</p>
+
+ <p class=note>If it's reasonable for the <code><a href=#document>Document</a></code> to have no title, then the
+ <code><a href=#the-title-element>title</a></code> element is probably not required. See the <code><a href=#the-head-element>head</a></code> element's content
+ model for a description of when the element is required.</p>
+
<!--TOPIC:DOM APIs-->
<dl class=domintro><dt><var title="">title</var> . <code title=dom-title-text><a href=#dom-title-text>text</a></code> [ = <var title="">value</var> ]</dt>
@@ -52823,6 +52827,9 @@
element is the value of the <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if there
is one, or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL attribute.</p>
+ <p>The <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if specified, must not be
+ empty. If the attribute is not specified, then the element itself must not be empty.</p>
+
<p>The <dfn id=attr-option-value title=attr-option-value><code>value</code></dfn>
attribute provides a value for element. The <dfn id=concept-option-value title=concept-option-value>value</dfn> of an <code><a href=#the-option-element>option</a></code>
element is the value of the <code title=attr-option-value><a href=#attr-option-value>value</a></code> content attribute, if there
@@ -101705,7 +101712,7 @@
<td><code><a href=#the-select-element>select</a></code>;
<code><a href=#the-datalist-element>datalist</a></code>;
<code><a href=#the-optgroup-element>optgroup</a></code></td>
- <td><a href=#text-content title="text content">text</a></td>
+ <td><a href=#text-content title="text content">text</a>*</td>
<td><a href=#global-attributes title="global attributes">globals</a>;
<code title=attr-option-disabled><a href=#attr-option-disabled>disabled</a></code>;
<code title=attr-option-label><a href=#attr-option-label>label</a></code>;
@@ -102020,7 +102027,7 @@
<td>Document title</td>
<td><a href=#metadata-content title="Metadata content">metadata</a></td>
<td><code><a href=#the-head-element>head</a></code></td>
- <td><a href=#text-content title="text content">text</a></td>
+ <td><a href=#text-content title="text content">text</a>*</td>
<td><a href=#global-attributes title="global attributes">globals</a></td>
<td><code><a href=#htmltitleelement>HTMLTitleElement</a></code></td>
<tr><th><code><a href=#the-tr-element>tr</a></code></th>
Modified: source
===================================================================
--- source 2012-12-30 20:58:34 UTC (rev 7621)
+++ source 2012-12-31 04:39:20 UTC (rev 7622)
@@ -12389,13 +12389,11 @@
content can only contain elements that are themselves categorized as
phrasing content, not any flow content.</p>
- <p><dfn title="text content">Text</dfn>, in the context of content
- models, means <code>Text</code> nodes. <span title="text
- content">Text</span> is sometimes used as a content model on its
- own, but is also <span>phrasing content</span>, and can be
- <span>inter-element whitespace</span> (if the <code>Text</code>
- nodes are empty or contain just <span title="space character">space
- characters</span>).</p>
+ <p><dfn title="text content">Text</dfn>, in the context of content models, means either nothing,
+ or <code>Text</code> nodes. <span title="text content">Text</span> is sometimes used as a content
+ model on its own, but is also <span>phrasing content</span>, and can be <span>inter-element
+ whitespace</span> (if the <code>Text</code> nodes are empty or contain just <span title="space
+ character">space characters</span>).</p>
<p><code>Text</code> nodes and attribute values must consist of
<span title="Unicode character">Unicode characters</span>, must not
@@ -14464,6 +14462,12 @@
<p>There must be no more than one <code>title</code> element per
document.</p>
+ <p>The <code>title</code> element must not be empty.</p>
+
+ <p class="note">If it's reasonable for the <code>Document</code> to have no title, then the
+ <code>title</code> element is probably not required. See the <code>head</code> element's content
+ model for a description of when the element is required.</p>
+
<!--TOPIC:DOM APIs-->
<dl class="domintro">
@@ -61616,6 +61620,9 @@
is one, or, if there is not, the value of the element's <code
title="dom-option-text">text</code> IDL attribute.</p>
+ <p>The <code title="attr-option-label">label</code> content attribute, if specified, must not be
+ empty. If the attribute is not specified, then the element itself must not be empty.</p>
+
<p>The <dfn title="attr-option-value"><code>value</code></dfn>
attribute provides a value for element. The <dfn
title="concept-option-value">value</dfn> of an <code>option</code>
@@ -118965,7 +118972,7 @@
<td><code>select</code>;
<code>datalist</code>;
<code>optgroup</code></td>
- <td><span title="text content">text</span></td>
+ <td><span title="text content">text</span>*</td>
<td><span title="global attributes">globals</span>;
<code title="attr-option-disabled">disabled</code>;
<code title="attr-option-label">label</code>;
@@ -119373,7 +119380,7 @@
<td>Document title</td>
<td><span title="Metadata content">metadata</span></td>
<td><code>head</code></td>
- <td><span title="text content">text</span></td>
+ <td><span title="text content">text</span>*</td>
<td><span title="global attributes">globals</span></td>
<td><code>HTMLTitleElement</code></td>
</tr>
More information about the Commit-Watchers
mailing list