W3C home > Mailing lists > Public > public-html-commits@w3.org > March 2011

html5/html-xhtml-author-guide html-xhtml-authoring-guide.html,1.72,1.73

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 18 Mar 2011 23:26:31 +0000
To: public-html-commits@w3.org
Message-Id: <E1Q0j3v-0000DJ-BS@lionel-hutz.w3.org>
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv799

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Made spec consistent in that all element names do not have angled brackets around them but are formatted by CSS. Also, changed crete --> create that was introduced in the last fix. :-P

Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -d -r1.72 -r1.73
--- html-xhtml-authoring-guide.html	18 Mar 2011 22:55:26 -0000	1.72
+++ html-xhtml-authoring-guide.html	18 Mar 2011 23:26:29 -0000	1.73
@@ -130,7 +130,7 @@
 								<li class="tocline"><a class="tocxref" href="#content=type"><span class="secno">6.5.1.2 </span>Content-Type</a></li>
 							</ul>
 						</li>
-						<li class="tocline"><a class="tocxref" href="#newlines-in-textarea-and-pre"><span class="secno">6.5.2 </span>Newlines in <code>&lt;textarea&gt;</code> and <code>&lt;pre&gt;</code> Elements</a></li>
+						<li class="tocline"><a class="tocxref" href="#newlines-in-textarea-and-pre"><span class="secno">6.5.2 </span>Newlines in <code>textarea</code> and <code>pre</code> Elements</a></li>
 					</ul>
 				</li>
 			</ul>
@@ -211,7 +211,7 @@
 	<p>
 		<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> is 
 		scripted according to the rules of XML (does not use <code>document.write</code>, for example) 
-		and excludes HTML elements that are impossible to replicate in an XML parser (does not use the <code>&lt;noscript&gt;</code> element, for example).
+		and excludes HTML elements that are impossible to replicate in an XML parser (does not use the <code>noscript</code> element, for example).
 		<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> triggers non-quirks mode in HTML parsers, 
 		as non-quirks mode is closest to XML-mode rendering, in regard to both DOM and CSS.
 		<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> results in 
@@ -319,8 +319,8 @@
 	<div id="element-level-namespaces" class="section">
 	<h3><span class="secno">5.1 </span>Element-Level Namespaces</h3>
 		<p>
-			[<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] introduces undeclared (native) default namespaces for the root HTML element <code>&lt;html&gt;</code>, the root SVG element <code>&lt;svg&gt;</code>, 
-			and the root MathML element <code>&lt;math&gt;</code>.
+			[<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] introduces undeclared (native) default namespaces for the root HTML element, <code>html</code>, the root SVG element, <code>svg</code>, 
+			and the root MathML element, <code>math</code>.
 			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a>
  declares the following default namespaces, when the markup languages 
 are included in the document, to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>]:
@@ -331,8 +331,8 @@
 			</ul>
 		<p></p>
 		<p>
-			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> declares the default namespaces on the root HTML element <code>&lt;html&gt;</code>, 
-			the root SVG element <code>&lt;svg&gt;</code>, and the root MathML element <code>&lt;math&gt;</code>, 
+			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> declares the default namespaces on the root HTML element, <code>html</code>, 
+			the root SVG element, <code>svg</code>, and the root MathML element <code>math</code>, 
 			and on any HTML elements used as children of SVG or MathML elements.  
 			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not declare any other default or prefixed element namespace, because 
 			[<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] does not natively support the declaring of any other default or prefixed element namespace. 
@@ -344,8 +344,8 @@
 	<h3><span class="secno">5.2 </span>Attribute-Level Namespaces</h3>
 		<p>
 			[<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] introduces undeclared (native) support for attributes in the XLink namespace and with the prefix <code>xlink:</code>. 
-			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> declares the XLink namespace on the HTML root element (<code>&lt;html&gt;</code>) or 
-			once on the foreign element where it is used (<code>&lt;svg&gt;</code> or <code>&lt;math&gt;</code>), to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
+			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> declares the XLink namespace on the HTML root element (<code>html</code>) or 
+			once on the foreign element where it is used (<code>svg</code> or <code>math</code>), to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
 		</p>
 		<p>In <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a>, the xlink prefix uses the namespace declaration <code>xmlns:xlink="http://www.w3.org/1999/xlink"</code>  before using the xlink prefix for the following attributes:
 			</p><ul>
@@ -357,7 +357,7 @@
 				<li><code>xlink:title</code></li>
 				<li><code>xlink:type</code></li>
 			</ul>
-			Furthermore, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> defines the xlink prefix only on foreign elements (any SVG or MathML element) but not the root <code>&lt;html&gt;</code> element or any other HTML element.
+			Furthermore, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> defines the xlink prefix only on foreign elements (any SVG or MathML element) but not the root <code>html</code> element or any other HTML element.
 		<p></p>
 		<p>
 			Note that there are other prefixed attributes that can be used beyond <code>xlink:href</code> (such as <code>xml:base</code>).
@@ -377,11 +377,11 @@
 	<h3><span class="secno">6.1 </span>Required Elements</h3>
 	
 		<p>
