W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2009

html5/spec Overview.html,1.2179,1.2180

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 29 Apr 2009 01:44:09 +0000
To: public-html-commits@w3.org
Message-Id: <E1LyyqH-0000UU-OF@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv1871

Modified Files:
	Overview.html 
Log Message:
Design notes. (whatwg r3017)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2179
retrieving revision 1.2180
diff -u -d -r1.2179 -r1.2180
--- Overview.html	29 Apr 2009 00:32:40 -0000	1.2179
+++ Overview.html	29 Apr 2009 01:44:06 -0000	1.2180
@@ -268,16 +268,20 @@
    <li><a href="#audience"><span class="secno">1.2 </span>Audience</a></li>
    <li><a href="#scope"><span class="secno">1.3 </span>Scope</a></li>
    <li><a href="#history-0"><span class="secno">1.4 </span>History</a></li>
-   <li><a href="#relationships-to-other-specifications"><span class="secno">1.5 </span>Relationships to other specifications</a>
+   <li><a href="#design-notes"><span class="secno">1.5 </span>Design notes</a>
     <ol>
-     <li><a href="#relationship-to-html-4.01-and-dom2-html"><span class="secno">1.5.1 </span>Relationship to HTML 4.01 and DOM2 HTML</a></li>
-     <li><a href="#relationship-to-xhtml-1.x"><span class="secno">1.5.2 </span>Relationship to XHTML 1.x</a></li>
-     <li><a href="#relationship-to-xhtml2-and-xforms"><span class="secno">1.5.3 </span>Relationship to XHTML2 and XForms</a></ol></li>
-   <li><a href="#html-vs-xhtml"><span class="secno">1.6 </span>HTML vs XHTML</a></li>
-   <li><a href="#structure-of-this-specification"><span class="secno">1.7 </span>Structure of this specification</a>
+     <li><a href="#serializability-of-script-execution"><span class="secno">1.5.1 </span>Serializability of script execution</a></li>
+     <li><a href="#compliance-with-other-specifications"><span class="secno">1.5.2 </span>Compliance with other specifications</a></ol></li>
+   <li><a href="#relationships-to-other-specifications"><span class="secno">1.6 </span>Relationships to other specifications</a>
     <ol>
-     <li><a href="#how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</a></li>
-     <li><a href="#typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</a></ol></ol></li>
+     <li><a href="#relationship-to-html-4.01-and-dom2-html"><span class="secno">1.6.1 </span>Relationship to HTML 4.01 and DOM2 HTML</a></li>
+     <li><a href="#relationship-to-xhtml-1.x"><span class="secno">1.6.2 </span>Relationship to XHTML 1.x</a></li>
+     <li><a href="#relationship-to-xhtml2-and-xforms"><span class="secno">1.6.3 </span>Relationship to XHTML2 and XForms</a></ol></li>
+   <li><a href="#html-vs-xhtml"><span class="secno">1.7 </span>HTML vs XHTML</a></li>
+   <li><a href="#structure-of-this-specification"><span class="secno">1.8 </span>Structure of this specification</a>
+    <ol>
+     <li><a href="#how-to-read-this-specification"><span class="secno">1.8.1 </span>How to read this specification</a></li>
+     <li><a href="#typographic-conventions"><span class="secno">1.8.2 </span>Typographic conventions</a></ol></ol></li>
  <li><a href="#infrastructure"><span class="secno">2 </span>Common infrastructure</a>
   <ol>
    <li><a href="#terminology"><span class="secno">2.1 </span>Terminology</a>
@@ -1163,11 +1167,33 @@
   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>Since then, both groups have been working together.<h3 id="relationships-to-other-specifications"><span class="secno">1.5 </span>Relationships to other specifications</h3><h4 id="relationship-to-html-4.01-and-dom2-html"><span class="secno">1.5.1 </span>Relationship to HTML 4.01 and DOM2 HTML</h4><p><em>This section is non-normative.</em><p>This specification represents a new version of HTML4, along with
