Skip to content

Commit

Permalink
[e] (0) Define the obsolete permitted DOCTYPEs in the syntax section.
Browse files Browse the repository at this point in the history 
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7616

git-svn-id: http://svn.whatwg.org/webapps@4808 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Feb 25, 2010
1 parent 88c40dc commit 26a889c
Show file tree
Hide file tree
Showing 3 changed files with 154 additions and 28 deletions.
53 changes: 44 additions & 9 deletions complete.html
View file
Expand Up @@ -70573,13 +70573,13 @@ <h4 id=the-doctype><span class=secno>12.1.1 </span>The DOCTYPE</h4>
<li>A string that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the string "<code title="">DOCTYPE</code>".</li>
<li>One or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A string that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the string "<code title="">HTML</code>".</li>
<li>Optionally, a <a href=#doctype-legacy-string>DOCTYPE legacy string</a> (defined below).</li>
<li>Optionally, a <a href=#doctype-legacy-string>DOCTYPE legacy string</a> or an <a href=#obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</a> (defined below).</li>
<li>Zero or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A U+003E GREATER-THAN SIGN character (&gt;).</li>
</ol><p class=note>In other words, <code>&lt;!DOCTYPE HTML&gt;</code>,
case-insensitively.</p>

<p>For the purposes of HTML generators that cannot output HTML
<hr><p>For the purposes of HTML generators that cannot output HTML
markup with the short DOCTYPE "<code title="">&lt;!DOCTYPE
HTML&gt;</code>", a <dfn id=doctype-legacy-string>DOCTYPE legacy string</dfn> may be inserted
into the DOCTYPE (in the position defined above). This string must
Expand All @@ -70600,6 +70600,44 @@ <h4 id=the-doctype><span class=secno>12.1.1 </span>The DOCTYPE</h4>
the document is generated from a system that cannot output the
shorter string.</p>

<hr><!-- see the parser section before changing this bit --><p>To help authors transition from HTML4 and XHTML1, an
<dfn id=obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</dfn> can be inserted into
the DOCTYPE (in the position defined above). This string must
consist of:</p>

<ol class=brief><li>One or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A string that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the string "<code title="">PUBLIC</code>".</li>
<li>One or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (the <i>first quote mark</i>).</li>
<li>The string from one of the cells in the first column of the table below. The row to which this cell belongs is the <i>selected row</i>.</li>
<li>A matching U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (i.e. the same character as in the earlier step labeled <i>first quote mark</i>).</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, one or more <a href=#space-character title="space character">space characters</a>.</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, a U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (the <i>third quote mark</i>).</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, the string from the cell in the second column of the <i>selected row</i>.</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, a matching U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (i.e. the same character as in the earlier step labeled <i>third quote mark</i>).</li>
</ol><table><caption>
Allowed values for public and system identifiers in an <a href=#obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</a>.
</caption>
<thead><tr><th> Public identifier
<th> System identifier
<tbody><tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.0//EN</code>
<td>
<tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.0//EN</code>
<td> <code title="">http://www.w3.org/TR/REC-html40/strict.dtd</code>
<tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.01//EN</code>
<td>
<tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.01//EN</code>
<td> <code title="">http://www.w3.org/TR/html4/strict.dtd</code>
<tr><td> <code title="">-//W3C//DTD&nbsp;XHTML&nbsp;1.0&nbsp;Strict//EN</code>
<td> <code title="">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</code>
<tr><td> <code title="">-//W3C//DTD&nbsp;XHTML&nbsp;1.1//EN</code>
<td> <code title="">http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd</code>
</table><p>A <a href=#syntax-doctype title=syntax-doctype>DOCTYPE</a> containing an
<a href=#obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</a> is an <dfn id=obsolete-permitted-doctype>obsolete
permitted DOCTYPE</dfn>. Authors should not use <a href=#obsolete-permitted-doctype title="obsolete permitted DOCTYPE">obsolete permitted
DOCTYPEs</a>, as they are unnecessarily long.</p>




<h4 id=elements-0><span class=secno>12.1.2 </span>Elements</h4>
Expand Down Expand Up @@ -75032,9 +75070,7 @@ <h5 id=the-initial-insertion-mode><span class=secno>12.2.5.4 </span>The "<dfn ti
<a href=#case-sensitive>case-sensitive</a> match for the string
"<code><a href=#about:legacy-compat>about:legacy-compat</a></code>", and none of the sets of
conditions in the following list are matched, then there is a
<a href=#parse-error>parse error</a>. If one of the sets of conditions in the
following list is matched, then there is an <dfn id=obsolete-permitted-doctype>obsolete
permitted DOCTYPE</dfn>.</p>
<a href=#parse-error>parse error</a>.</p>

