Skip to content

Commit

Permalink
[e] (0) Revamp how the spec refers to 'HTML5', 'XHTML', etc.
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@3238 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jun 12, 2009
1 parent 53f640d commit d378809
Show file tree
Hide file tree
Showing 2 changed files with 167 additions and 158 deletions.
159 changes: 82 additions & 77 deletions index
View file
Expand Up @@ -903,7 +903,7 @@
<li><a href=#ports-and-garbage-collection><span class=secno>8.3.3.1 </span>Ports and garbage collection</a></ol></ol></ol></li>
<li><a href=#syntax><span class=secno>9 </span>The HTML syntax</a>
<ol>
<li><a href=#writing-html-documents><span class=secno>9.1 </span>Writing HTML documents</a>
<li><a href=#writing><span class=secno>9.1 </span>Writing HTML documents</a>
<ol>
<li><a href=#the-doctype><span class=secno>9.1.1 </span>The DOCTYPE</a></li>
<li><a href=#elements-0><span class=secno>9.1.2 </span>Elements</a>
Expand Down Expand Up @@ -1168,8 +1168,8 @@

<p><em>This section is non-normative.</em></p>

<p>Work on HTML5 originally started in late 2003, as a proof of
concept to show that it was possible to extend HTML4's forms to
<p>Work on HTML&nbsp;5 originally started in late 2003, as a proof
of concept to show that it was possible to extend HTML4's forms to
provide many of the features that XForms 1.0 introduced, without
requiring browsers to implement rendering engines that were
incompatible with existing HTML Web pages. At this early stage,
Expand All @@ -1192,10 +1192,10 @@

<p>In 2006, the W3C expressed interest in the specification, and
created a working group chartered to work with the WHATWG on the
development of the HTML5 specifications. The working group opened in
2007. Apple, Mozilla, and Opera allowed the W3C to publish the
specifications under the W3C copyright, while keeping versions with
the less restrictive license on the WHATWG site.</p>
development of the HTML&nbsp;5 specifications. The working group
opened in 2007. Apple, Mozilla, and Opera allowed the W3C to publish
the specifications under the W3C copyright, while keeping versions
with the less restrictive license on the WHATWG site.</p>

<p>Since then, both groups have been working together.</p>

Expand Down Expand Up @@ -1244,12 +1244,13 @@

<p><em>This section is non-normative.</em></p>

<p>HTML5 interacts with and relies on a wide variety of other
specifications. In certain circumstances, unfortunately, the desire
to be compatible with legacy content has led to HTML5 violating the
requirements of these other specifications. Whenever this has
occured, the transgressions have been noted as "<dfn id=willful-violation title="willful
violation">willful violations</dfn>".</p>
<p>This specification interacts with and relies on a wide variety of
other specifications. In certain circumstances, unfortunately, the
desire to be compatible with legacy content has led to this
specification violating the requirements of these other
specifications. Whenever this has occured, the transgressions have
been noted as "<dfn id=willful-violation title="willful violation">willful
violations</dfn>".</p>



Expand Down Expand Up @@ -1492,17 +1493,12 @@
properties. When these are ambiguous they are qualified as <dfn title="">object properties</dfn> and <dfn title="">CSS properties</dfn>
respectively.</p>

<p>The term <a href=#html-documents>HTML documents</a> is sometimes used in
contrast with <a href=#xml-documents>XML documents</a> to specifically mean
documents that were parsed using an <a href=#html-parser>HTML parser</a> (as
opposed to using an <a href=#xml-parser>XML parser</a> or created purely
through the DOM).</p>

<p>Generally, when the specification states that a feature applies
to HTML or XHTML, it also includes the other. When a feature
specifically only applies to one of the two languages, it is called
out by explicitly stating that it does not apply to the other
format, as in "for HTML, ... (this does not apply to XHTML)".</p>
to <a href=#syntax>the HTML syntax</a> or <a href=#the-xhtml-syntax>the XHTML syntax</a>, it
also includes the other. When a feature specifically only applies to
one of the two languages, it is called out by explicitly stating
that it does not apply to the other format, as in "for HTML,
... (this does not apply to XHTML)".</p>