+  the less restrictive license on the WHATWG site.<p>Since then, both groups have been working together.<h3 id="design-notes"><span class="secno">1.5 </span>Design notes</h3><p><em>This section is non-normative.</em><p>It must be admitted that many aspects of HTML appear at first
+  glance to be nonsensical and inconsistent.<p>HTML, its supporting DOM APIs, as well as many of its supporting
+  technologies, have been developed over a period of several decades
+  by a wide array of people with different priorities who, in many
+  cases, did not know of each other's existence.<p>Features have thus arisen from many sources, and have not always
+  been designed in especially consistent ways. Furthermore, because of
+  the unique characteristics of the Web, implementation bugs have
+  often become de-facto, and now de-jure, standards, as content is
+  often unintentionally written in ways that rely on them before they
+  can be fixed.<p>Despite all this, efforts have been made to adhere to certain
+  design goals. These are described in the next few subsections.<h4 id="serializability-of-script-execution"><span class="secno">1.5.1 </span>Serializability of script execution</h4><p><em>This section is non-normative.</em><p>To avoid exposing Web authors to the complexities of
+  multithreading, the HTML and DOM APIs are designed such that no
+  script can ever detect the simultaneous execution of other
+  scripts. Even with <span title="Worker">workers</span>, the intent
+  is that the behavior of implementations can be thought of as
+  completely serialising the execution of all scripts in all <a href="#browsing-context" title="browsing context">browsing contexts</a>.<p class="note">The <code title="dom-navigator-GetStorageUpdates"><a href="#dom-navigator-getstorageupdates">navigator.getStorageUpdates()</a></code>
+  method, in this model, is equivalent to allowing other scripts to
+  run while the calling script is blocked.<h4 id="compliance-with-other-specifications"><span class="secno">1.5.2 </span>Compliance with other specifications</h4><p><em>This section is non-normative.</em><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>".<h3 id="relationships-to-other-specifications"><span class="secno">1.6 </span>Relationships to other specifications</h3><h4 id="relationship-to-html-4.01-and-dom2-html"><span class="secno">1.6.1 </span>Relationship to HTML 4.01 and DOM2 HTML</h4><p><em>This section is non-normative.</em><p>This specification represents a new version of HTML4, along with
   a new version of the associated DOM2 HTML API. Migration from HTML4
   to the format and APIs described in this specification should in
   most cases be straightforward, as care has been taken to ensure that
-  backwards-compatibility is retained. <a href="#references">[HTML4]</a> <a href="#references">[DOM2HTML]</a><h4 id="relationship-to-xhtml-1.x"><span class="secno">1.5.2 </span>Relationship to XHTML 1.x</h4><p><em>This section is non-normative.</em><p>This specification is intended to replace XHTML 1.0 as the
+  backwards-compatibility is retained. <a href="#references">[HTML4]</a> <a href="#references">[DOM2HTML]</a><h4 id="relationship-to-xhtml-1.x"><span class="secno">1.6.2 </span>Relationship to XHTML 1.x</h4><p><em>This section is non-normative.</em><p>This specification is intended to replace XHTML 1.0 as the
   normative definition of the XML serialization of the HTML
   vocabulary. <a href="#references">[XHTML10]</a><p>While this specification updates the semantics and requirements
   of the vocabulary defined by XHTML Modularization 1.1 and used by
@@ -1177,7 +1203,7 @@
   replacement for them. <a href="#references">[XHTMLMOD]</a> <a href="#references">[XHTML11]</a><p>Thus, authors and implementors who do not need such a
   modularization scheme can consider this specification a replacement
   for XHTML 1.x, but those who do need such a mechanism are encouraged
-  to continue using the XHTML 1.1 line of specifications.<h4 id="relationship-to-xhtml2-and-xforms"><span class="secno">1.5.3 </span>Relationship to XHTML2 and XForms</h4><p><em>This section is non-normative.</em><p>XHTML2 defines a new vocabulary with features for hyperlinks,
+  to continue using the XHTML 1.1 line of specifications.<h4 id="relationship-to-xhtml2-and-xforms"><span class="secno">1.6.3 </span>Relationship to XHTML2 and XForms</h4><p><em>This section is non-normative.</em><p>XHTML2 defines a new vocabulary with features for hyperlinks,
   multimedia content, annotating document edits, rich metadata,
   declarative interactive forms, and describing the semantics of human
   literary works such as poems and scientific papers. <a href="#references">[XHTML2]</a><p>XForms similarly defines a new vocabulary with features for