<ul><!-- only things that trigger no-quirks mode and were valid in
some other spec are allowed in this list --><li>The DOCTYPE token's name is a <a href=#case-sensitive>case-sensitive</a>
Expand Down Expand Up @@ -83959,10 +83995,6 @@ <h3 id=obsolete-but-conforming-features><span class=secno>15.1 </span>Obsolete b
<p>Features listed in this section will trigger warnings in
conformance checkers.</p>

<p>In <a href=#syntax>the HTML syntax</a>, authors should not specify <a href=#syntax-doctype title=syntax-DOCTYPE>DOCTYPE</a>s that get parsed as <a href=#obsolete-permitted-doctype title="obsolete permitted DOCTYPE">obsolete permitted
DOCTYPEs</a>.</p><!-- this is poor form; we really should define
this in the syntax section somehow -->

<p>Authors should not specify an <code title=attr-meta-http-equiv><a href=#attr-meta-http-equiv>http-equiv</a></code> attribute in the
<a href=#attr-meta-http-equiv-content-language title=attr-meta-http-equiv-content-language>Content
Language</a> state on a <code><a href=#meta>meta</a></code> element. The <code title=attr-lang><a href=#attr-lang>lang</a></code> attribute should be used instead.</p>
Expand Down Expand Up @@ -83995,6 +84027,9 @@ <h3 id=obsolete-but-conforming-features><span class=secno>15.1 </span>Obsolete b
way to specify possible targets for fragment identifiers in <a href=#url title=URL>URLs</a>. The <code title=attr-id><a href=#the-id-attribute>id</a></code>
attribute should be used instead.</p>

<p class=note>In <a href=#syntax>the HTML syntax</a>, specifying a <a href=#syntax-doctype title=syntax-DOCTYPE>DOCTYPE</a> that is an <a href=#obsolete-permitted-doctype>obsolete
permitted DOCTYPE</a> will also trigger a warning.</p>