<p>This specification uses the term <dfn title="">document</dfn> to
refer to any use of HTML, ranging from short static documents to
Expand Down Expand Up @@ -1721,11 +1717,12 @@

<dd>

<p>Web browsers that support <a href=#xhtml5>XHTML</a> must process
elements and attributes from the <a href=#html-namespace-0>HTML namespace</a> found
in <a href=#xml-documents>XML documents</a> as described in this specification,
so that users can interact with them, unless the semantics of
those elements have been overridden by other specifications.</p>
<p>Web browsers that support <a href=#the-xhtml-syntax>the XHTML syntax</a> must
process elements and attributes from the <a href=#html-namespace-0>HTML
namespace</a> found in XML documents as described in this
specification, so that users can interact with them, unless the
semantics of those elements have been overridden by other
specifications.</p>

<p class=example>A conforming XHTML processor would, upon
finding an XHTML <code><a href=#script>script</a></code> element in an XML document,
Expand All @@ -1735,7 +1732,7 @@
would instead treat the <code><a href=#script>script</a></code> element as an opaque
element that forms part of the transform.</p>

<p>Web browsers that support <a href=#html5 title=HTML5>HTML</a> must
<p>Web browsers that support <a href=#syntax>the HTML syntax</a> must
process documents labeled as <code>text/html</code> as described
in this specification, so that users can interact with them.</p>

Expand Down Expand Up @@ -1938,23 +1935,22 @@

<p>For compatibility with existing content and prior specifications,
this specification describes two authoring formats: one based on XML
(referred to as <dfn id=xhtml5 title=XHTML>XHTML5</dfn>), and
one using a <a href=#parsing>custom format</a> inspired by SGML
(referred to as <dfn id=html5>HTML5</dfn>). <span class=impl>Implementations may support only one of these two
formats, although supporting both is encouraged.</span></p>