-			Every <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> document contains an <code>&lt;html&gt;</code>, <code>&lt;head&gt;</code>, <code>&lt;title&gt;</code>, 
-			and <code>&lt;body&gt;</code> element. 
-			The <code>&lt;html&gt;</code> element is the root element. 
-			The <code>&lt;head&gt;</code> and <code>&lt;body&gt;</code> elements are children of the <code>&lt;html&gt;</code> element.
-			The <code>&lt;title&gt;</code> element is a child of the <code>&lt;head&gt;</code> element.
+			Every <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> document contains an <code>html</code>, <code>head</code>, <code>title</code>, 
+			and <code>body</code> element. 
+			The <code>html</code> element is the root element. 
+			The <code>head</code> and <code>body</code> elements are children of the <code>html</code> element.
+			The <code>title</code> element is a child of the <code>head</code> element.
 			Therefore, the following source code would be the most basic <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> document.
 		</p>
 		<pre class="example">&lt;!DOCTYPE html&gt;
@@ -397,7 +397,7 @@
 			<code>tbody</code>, <code>thead</code>, or <code>tfoot</code> element. 
 			In HTML, if a group of one or more adjacent <code>tr</code> elements are not explictly wrapped inside a <code>tbody</code>, <code>thead</code>, or <code>tfoot</code> element, 
 			the HTML parser creates and wraps a new <code>tbody</code> element around the <code>tr</code> elements. 
-			XML parsers do not crete the <code>tbody</code> element, thus offering the potential for creating different DOMs.
+			XML parsers do not create the <code>tbody</code> element, thus offering the potential for creating different DOMs.
 		</p>
 		<p>
 			Correct:
@@ -429,8 +429,8 @@
 	<div id="elements-that-cannot-be-used" class="section">
 	<h3><span class="secno">6.2 </span>Elements that Cannot Be Used in Polyglot Markup</h3>
 		<p>
-			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not use the <code>&lt;noscript&gt;</code> element, because 
-			the <code>&lt;noscript&gt;</code> element cannot be used in XML documents. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not use the <code>noscript</code> element, because 
+			the <code>noscript</code> element cannot be used in XML documents. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
 		</p>
 	<!--End section: Elements that Cannot Be Used in Polyglot Markup-->
 	</div>
@@ -691,7 +691,7 @@
 			<h5><span class="secno">6.5.1.2 </span>Content-Type</h5>
 			<p>
 				The <code>HTTP Content-Type:</code> header has no extra rules or restrictions, 
-				whereas <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the <code>http-equiv="Content-Type"</code> declaration on the <code>&lt;meta&gt;</code> element.
+				whereas <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the <code>http-equiv="Content-Type"</code> declaration on the <code>meta</code> element.
 				For more specific information about using the <code>HTTP Content-Type:</code> header, see <a href="#character-encoding">Specifying a Document's Character Encoding</a>.
 			</p>
 			
@@ -703,8 +703,8 @@
 		</div>
 
 		<div id="newlines-in-textarea-and-pre" class="section">
-		<h4><span class="secno">6.5.2 </span>Newlines in <code>&lt;textarea&gt;</code> and <code>&lt;pre&gt;</code> Elements</h4>
-		When <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> uses either a <code>&lt;textarea&gt;</code> or <code>&lt;pre&gt;</code> element, 
+		<h4><span class="secno">6.5.2 </span>Newlines in <code>textarea</code> and <code>pre</code> Elements</h4>
+		When <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> uses either a <code>textarea</code> or <code>pre</code> element, 
 		the text within the element does not begin with a <a href="http://dev.w3.org/html5/spec/syntax.html#syntax-newlines">newline</a>.
 <!--End section: White Space in textarea and pre Elements-->	
 		</div>
@@ -773,11 +773,11 @@
 			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses the language attributes in the <code>html</code> element to set the default language for the document.
 		</p>
 		<p class="note">
-			Whenever either the <code>http-equiv="content-language"</code> attribute on the <code>&lt;meta&gt;</code> element 
+			Whenever either the <code>http-equiv="content-language"</code> attribute on the <code>meta</code> element 
 			or an HTTP Content-Language: header specifies the language of the root element, 
 			then <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> is required to specify the language mapping of the root element.
 			According to <a href="http://dev.w3.org/html5/spec/semantics.html#attr-meta-http-equiv-content-language">Content language state</a> in [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>], 
-			the <code>http-equiv="content-language"</code> attribute on the <code>&lt;meta&gt;</code> element specifices the language of the root element 
+			the <code>http-equiv="content-language"</code> attribute on the <code>meta</code> element specifices the language of the root element 
 			whenever its <code>content</code> attribute contains no more and no 
 less than exactly one language tag. 
 			Therefore, not specifying the language mapping of the root element 
@@ -878,7 +878,7 @@
 	  	</p>
 		<p>
 			Safe content is content that does not contain a <code>&lt;</code> or <code>&amp;</code> character. 
-			The following example is safe because it does not contain problematic characters within the <code>&lt;script&gt;</code> tag.
+			The following example is safe because it does not contain problematic characters within the <code>script</code> tag.
 	    </p>
 		<pre class="example">&lt;script&gt;document.body.appendChild(document.createElement("div"));&lt;/script&gt;</pre>
 
@@ -1057,7 +1057,6 @@
 
 
 
-
 <!-- Appendix -->
 <div id="acknowledgements" class="appendix section">
 <h2><span class="secno">A. </span>Acknowledgements</h2>
Received on Friday, 18 March 2011 23:26:32 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 18 March 2011 23:26:34 GMT