@@ -1189,7 +1215,7 @@
   strategy games, and the like.<p><em>This</em> specification aims to extend HTML so that it is
   also suitable in these contexts.<p>XHTML2, XForms, and this specification all use different
   namespaces and therefore can all be implemented in the same XML
-  processor.<h3 id="html-vs-xhtml"><span class="secno">1.6 </span>HTML vs XHTML</h3><p><em>This section is non-normative.</em><p>This specification defines an abstract language for describing
+  processor.<h3 id="html-vs-xhtml"><span class="secno">1.7 </span>HTML vs XHTML</h3><p><em>This section is non-normative.</em><p>This specification defines an abstract language for describing
   documents and applications, and some APIs for interacting with
   in-memory representations of resources that use this language.<p>The in-memory representation is known as "DOM5 HTML", or "the
   DOM" for short.<p>There are various concrete syntaxes that can be used to transmit
@@ -1211,7 +1237,7 @@
   feature can be represented using "HTML5", but cannot be represented
   with "XHTML5" and "DOM5 HTML". Comments that contain the string
   "<code title="">--&gt;</code>" can be represented in "DOM5 HTML" but
-  not in "HTML5" and "XHTML5". And so forth.<h3 id="structure-of-this-specification"><span class="secno">1.7 </span>Structure of this specification</h3><p><em>This section is non-normative.</em><p>This specification is divided into the following major
+  not in "HTML5" and "XHTML5". And so forth.<h3 id="structure-of-this-specification"><span class="secno">1.8 </span>Structure of this specification</h3><p><em>This section is non-normative.</em><p>This specification is divided into the following major
   sections:<dl><dt><a href="#infrastructure">Common Infrastructure</a></dt>
 
    <dd>The conformance classes, algorithms, definitions, and the
@@ -1265,11 +1291,11 @@
 
   </dl><p>There are also a couple of appendices, defining <a href="#rendering">rendering rules</a> for Web browsers and listing
   <a href="#no">areas that are out of scope</a> for this
-  specification.<h4 id="how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</h4><p>This specification should be read like all other specifications.
+  specification.<h4 id="how-to-read-this-specification"><span class="secno">1.8.1 </span>How to read this specification</h4><p>This specification should be read like all other specifications.
   First, it should be read cover-to-cover, multiple times. Then, it
   should be read backwards at least once. Then it should be read by
   picking random sections from the contents list and following all the
-  cross-references.<h4 id="typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</h4><p>This is a definition, requirement, or explanation.<p class="note">This is a note.<p class="example">This is an example.<p class="XXX">This is an open issue.<p class="warning">This is a warning.<pre class="idl">interface <dfn title="">Example</dfn> {
+  cross-references.<h4 id="typographic-conventions"><span class="secno">1.8.2 </span>Typographic conventions</h4><p>This is a definition, requirement, or explanation.<p class="note">This is a note.<p class="example">This is an example.<p class="XXX">This is an open issue.<p class="warning">This is a warning.<pre class="idl">interface <dfn title="">Example</dfn> {
   // this is an IDL definition
 };</pre><dl class="domintro"><dt><var title="">variable</var> = <var title="">object</var> . <code title="">method</code>( [ <var title="">optionalArgument</var> ] )</dt>
 
@@ -1707,8 +1733,8 @@
     rather than the official term ECMAScript, since the term
     JavaScript is more widely known. Similarly, the MIME type used to
     refer to JavaScript in this specification is <code title="">text/javascript</code>, since that is the most commonly
-    used type, despite it being an officially obsoleted type according
-    to RFC 4329. <!--willful violation--> <a href="#references">[RFC4329]</a></p>
+    used type, <a href="#willful-violation" title="willful violation">despite it being an
+    officially obsoleted type</a> according to RFC 4329. <a href="#references">[RFC4329]</a></p>
 
    </dd>
 
