- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 18 Mar 2011 23:26:31 +0000
- To: public-html-commits@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><textarea></code> and <code><pre></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><noscript></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><html></code>, the root SVG element <code><svg></code>,
- and the root MathML element <code><math></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><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 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><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>].
+ <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><html></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><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.
+ 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"><!DOCTYPE html>
@@ -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><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>]
+ <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><meta></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><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,
+ <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><meta></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><meta></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><</code> or <code>&</code> character.
- The following example is safe because it does not contain problematic characters within the <code><script></code> tag.
+ The following example is safe because it does not contain problematic characters within the <code>script</code> tag.
</p>
<pre class="example"><script>document.body.appendChild(document.createElement("div"));</script></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 UTC