<p class=note>The <code title=attr-table-summary><a href=#attr-table-summary>summary</a></code>
attribute, defined in the <code><a href=#the-table-element>table</a></code> section, will also
trigger a warning.</p>
Expand Down
53 changes: 44 additions & 9 deletions index
View file
Expand Up @@ -64877,13 +64877,13 @@ interface <dfn id=messageport>MessagePort</dfn> {
<li>A string that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the string "<code title="">DOCTYPE</code>".</li>
<li>One or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A string that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the string "<code title="">HTML</code>".</li>
<li>Optionally, a <a href=#doctype-legacy-string>DOCTYPE legacy string</a> (defined below).</li>
<li>Optionally, a <a href=#doctype-legacy-string>DOCTYPE legacy string</a> or an <a href=#obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</a> (defined below).</li>
<li>Zero or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A U+003E GREATER-THAN SIGN character (&gt;).</li>
</ol><p class=note>In other words, <code>&lt;!DOCTYPE HTML&gt;</code>,
case-insensitively.</p>

<p>For the purposes of HTML generators that cannot output HTML
<hr><p>For the purposes of HTML generators that cannot output HTML
markup with the short DOCTYPE "<code title="">&lt;!DOCTYPE
HTML&gt;</code>", a <dfn id=doctype-legacy-string>DOCTYPE legacy string</dfn> may be inserted
into the DOCTYPE (in the position defined above). This string must
Expand All @@ -64904,6 +64904,44 @@ interface <dfn id=messageport>MessagePort</dfn> {
the document is generated from a system that cannot output the
shorter string.</p>

<hr><!-- see the parser section before changing this bit --><p>To help authors transition from HTML4 and XHTML1, an
<dfn id=obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</dfn> can be inserted into
the DOCTYPE (in the position defined above). This string must
consist of:</p>

<ol class=brief><li>One or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A string that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the string "<code title="">PUBLIC</code>".</li>
<li>One or more <a href=#space-character title="space character">space characters</a>.</li>
<li>A U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (the <i>first quote mark</i>).</li>
<li>The string from one of the cells in the first column of the table below. The row to which this cell belongs is the <i>selected row</i>.</li>
<li>A matching U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (i.e. the same character as in the earlier step labeled <i>first quote mark</i>).</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, one or more <a href=#space-character title="space character">space characters</a>.</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, a U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (the <i>third quote mark</i>).</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, the string from the cell in the second column of the <i>selected row</i>.</li>
<li>If the cell in the second column of the <i>selected row</i> is not blank, a matching U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (i.e. the same character as in the earlier step labeled <i>third quote mark</i>).</li>
</ol><table><caption>
Allowed values for public and system identifiers in an <a href=#obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</a>.
</caption>
<thead><tr><th> Public identifier
<th> System identifier
<tbody><tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.0//EN</code>
<td>
<tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.0//EN</code>
<td> <code title="">http://www.w3.org/TR/REC-html40/strict.dtd</code>
<tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.01//EN</code>
<td>
<tr><td> <code title="">-//W3C//DTD&nbsp;HTML&nbsp;4.01//EN</code>
<td> <code title="">http://www.w3.org/TR/html4/strict.dtd</code>
<tr><td> <code title="">-//W3C//DTD&nbsp;XHTML&nbsp;1.0&nbsp;Strict//EN</code>
<td> <code title="">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</code>
<tr><td> <code title="">-//W3C//DTD&nbsp;XHTML&nbsp;1.1//EN</code>
<td> <code title="">http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd</code>
</table><p>A <a href=#syntax-doctype title=syntax-doctype>DOCTYPE</a> containing an
<a href=#obsolete-permitted-doctype-string>obsolete permitted DOCTYPE string</a> is an <dfn id=obsolete-permitted-doctype>obsolete
permitted DOCTYPE</dfn>. Authors should not use <a href=#obsolete-permitted-doctype title="obsolete permitted DOCTYPE">obsolete permitted
DOCTYPEs</a>, as they are unnecessarily long.</p>




<h4 id=elements-0><span class=secno>10.1.2 </span>Elements</h4>
Expand Down Expand Up @@ -69336,9 +69374,7 @@ document.body.appendChild(text);
<a href=#case-sensitive>case-sensitive</a> match for the string
"<code><a href=#about:legacy-compat>about:legacy-compat</a></code>", and none of the sets of
conditions in the following list are matched, then there is a
<a href=#parse-error>parse error</a>. If one of the sets of conditions in the
following list is matched, then there is an <dfn id=obsolete-permitted-doctype>obsolete
permitted DOCTYPE</dfn>.</p>
<a href=#parse-error>parse error</a>.</p>

<ul><!-- only things that trigger no-quirks mode and were valid in
some other spec are allowed in this list --><li>The DOCTYPE token's name is a <a href=#case-sensitive>case-sensitive</a>
Expand Down Expand Up @@ -78263,10 +78299,6 @@ time:empty { binding: <i title="">time</i>; }</pre>
<p>Features listed in this section will trigger warnings in
conformance checkers.</p>

<p>In <a href=#syntax>the HTML syntax</a>, authors should not specify <a href=#syntax-doctype title=syntax-DOCTYPE>DOCTYPE</a>s that get parsed as <a href=#obsolete-permitted-doctype title="obsolete permitted DOCTYPE">obsolete permitted
DOCTYPEs</a>.</p><!-- this is poor form; we really should define
this in the syntax section somehow -->

<p>Authors should not specify an <code title=attr-meta-http-equiv><a href=#attr-meta-http-equiv>http-equiv</a></code> attribute in the
<a href=#attr-meta-http-equiv-content-language title=attr-meta-http-equiv-content-language>Content
Language</a> state on a <code><a href=#meta>meta</a></code> element. The <code title=attr-lang><a href=#attr-lang>lang</a></code> attribute should be used instead.</p>
Expand Down Expand Up @@ -78299,6 +78331,9 @@ time:empty { binding: <i title="">time</i>; }</pre>
way to specify possible targets for fragment identifiers in <a href=#url title=URL>URLs</a>. The <code title=attr-id><a href=#the-id-attribute>id</a></code>
attribute should be used instead.</p>

<p class=note>In <a href=#syntax>the HTML syntax</a>, specifying a <a href=#syntax-doctype title=syntax-DOCTYPE>DOCTYPE</a> that is an <a href=#obsolete-permitted-doctype>obsolete
permitted DOCTYPE</a> will also trigger a warning.</p>

<p class=note>The <code title=attr-table-summary><a href=#attr-table-summary>summary</a></code>
attribute, defined in the <code><a href=#the-table-element>table</a></code> section, will also
trigger a warning.</p>
Expand Down

0 comments on commit 26a889c

Please sign in to comment.