@@ -3845,8 +3871,8 @@
   manner distinct from the precise technical meaning it is given in
   RFC 3986. Readers familiar with that RFC will find it easier to read
   <em>this</em> specification if they pretend the term "URL" as used
-  herein is really called something else altogether. This is a willful
-  violation of RFC 3986. <a href="#references">RFC3986</a></p>
+  herein is really called something else altogether. This is a <a href="#willful-violation">willful
+  violation</a> of RFC 3986. <a href="#references">RFC3986</a></p>
 
   </div><div class="impl">
 
@@ -3972,7 +3998,7 @@
 
   </ol><!-- XXX we might want to define "server-based naming authority",
   it's not clear RFC3986 does a good job of defining that anymore
-  (earlier URI specs did) --><p class="note">These parsing rules are a willful violation of RFC
+  (earlier URI specs did) --><p class="note">These parsing rules are a <a href="#willful-violation">willful violation</a> of RFC
   3986 and RFC 3987 to handle legacy content. <a href="#references">RFC3986</a> <a href="#references">RFC3987</a></p>
 
   </div><div class="impl">
@@ -4645,7 +4671,7 @@
 
     </dl></li>
 
-  </ol><p class="note">The above algorithm is a willful violation of the
+  </ol><p class="note">The above algorithm is a <a href="#willful-violation">willful violation</a> of the
   HTTP specification. <a href="#references">[HTTP]</a></p>
 
 
@@ -5240,7 +5266,7 @@
     <tr><td> x-x-big5 <td> Big5 <td>
          <a href="#references">[BIG5]</a> <!-- XXX ? -->
    </table><p class="note">The requirement to treat certain encodings as other
-  encodings according to the table above is a willful violation of the
+  encodings according to the table above is a <a href="#willful-violation">willful violation</a> of the
   W3C Character Model specification. <a href="#references">[CHARMOD]</a></p>
 
   <hr><p>User agents must not support the CESU-8, UTF-7, BOCU-1 and SCSU
@@ -31273,7 +31299,7 @@
 
     <p>If <var title="">action</var> is the empty string, let <var title="">action</var> be <a href="#the-document-s-address">the document's address</a>.</p>
 
-    <p class="note">This step is a willful violation of RFC 3986. <a href="#references">[RFC3986]</a></p>
+    <p class="note">This step is a <a href="#willful-violation">willful violation</a> of RFC 3986. <a href="#references">[RFC3986]</a></p>
 
     <!-- Don't ask me why. But that's what IE does. It even treats
     action="" differently from action=" " or action="#" (the latter
@@ -37066,7 +37092,7 @@
     <code><a href="#window">Window</a></code> object, then in JavaScript, the <code title="">this</code> keyword in the global scope must return the
     <code><a href="#window">Window</a></code> object's <code><a href="#windowproxy">WindowProxy</a></code> object.</p>
 
-    <p class="note">This is a willful violation of the JavaScript
+    <p class="note">This is a <a href="#willful-violation">willful violation</a> of the JavaScript
     specification current at the time of writing (ECMAScript edition
     3). <a href="#references">[ECMA262]</a></p>
 
@@ -38930,7 +38956,8 @@
   encoded using UTF-8. Data in application cache manifests is
   line-based. Newlines must be represented by U+000A LINE FEED (LF)
   characters, U+000D CARRIAGE RETURN (CR) characters, or U+000D
-  CARRIAGE RETURN (CR) U+000A LINE FEED (LF) pairs.<p class="note">This is a willful double violation of RFC2046. <a href="#references">[RFC2046]</a><p>The first line of an application cache manifest must consist of
+  CARRIAGE RETURN (CR) U+000A LINE FEED (LF) pairs.<p class="note">This is a <a href="#willful-violation" title="willful violation">willful
+  double violation</a> of RFC2046. <a href="#references">[RFC2046]</a><p>The first line of an application cache manifest must consist of
   the string "CACHE", a single U+0020 SPACE character, the string
   "MANIFEST", and either a U+0020 SPACE character, a U+0009 CHARACTER
   TABULATION (tab) character, a U+000A LINE FEED (LF) character, or a
Received on Wednesday, 29 April 2009 01:44:18 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 29 April 2009 01:44:21 GMT