CVS html5/html-polyglot

Update of /sources/public/html5/html-polyglot
In directory roscoe:/tmp/cvs-serv19302

Modified Files:
	html-polyglot.html 
Log Message:
Edits as recorded in bug 24451, comment 3

--- /sources/public/html5/html-polyglot/html-polyglot.html	2014/02/02 01:22:59	1.26
+++ /sources/public/html5/html-polyglot/html-polyglot.html	2014/02/03 22:35:14	1.27
@@ -263,8 +263,14 @@
         </li>
     </ul>
     <p class="note">
-        The string <code>html</code> SHOULD be in lowercase letters, in order to be both well-formed and valid XML;
-        however, the string MAY be in mixed case or uppercase letters and still be well-formed XML.
+        For valid XML the document element named in the document type declaration must exactly match the top-level element 
+        of the document, including in case.  
+        This rule is relaxed for well-formed, rather than valid, XML documents. 
+        Because XHTML requires a lower-case <code>html</code> element, Polyglot documents SHOULD use lower-case 
+        <code>html</code> for the element named in the DOCTYPE declaration.
+        Bear in mind that a customized XHTML DTD with element and entity declarations inside the document type definition 
+        subset within the document, or one that points to an alternate DTD, may have special case requirements.
+
     </p>
     <p>
         Note that using <code>about:legacy-compat</code> in XML may yield unpredictable parsing results, depending on the XML processing pipeline.
@@ -323,15 +329,15 @@
             <li><code>xlink:type</code></li>
         </ul>
         <p>
-            Note that there are other prefixed attributes that can be used beyond <code>xlink:href</code> (such as <code>xml:base</code>).
-            <a title="polyglot markup">Polyglot markup</a> does not declare these prefixes via <code>xmlns</code>. The prefixes are implicitly declared
+            The <code>xml:</code> namespace prefix used in <code>xml:base</code>, <code>xml:lang</code>, 
+            <code>xml:space</code>, and <code>xml:id</code> does not need to be declared in XML documents, and therefore 
+            <a>polyglot markup</a> does not declare these prefixes via <code>xmlns</code>. The prefixes are implicitly declared
             in XML and are automatically applied to the appropriate attributes in HTML.
+            See CSS namespaces [[!CSS3NAMESPACE]] how to use CSS selectors with these attributes.
         </p>
         <p>
-            The namespaced attributes, such as <code>xml:lang=""</code> and <code>xmlns=""</code>, are "namespaced" within XHTML, SVG and MathML.
-            Thus, the rules for how they can be used as CSS selectors is governed by CSS namespaces. [[!CSS3NAMESPACE]]
-            For more about the issues related to attribute selectors and namespaces, with and without prefixes, see the section on <a
-                href="#scripting-and-styling-polyglot-markup">Scripting and styling polyglot markup</a>.
+          For more about the issues related to attribute selectors and namespaces, with and without prefixes, see the section on <a
+          href="#scripting-and-styling-polyglot-markup">Scripting and styling polyglot markup</a>.
             </p>
 
             <!-- End section, "Attribute-Level Namespaces" -->

Received on Monday, 3 February 2014 22:35:14 UTC