[html5] r4808 - [e] (0) Define the obsolete permitted DOCTYPEs in the syntax section. Fixing htt [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Feb 24 20:54:38 PST 2010


Author: ianh
Date: 2010-02-24 20:54:36 -0800 (Wed, 24 Feb 2010)
New Revision: 4808

Modified:
   complete.html
   index
   source
Log:
[e] (0) Define the obsolete permitted DOCTYPEs in the syntax section.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7616

Modified: complete.html
===================================================================
--- complete.html	2010-02-25 04:33:31 UTC (rev 4807)
+++ complete.html	2010-02-25 04:54:36 UTC (rev 4808)
@@ -70573,13 +70573,13 @@
    <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 (>).</li>
   </ol><p class=note>In other words, <code><!DOCTYPE HTML></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=""><!DOCTYPE
   HTML></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
@@ -70600,8 +70600,46 @@
   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 HTML 4.0//EN</code>
+     <td>
+    <tr><td> <code title="">-//W3C//DTD HTML 4.0//EN</code>
+     <td> <code title="">http://www.w3.org/TR/REC-html40/strict.dtd</code>
+    <tr><td> <code title="">-//W3C//DTD HTML 4.01//EN</code>
+     <td>
+    <tr><td> <code title="">-//W3C//DTD HTML 4.01//EN</code>
+     <td> <code title="">http://www.w3.org/TR/html4/strict.dtd</code>
+    <tr><td> <code title="">-//W3C//DTD XHTML 1.0 Strict//EN</code>
+     <td> <code title="">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</code>
+    <tr><td> <code title="">-//W3C//DTD XHTML 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>
 
   <p>There are five different kinds of <dfn id=syntax-elements title=syntax-elements>elements</dfn>: <a href=#void-elements>void elements</a>,
@@ -75032,9 +75070,7 @@
     <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>
@@ -83959,10 +83995,6 @@
   <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>
@@ -83995,6 +84027,9 @@
   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>

Modified: index
===================================================================
--- index	2010-02-25 04:33:31 UTC (rev 4807)
+++ index	2010-02-25 04:54:36 UTC (rev 4808)
@@ -64877,13 +64877,13 @@
    <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 (>).</li>
   </ol><p class=note>In other words, <code><!DOCTYPE HTML></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=""><!DOCTYPE
   HTML></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
@@ -64904,8 +64904,46 @@
   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 HTML 4.0//EN</code>
+     <td>
+    <tr><td> <code title="">-//W3C//DTD HTML 4.0//EN</code>
+     <td> <code title="">http://www.w3.org/TR/REC-html40/strict.dtd</code>
+    <tr><td> <code title="">-//W3C//DTD HTML 4.01//EN</code>
+     <td>
+    <tr><td> <code title="">-//W3C//DTD HTML 4.01//EN</code>
+     <td> <code title="">http://www.w3.org/TR/html4/strict.dtd</code>
+    <tr><td> <code title="">-//W3C//DTD XHTML 1.0 Strict//EN</code>
+     <td> <code title="">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</code>
+    <tr><td> <code title="">-//W3C//DTD XHTML 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>
 
   <p>There are five different kinds of <dfn id=syntax-elements title=syntax-elements>elements</dfn>: <a href=#void-elements>void elements</a>,
@@ -69336,9 +69374,7 @@
     <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>
@@ -78263,10 +78299,6 @@
   <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>
@@ -78299,6 +78331,9 @@
   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>

Modified: source
===================================================================
--- source	2010-02-25 04:33:31 UTC (rev 4807)
+++ source	2010-02-25 04:54:36 UTC (rev 4808)
@@ -80548,7 +80548,7 @@
    <li>A string that is an <span>ASCII case-insensitive</span> match for the string "<code title="">DOCTYPE</code>".</li>
    <li>One or more <span title="space character">space characters</span>.</li>
    <li>A string that is an <span>ASCII case-insensitive</span> match for the string "<code title="">HTML</code>".</li>
-   <li>Optionally, a <span>DOCTYPE legacy string</span> (defined below).</li>
+   <li>Optionally, a <span>DOCTYPE legacy string</span> or an <span>obsolete permitted DOCTYPE string</span> (defined below).</li>
    <li>Zero or more <span title="space character">space characters</span>.</li>
    <li>A U+003E GREATER-THAN SIGN character (>).</li>
   </ol>
@@ -80556,6 +80556,8 @@
   <p class="note">In other words, <code><!DOCTYPE HTML></code>,
   case-insensitively.</p>
 
+  <hr>
+
   <p>For the purposes of HTML generators that cannot output HTML
   markup with the short DOCTYPE "<code title=""><!DOCTYPE
   HTML></code>", a <dfn>DOCTYPE legacy string</dfn> may be inserted
@@ -80580,8 +80582,66 @@
   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>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 <span title="space character">space characters</span>.</li>
+   <li>A string that is an <span>ASCII case-insensitive</span> match for the string "<code title="">PUBLIC</code>".</li>
+   <li>One or more <span title="space character">space characters</span>.</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 <span title="space character">space characters</span>.</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 <span>obsolete permitted DOCTYPE string</span>.
+   </caption>
+   <thead>
+    <tr>
+     <th> Public identifier
+     <th> System identifier
+   <tbody>
+    <tr>
+     <td> <code title="">-//W3C//DTD HTML 4.0//EN</code>
+     <td>
+    <tr>
+     <td> <code title="">-//W3C//DTD HTML 4.0//EN</code>
+     <td> <code title="">http://www.w3.org/TR/REC-html40/strict.dtd</code>
+    <tr>
+     <td> <code title="">-//W3C//DTD HTML 4.01//EN</code>
+     <td>
+    <tr>
+     <td> <code title="">-//W3C//DTD HTML 4.01//EN</code>
+     <td> <code title="">http://www.w3.org/TR/html4/strict.dtd</code>
+    <tr>
+     <td> <code title="">-//W3C//DTD XHTML 1.0 Strict//EN</code>
+     <td> <code title="">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</code>
+    <tr>
+     <td> <code title="">-//W3C//DTD XHTML 1.1//EN</code>
+     <td> <code title="">http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd</code>
+  </table>
+
+  <p>A <span title="syntax-doctype">DOCTYPE</span> containing an
+  <span>obsolete permitted DOCTYPE string</span> is an <dfn>obsolete
+  permitted DOCTYPE</dfn>. Authors should not use <span
+  title="obsolete permitted DOCTYPE">obsolete permitted
+  DOCTYPEs</span>, as they are unnecessarily long.</p>
+
+
+
+
   <h4>Elements</h4>
 
   <p>There are five different kinds of <dfn
@@ -85696,9 +85756,7 @@
     <span>case-sensitive</span> match for the string
     "<code>about:legacy-compat</code>", and none of the sets of
     conditions in the following list are matched, then there is a
-    <span>parse error</span>. If one of the sets of conditions in the
-    following list is matched, then there is an <dfn>obsolete
-    permitted DOCTYPE</dfn>.</p>
+    <span>parse error</span>.</p>
 
     <ul>
 
@@ -93308,12 +93366,6 @@
   <p>Features listed in this section will trigger warnings in
   conformance checkers.</p>
 
-  <p>In <span>the HTML syntax</span>, authors should not specify <span
-  title="syntax-DOCTYPE">DOCTYPE</span>s that get parsed as <span
-  title="obsolete permitted DOCTYPE">obsolete permitted
-  DOCTYPEs</span>.</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">http-equiv</code> attribute in the
   <span title="attr-meta-http-equiv-content-language">Content
@@ -93355,6 +93407,10 @@
   title="URL">URLs</span>. The <code title="attr-id">id</code>
   attribute should be used instead.</p>
 
+  <p class="note">In <span>the HTML syntax</span>, specifying a <span
+  title="syntax-DOCTYPE">DOCTYPE</span> that is an <span>obsolete
+  permitted DOCTYPE</span> will also trigger a warning.</p>
+
   <p class="note">The <code title="attr-table-summary">summary</code>
   attribute, defined in the <code>table</code> section, will also
   trigger a warning.</p>




More information about the Commit-Watchers mailing list