<p id=authors-using-xhtml><a href=#xhtml5>XHTML</a> documents (<a href=#xml-documents>XML
documents</a> using elements from the <a href=#html-namespace-0>HTML
namespace</a>) that use the new features described in this
specification and that are served over the wire (e.g. by HTTP) must
be sent using an XML MIME type such as <code>application/xml</code>
or <code>application/xhtml+xml</code> and must not be served as
(referred to as <a href=#the-xhtml-syntax>the XHTML syntax</a>), and one using a <a href=#writing>custom format</a> inspired by SGML (referred to as
<a href=#syntax>the HTML syntax</a>). <span class=impl>Implementations
may support only one of these two formats, although supporting both
is encouraged.</span></p>

<p id=authors-using-xhtml>XML documents that use elements or
attributes from the <a href=#html-namespace-0>HTML namespace</a> and that are served
over the wire (e.g. by HTTP) must be sent using an XML MIME type
such as <code>application/xml</code> or
<code>application/xhtml+xml</code> and must not be served as
<code>text/html</code>. <a href=#refsRFC3023>[RFC3023]</a></p>

<p id=authors-using-html><a href=#html5 title=HTML5>HTML
documents</a>, if they are served over the wire (e.g. by HTTP)
must be labeled with the <code>text/html</code> MIME type.</p> <!--
XXX update RFC 2854 -->
<p id=authors-using-html>Documents that use <a href=#syntax>the HTML
syntax</a>, if they are served over the wire (e.g. by HTTP) must
be labeled with the <code>text/html</code> MIME type.</p> <!-- XXX
update RFC 2854 -->

<p class=impl id=entity-references>The language in this
specification assumes that the user agent expands all entity
Expand All @@ -1981,9 +1977,10 @@

<dd>

<p>Implementations that support XHTML5 must support some version
of XML, as well as its corresponding namespaces specification,
because XHTML5 uses an XML serialization with namespaces. <a href=#refsXML>[XML]</a> <a href=#refsXMLNAMES>[XMLNAMES]</a></p>
<p>Implementations that support <a href=#the-xhtml-syntax>the XHTML syntax</a> must
support some version of XML, as well as its corresponding
namespaces specification, because that syntax uses an XML
serialization with namespaces. <a href=#refsXML>[XML]</a> <a href=#refsXMLNAMES>[XMLNAMES]</a></p>

</dd>

Expand Down Expand Up @@ -2279,10 +2276,10 @@

<h4 id=boolean-attributes><span class=secno>2.4.2 </span>Boolean attributes</h4>

<p>A number of attributes in HTML5 are <dfn id=boolean-attribute title="boolean
attribute">boolean attributes</dfn>. The presence of a boolean
attribute on an element represents the true value, and the absence
of the attribute represents the false value.</p>
<p>A number of attributes are <dfn id=boolean-attribute title="boolean attribute">boolean
attributes</dfn>. The presence of a boolean attribute on an element
represents the true value, and the absence of the attribute
represents the false value.</p>

<p>If the attribute is present, its value must either be the empty
string or a value that is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a>
Expand Down Expand Up @@ -2795,7 +2792,7 @@

<div class=impl>
<h5 id=percentages-and-dimensions><span class=secno>2.4.4.5 </span>Percentages and lengths</h5>
<!--(percentages are not used in valid html5)
<!--(percentages are not used in valid html anymore)
<p>A string is a <dfn>valid dimension value</dfn> if it consists of
a character in the range U+0031 DIGIT ONE (1) to U+0039 DIGIT NINE
(9), optionally followed by zero of more characters in the range
Expand Down Expand Up @@ -10186,7 +10183,7 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0
<p>The <dfn id=attr-meta-charset title=attr-meta-charset><code>charset</code></dfn>
attribute specifies the character encoding used by the
document. This is a <a href=#character-encoding-declaration>character encoding declaration</a>. If
the attribute is present in an <a href=#xhtml5 title=XHTML>XML
the attribute is present in an <a href=#xml-documents title="XML documents">XML
document</a>, its value must be an <a href=#ascii-case-insensitive>ASCII
case-insensitive</a> match for the string "<code title="">UTF-8</code>" (and the document is therefore required to
use UTF-8 as its encoding).</p>
Expand Down Expand Up @@ -10511,9 +10508,9 @@ people expect to have work and what is necessary.
<code><a href=#meta>meta</a></code> element with the <code title=attr-meta-charset><a href=#attr-meta-charset>charset</a></code> attribute present.</p>

<p>The <a href=#attr-meta-http-equiv-content-type title=attr-meta-http-equiv-content-type>Encoding
declaration state</a> may be used in <a href=#html5 title=HTML5>HTML
documents</a> only, elements in that state must not be used in
<a href=#xhtml5 title=XHTML>XML documents</a>.</p>
declaration state</a> may be used in <a href=#html-documents>HTML
documents</a>, but elements in that state must not be used in
<a href=#xml-documents>XML documents</a>.</p>

</dd>

Expand Down Expand Up @@ -14764,7 +14761,7 @@ Web.&lt;/p&gt;</pre>
use the <code><a href=#the-abbr-element>abbr</a></code> element.</p>
<pre>&lt;p&gt;The
&lt;abbr title="Web Hypertext Application Technology Working Group"&gt;WHATWG&lt;/abbr&gt;
started working on HTML5 in 2004.&lt;/p&gt;</pre>
started working on HTML&nbsp;5 in 2004.&lt;/p&gt;</pre>
</div>

<div class=example>
Expand Down Expand Up @@ -16057,7 +16054,7 @@ brighter. A &lt;b&gt;rat&lt;/b&gt; scurries past the corner wall.&lt;/p&gt;</pre
in marking up the lede (or lead) sentence or paragraph. The
following example shows how a <a href=http://news.bbc.co.uk/2/hi/uk_news/scotland/north_east/7101506.stm>BBC
article about kittens adopting a rabbit as their own</a> could be
marked up using HTML5 elements:</p>
marked up:</p>
<pre>&lt;article&gt;
&lt;h2&gt;Kittens 'adopted' by pet rabbit&lt;/h2&gt;
&lt;p&gt;&lt;b&gt;Six abandoned kittens have found an unexpected new
Expand Down Expand Up @@ -42752,7 +42749,7 @@ document.body.appendChild(outer);</pre>
var stamp = new Date();
var stampString = '' + stamp.getUTCFullYear() + (stamp.getUTCMonth() + 1) + stamp.getUTCDate() + 'T' +
stamp.getUTCHours() + stamp.getUTCMinutes() + stamp.getUTCSeconds() + 'Z';
var calendar = 'BEGIN:VCALENDAR\r\nPRODID:HTML5\r\nVERSION:2.0\r\nBEGIN:VEVENT\r\nDTSTAMP:' + stampString + '\r\n';
var calendar = 'BEGIN:VCALENDAR\r\nPRODID:HTML\r\nVERSION:2.0\r\nBEGIN:VEVENT\r\nDTSTAMP:' + stampString + '\r\n';
for (var propIndex = 0; propIndex &lt; node.properties.length; propIndex += 1) {
var prop = node.properties[propIndex];
var value = prop.content;
Expand Down Expand Up @@ -47613,10 +47610,11 @@ interface <dfn id=function>Function</dfn> {
<tr><td><dfn id=handler-onvolumechange title=handler-onvolumechange><code>onvolumechange</code></dfn> <td> <code title=event-volumechange><a href=#event-volumechange>volumechange</a></code>
<tr><td><dfn id=handler-onwaiting title=handler-onwaiting><code>onwaiting</code></dfn> <td> <code title=event-waiting><a href=#event-waiting>waiting</a></code>

<!-- not supported in HTML5: -->
<!-- not supported, use dnd: -->
<!--<tr><td><dfn title="handler-onbeforecopy"><code>onbeforecopy</code></dfn> <td> <code title="event-beforecopy">beforecopy</code>--> <!-- widely used -->
<!--<tr><td><dfn title="handler-oncopy"><code>oncopy</code></dfn> <td> <code title="event-copy">copy</code>--> <!-- widely used -->
<!--<tr><td><dfn title="handler-onpaste"><code>onpaste</code></dfn> <td> <code title="event-paste">paste</code>--> <!-- widely used -->
<!-- not supported yet (v2?): -->
<!--<tr><td><dfn title="handler-onselectstart"><code>onselectstart</code></dfn> <td> <code title="event-selectstart">selectstart</code>--> <!-- widely used -->
</table><hr><p>The following are the <a href=#event-handler-attributes-0>event handler attributes</a> (and
their corresponding <a href=#event-handler-event-type title="event handler event type">event
Expand Down Expand Up @@ -56822,9 +56820,9 @@ http://developer.apple.com/documentation/AppleApplications/Conceptual/SafariJSPr
<dd class=impl>
<p><strong>Action:</strong> The user agent must run the following
steps:</p>
<ol><li><p>If the document is an <span>XML document</span>, then
throw an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception and abort
these steps.</li><!-- v2 support XML? -->
<ol><li><p>If the document is an <a href=#xml-documents title="XML documents">XML
document</a>, then throw an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code>
exception and abort these steps.</li><!-- v2 support XML? -->
<li><p>If the <var title="">value</var> argument wasn't
specified, abort these steps without doing anything.</li>
<li><p>If there is a selection, act as if the user had requested
Expand Down Expand Up @@ -57901,7 +57899,7 @@ interface <dfn id=messageport>MessagePort</dfn> {
discussed in the section below entitled "<a href=#the-xhtml-syntax>The XHTML
syntax</a>".</p>

<h3 id=writing-html-documents><span class=secno>9.1 </span>Writing HTML documents</h3>
<h3 id=writing><span class=secno>9.1 </span>Writing HTML documents</h3>

<div class=impl>

Expand Down Expand Up @@ -58662,9 +58660,9 @@ interface <dfn id=messageport>MessagePort</dfn> {
<p><em>This section only applies to user agents, data mining tools,
and conformance checkers.</em></p>

<p>The rules for parsing <a href=#xml-documents>XML documents</a> (and thus
<a href=#xhtml5>XHTML</a> documents) into DOM trees are covered by the next
section, entitled "<a href=#the-xhtml-syntax>The XHTML syntax</a>".</p>
<p class=note>The rules for parsing XML documents into DOM trees
are covered by the next section, entitled "<a href=#the-xhtml-syntax>The XHTML
syntax</a>".</p>

<p>For <a href=#html-documents>HTML documents</a>, user agents must use the parsing
rules described in this section to generate the DOM trees. Together,
Expand All @@ -58673,8 +58671,9 @@ interface <dfn id=messageport>MessagePort</dfn> {

<div class=note>

<p>While the HTML form of HTML5 bears a close resemblance to SGML
and XML, it is a separate language with its own parsing rules.</p>
<p>While the HTML syntax described in this specification bears a
close resemblance to SGML and XML, it is a separate language with
its own parsing rules.</p>

<p>Some earlier versions of HTML (in particular from HTML2 to
HTML4) were based on SGML and used SGML parsing rules. However, few
Expand All @@ -58689,7 +58688,7 @@ interface <dfn id=messageport>MessagePort</dfn> {

<p>Authors interested in using SGML tools in their authoring
pipeline are encouraged to use XML tools and the XML serialization
of HTML5.</p>
of HTML.</p>

</div>

Expand All @@ -58716,6 +58715,10 @@ interface <dfn id=messageport>MessagePort</dfn> {
the other conformance requirements described in this
specification.</p>

<p>For the purposes of conformance checkers, if a resource is
determined to be in <a href=#syntax>the HTML syntax</a>, then it is an
<a href=#html-documents title="HTML documents">HTML document</a>.</p>


<h4 id=overview-of-the-parsing-model><span class=secno>9.2.1 </span>Overview of the parsing model</h4>

Expand Down Expand Up @@ -67409,6 +67412,10 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
must <a href=#stop-parsing>stop parsing</a>, following the same rules as the
<a href=#html-parser>HTML parser</a>.</p>

<p>For the purposes of conformance checkers, if a resource is
determined to be in <a href=#the-xhtml-syntax>the XHTML syntax</a>, then it is an
<a href=#xml-documents title="XML documents">XML document</a>.</p>



<h3 id=serializing-xhtml-fragments><span class=secno>10.3 </span>Serializing XHTML fragments</h3>
Expand Down Expand Up @@ -69761,9 +69768,9 @@ S SPACER STRIKE TT U -->
<h4 id=the-applet-element><span class=secno>12.1.1 </span>The <dfn><code>applet</code></dfn> element</h4>

<p>The <code><a href=#the-applet-element>applet</a></code> element is a Java-specific variant of the
<code><a href=#the-embed-element>embed</a></code> element. In HTML5 the <code><a href=#the-applet-element>applet</a></code> element
is obsoleted so that all extension frameworks (Java, .NET, Flash,
etc) are handled in a consistent manner.</p>
<code><a href=#the-embed-element>embed</a></code> element. The <code><a href=#the-applet-element>applet</a></code> element is now
obsoleted so that all extension frameworks (Java, .NET, Flash, etc)
are handled in a consistent manner.</p>

<p id=sandboxPluginApplet>When the <a href=#sandboxed-plugins-browsing-context-flag>sandboxed plugins
browsing context flag</a> is set on the <a href=#browsing-context>browsing
Expand Down Expand Up @@ -70735,8 +70742,8 @@ S SPACER STRIKE TT U -->
for their useful comments, both large and small, that have led to
changes to this specification over the years.</p>

<p>Thanks also to everyone who has ever posted about HTML5 to their
blogs, public mailing lists, or forums, including the <a href=http://lists.w3.org/Archives/Public/public-html/>W3C
<p>Thanks also to everyone who has ever posted about HTML&nbsp;5 to
their blogs, public mailing lists, or forums, including the <a href=http://lists.w3.org/Archives/Public/public-html/>W3C
public-html list</a> and the <a href=http://www.whatwg.org/mailing-list>various WHATWG lists</a>.

<p>Special thanks to Richard Williamson for creating the first
Expand Down Expand Up @@ -70825,8 +70832,6 @@ TODO (or delay):
<pav> the html spec should say what to do with it
XXX * <title site="" publisher="" author="">Page Title</title> ?
XXX * [onclick] should make element focusable; enter should send onclick ?
XXX * how to interpret an HTML5 document for syndication
http://hixie.ch/specs/hsf/hsf
XXX * should have some text talking about the fact that it's ok if your
page passes through a period of non-conformance while script is
running, but that in between scripts it should be compliant.
Expand Down

0 comments on commit d378809

Please sign in to comment.