- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 16 Jul 2008 06:33:10 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/pubnotes In directory hutz:/tmp/cvs-serv11720 Modified Files: Overview.html Overview.src.html VERSION Log Message: 1.1070 Now that we've split Window in two, there are some places where we need to refer to the other interface. (whatwg r1881) Index: Overview.html =================================================================== RCS file: /sources/public/html5/pubnotes/Overview.html,v retrieving revision 1.312 retrieving revision 1.313 diff -u -d -r1.312 -r1.313 --- Overview.html 9 Jul 2008 20:37:41 -0000 1.312 +++ Overview.html 16 Jul 2008 06:33:07 -0000 1.313 @@ -12,7 +12,7 @@ </head> <body><div class="head"><div><a href="http://www.w3.org/"><img src="http://www.w3.org/Icons/w3c_home" width="72" height="48" alt="W3C" /></a></div><h1>HTML 5 Publication Notes</h1><h2> W3C - Editor’s Draft <em>10 July 2008</em></h2><dl><dt>Latest Editor’s Draft:</dt><dd><a id="latestED" href="http://dev.w3.org/html5/pubnotes/Overview.src.html">http://dev.w3.org/html5/pubnotes/Overview.src.html</a><script type="text/ecmascript"> + Editor’s Draft <em>16 July 2008</em></h2><dl><dt>Latest Editor’s Draft:</dt><dd><a id="latestED" href="http://dev.w3.org/html5/pubnotes/Overview.src.html">http://dev.w3.org/html5/pubnotes/Overview.src.html</a><script type="text/ecmascript"> var id = "$Id$"; var a = document.getElementById('cvsVersionLink'); var xs = id.match(/ ([0-9]\.[0-9.]+) /); @@ -27,22 +27,16 @@ <div style="text-align: center" id="tocjump"><a href="#toc">skip to Table of Contents</a></div> <div id="abstract"> <h2>Abstract</h2> - <p>This document provides supplemental information on the - 10 June 2008 working draft of the <a href="http://www.w3.org/TR/2008/WD-html5-20080610/">HTML 5 - specification</a> <a href="#html5">[HTML5]</a>. It - primarily documents changes that - have been made to the HTML 5 draft specification since the - time of its 22 January 2008 publication as a First Public - Working Draft <a href="#html5fpwd">[HTML5FPWD]</a>. Note that it - documents substantive changes only, and omits editorial - changes. It is intended to be readable as a “standalone” - document — meaning that readers are meant to be able to - use it to get an overview of the changes that have been - made, without necessarily needing to read the - specification itself or to read through the entire diff - document that shows all the changes..</p> + <p>This document provides summaries and details about + changes made between successive drafts of the <a href="http://www.w3.org/TR/2008/WD-html5-20080610/">HTML 5 + specification</a> <a href="#html5">[HTML5]</a>. + It documents substantive changes only, and omits editorial + changes. It’s intended to be readable as a “standalone” + document — so that readers can use it to get an overview + of the changes without necessarily needing to read the + specification itself.</p> <div class="ednote"><h4 class="ednoteHeader">Editorial note</h4><p>This document was generated on - <b>2008-07-10T05:35:50+09:00</b>.</p></div></div> + <b>2008-07-16T15:27:32+09:00</b>.</p></div></div> <div id="status"> <h2>Status of this Document</h2> <p><em> @@ -52,7 +46,7 @@ report can be found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/. </em></p><p> - This document is the 10 July 2008 <b>Editor’s Draft</b> of + This document is the 16 July 2008 <b>Editor’s Draft</b> of <cite>HTML 5 Publication Notes</cite>. Please send comments about this document to @@ -86,10 +80,14 @@ <div id="toc"> <h2>Table of Contents</h2> <ul> +<li id="summary_wd2-toc"><a href="#summary_wd2">2008-06-10: Summary list of selected changes</a> +</li> <li id="details_wd2-toc"><a href="#details_wd2">Current detailed list of changes</a> <ul> <li id="introduction_wd2-toc"><a href="#introduction_wd2">Section 1, Introduction</a> <ul> +<li id="background_wd2-toc"><a href="#background_wd2">Section 1.1, Background</a> +</li> <li id="relationship0_wd2-toc"><a href="#relationship0_wd2">Section 1.3, Relationships to other specifications</a> </li> </ul> @@ -102,13 +100,17 @@ </li> <li id="urls_wd2-toc"><a href="#urls_wd2">Section 2.3, URLs</a> </li> +<li id="common0_wd2-toc"><a href="#common0_wd2">Section 2.4, Common microsyntaxes</a> +</li> <li id="fetching_wd2-toc"><a href="#fetching_wd2">Section 2.6 [NEW], Fetching resources</a> </li> +<li id="content-type-sniffing-toc"><a href="#content-type-sniffing">Section 2.7, Determining the type of a resource</a> +</li> </ul> </li> <li id="dom_wd2-toc"><a href="#dom_wd2">Section 3, Semantics and structure of HTML documents</a> <ul> -<li id="documents_fpwd-toc"><a href="#documents_fpwd">Section 3.2, Documents</a> +<li id="documents_wd2-toc"><a href="#documents_wd2">Section 3.2, Documents</a> </li> <li id="elements_wd2-toc"><a href="#elements_wd2">Section 3.3, Elements</a> <ul> @@ -116,6 +118,8 @@ </li> </ul> </li> +<li id="apis-in_wd2-toc"><a href="#apis-in_wd2">Section 3.6, APIs in HTML documents</a> +</li> <li id="dynamic_wd2-toc"><a href="#dynamic_wd2">Section 3.7, Dynamic markup insertion</a> </li> </ul> @@ -196,7 +200,7 @@ <ul> <li id="server-sent-events_wd2-toc"><a href="#server-sent-events_wd2">Section 7.2, Server-sent DOM events</a> </li> -<li id="server-sent-events_wd2-toc"><a href="#server-sent-events_wd2">Section 7.3, Web sockets [formerly “Network connections”]</a> +<li id="network_wd2-toc"><a href="#network_wd2">Section 7.3, Web sockets [formerly “Network connections”]</a> </li> </ul> </li> @@ -539,6 +543,17 @@ </ul> </div> <div id="this_sections"> + <div id="summary_wd2" class="section"> + <h2>2008-06-10: Summary list of selected changes <a class="hash" href="#summary_wd2">#</a> <a class="toc-bak" href="#summary_wd2-toc">T</a></h2> + <p>This section provides a high-level list of selected changes + in the current Editor’s Draft of the HTML 5 specification + that were made after the June 2008 working draft. For more + detailed descriptions of the changes, see the sections in + this document that follow this one.</p> + <ul> + <li> </li> + </ul> + </div> <div id="details_wd2" class="section"> <h2>Current detailed list of changes <a class="hash" href="#details_wd2">#</a> <a class="toc-bak" href="#details_wd2-toc">T</a></h2> <p>This section provides a per-section record of changes @@ -561,6 +576,23 @@ provides both non-normative (informative) background and context information on the specification, as well as normative information.</p> + <div id="background_wd2" class="section"> + <h2>Section 1.1, Background <a class="hash" href="#background_wd2">#</a> <a class="toc-bak" href="#background_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#background">Section 1.1, Background</a>” in the + current “Editor’s Draft” + version of the specification.</p><p class="spec-link">View + + “<a href="http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html#background">Section 1.1, Background</a>” + in a + diff-marked version of the specification, showing + changes made between + 10 June 2008 + and + current “Editor’s Draft”.</p></div> + <p>This is is a newly titled section that was created + during reorganization. It contents were + previously in two unsectioned paragraphs directly + following the opening title for the section.</p> + </div> <div id="relationship0_wd2" class="section"> <h2>Section 1.3, Relationships to other specifications <a class="hash" href="#relationship0_wd2">#</a> <a class="toc-bak" href="#relationship0_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#relationship0">Section 1.3, Relationships to other specifications</a>” in the current “Editor’s Draft” @@ -579,7 +611,7 @@ <ul> <li>Text describing the relationship to XHTML 1.x was moved to create a new “Relationship to XHTML - 1.x” section, with the following content: + 1.x” subsection, with the following content: <blockquote> <p><q>This specification is intended to replace XHTML 1.0 as the normative definition of the XML @@ -604,7 +636,7 @@ </blockquote> </li> <li>A new “Relationship to Web Forms 2.0 and XForms” - section was added, with the following content: + subsection was added, with the following content: <blockquote> <p><q>This specification will eventually supplant Web Forms 2.0. The current Web Forms 2.0 draft @@ -636,10 +668,9 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This section was added during reorganization after - the June 2008 working draft; it is a new logical - division containing subsections moved from other - existing sections.</p> + <p>This section was added during reorganization; it is a + new logical division containing subsections moved from + other existing sections.</p> <div id="conformance_wd2" class="section"> <h2>Section 2.1, Conformance requirements <a class="hash" href="#conformance_wd2">#</a> <a class="toc-bak" href="#conformance_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#conformance">Section 2.1, Conformance requirements</a>” in the current “Editor’s Draft” @@ -652,12 +683,13 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This section - provides information about conformance requirements - for Web browsers and user agents, conformance - checkers, data mining tools, authoring tools, and - markup generators. In this section, the following - changes were made:</p> + <p>This section — which provides information about + conformance requirements for Web browsers and user + agents, conformance checkers, data mining tools, + authoring tools, and markup generators — had been in + the “Introduction” section in previous drafts, and was + moved here during reorganization. In this + section, the following changes were made:</p> <ul> <li>In the “Features defined in other specifications” subsection, the following statement @@ -692,9 +724,11 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This section provides information about specific - technical terms used in the specification. In this - section, the following changes were made:</p> + <p>This section — which provides information about + specific technical terms used in the specification — + had been in the “Introduction” section in previous + drafts, and was moved here during reorganization. In + this section, the following changes were made:</p> <ul> <li>The following statement was added: <blockquote> @@ -720,9 +754,12 @@ and current “Editor’s Draft”.</p></div> <p>In previous drafts, the “URLs” section was a - placeholder, with an editorial note about what it - would eventually contain. It is now fairly complete - section whose purposes are to:</p> + placeholder within the “Semantics and structure of + HTML elements” section, with an editorial note about + what it would eventually contain; during + reorganization, it was moved here and + expanded and is now a fairly complete section whose + purposes are to:</p> <ul> <li>define the following terms: <ul> @@ -779,6 +816,26 @@ statements about resolving a URL to obtain an absolute URL.</p> </div> + <div id="common0_wd2" class="section"> + <h2>Section 2.4, Common microsyntaxes <a class="hash" href="#common0_wd2">#</a> <a class="toc-bak" href="#common0_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#common0">Section 2.4, Common microsyntaxes</a>” in the + current “Editor’s Draft” + version of the specification.</p><p class="spec-link">View + + “<a href="http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html#common0">Section 2.4, Common microsyntaxes</a>” + in a + diff-marked version of the specification, showing + changes made between + 10 June 2008 + and + current “Editor’s Draft”.</p></div> + <p>This section — which describes the conformance + criteria for instances of particular data types (such as + dates or numbers) used in HTML content, as well as + describing how to parse such instances — had been in + the “Semantics and structure of HTML elements” section + in previous drafts, and was moved here during + reorganization.</p> + </div> <div id="fetching_wd2" class="section"> <h2>Section 2.6 [NEW], Fetching resources <a class="hash" href="#fetching_wd2">#</a> <a class="toc-bak" href="#fetching_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#fetching">Section 2.6 [NEW], Fetching resources</a>” in the current “Editor’s Draft” @@ -809,6 +866,25 @@ established</q></p> </blockquote> </div> + <div id="content-type-sniffing" class="section"> + <h2>Section 2.7, Determining the type of a resource <a class="hash" href="#content-type-sniffing">#</a> <a class="toc-bak" href="#content-type-sniffing-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#">Section 2.7, Determining the type of a resource</a>” in the + current “Editor’s Draft” + version of the specification.</p><p class="spec-link">View + + “<a href="http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html#">Section 2.7, Determining the type of a resource</a>” + in a + diff-marked version of the specification, showing + changes made between + 10 June 2008 + and + current “Editor’s Draft”.</p></div> + <p>This newly titled section — which specifies + content-sniffing behavior — was previously a + subsection titled “Determining the type of a new + resource in a browsing context” within the “Web + browsers” section. It was moved here during + reorganization.</p> + </div> </div> <div id="dom_wd2" class="section"> <h2>Section 3, Semantics and structure of HTML documents <a class="hash" href="#dom_wd2">#</a> <a class="toc-bak" href="#dom_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#dom">Section 3, Semantics and structure of HTML documents</a>” in the @@ -846,8 +922,8 @@ <code class="domattribute">innerHTML</code> family of DOM attributes.</li> </ul> - <div id="documents_fpwd" class="section"> - <h2>Section 3.2, Documents <a class="hash" href="#documents_fpwd">#</a> <a class="toc-bak" href="#documents_fpwd-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#documents">Section 3.2, Documents</a>” in the + <div id="documents_wd2" class="section"> + <h2>Section 3.2, Documents <a class="hash" href="#documents_wd2">#</a> <a class="toc-bak" href="#documents_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#documents">Section 3.2, Documents</a>” in the current “Editor’s Draft” version of the specification.</p><p class="spec-link">View @@ -858,8 +934,11 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This section defines the Document object. In this - section, the following changes were made:</p> + <p>This section — which defines the Document object — + had been in the “The Document Object Model” section in + previous drafts, and was moved here during + reorganization. In this section, the following changes + were made:</p> <ul> <li>In the “Resource metadata management” subsection, which deals in part with the @@ -880,10 +959,12 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This section defines the + <p>This section — which defines the <code>HTMLElement</code> interface and global HTML content attributes and event-handler content - attributes.</p> + attributes — had been in the “The Document Object + Model” section in previous drafts, and was moved here + during reorganization.</p> <div id="global_wd2" class="section"> <h2>Section 3.3.3, Global attributes <a class="hash" href="#global_wd2">#</a> <a class="toc-bak" href="#global_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#global">Section 3.3.3, Global attributes</a>” in the current “Editor’s Draft” @@ -921,6 +1002,24 @@ </ul> </div> </div> + <div id="apis-in_wd2" class="section"> + <h2>Section 3.6, APIs in HTML documents <a class="hash" href="#apis-in_wd2">#</a> <a class="toc-bak" href="#apis-in_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#apis-in">Section 3.6, APIs in HTML documents</a>” in the + current “Editor’s Draft” + version of the specification.</p><p class="spec-link">View + + “<a href="http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html#apis-in">Section 3.6, APIs in HTML documents</a>” + in a + diff-marked version of the specification, showing + changes made between + 10 June 2008 + and + current “Editor’s Draft”.</p></div> + <p>This section — which provides details about + case-insensitivity and case-changing behavior of data + returned by certain DOM APIs — had been in the “The + Document Object Model” section in previous drafts, and + was moved here during reorganization.</p> + </div> <div id="dynamic_wd2" class="section"> <h2>Section 3.7, Dynamic markup insertion <a class="hash" href="#dynamic_wd2">#</a> <a class="toc-bak" href="#dynamic_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#dynamic">Section 3.7, Dynamic markup insertion</a>” in the current “Editor’s Draft” @@ -933,10 +1032,12 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This section defines mechanisms that enable + <p>This section — which defines mechanisms that enable script authors to dynamically insert markup into a - document. In the section, the following changes were - made:</p> + document — had been in the “The Document Object Model” + section in previous drafts, and was moved here during + reorganization. In the section, the following changes + were made:</p> <ul> <li>In the “Dynamic markup insertion in HTML” subsection, an instance of the phrase “script that @@ -967,16 +1068,16 @@ 10 June 2008 and current “Editor’s Draft”.</p></div> - <p>This newly titled section was formed from subsections - that had previously been in the “Semantics and structure - of HTML documents” section. It defines the meanings and - content models for each element in the HTML language, - and includes both “authoring conformance” or “document - conformance” requirements (to enable authors to produce - conformant HTML documents) with “implementation - conformance” or “user-agent conformance” requirements - (to enable implementors to produce conformant HTML user - agents).</p> + <p>During reorganization, this newly titled section was + formed from subsections that had previously been in the + “Semantics and structure of HTML documents” section. It + defines the meanings and content models for each element + in the HTML language, and includes both “authoring + conformance” or “document conformance” requirements (to + enable authors to produce conformant HTML documents) + with “implementation conformance” or “user-agent + conformance” requirements (to enable implementors to + produce conformant HTML user agents).</p> <div id="document_wd2" class="section"> <h2>Section 4.2, Document metadata <a class="hash" href="#document_wd2">#</a> <a class="toc-bak" href="#document_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#document">Section 4.2, Document metadata</a>” in the current “Editor’s Draft” @@ -1280,7 +1381,7 @@ attribute was added: <blockquote> <p><q>The only way this default is used is in - deciding what number the↑ ↑pixelRatio↑ ↑DOM + deciding what number the pixelRatio DOM attribute will return if the content attribute is omitted or cannot be parsed. If the content attribute is omitted or cannot be parsed, then @@ -1532,9 +1633,9 @@ <em class="highlight">(and that no additional line cap is added)</em>.</q></li> <li>Text specifying “gradient interpolation” was - revised to specify both and <q>interpolation and + revised to specify both an <q>interpolation and extrapolation</q>.</li> - <li>The “Shadows” subsection was update to state + <li>The “Shadows” subsection was updated to state that support for shadows is a requirement (in previous drafts, it had stated that such support was optional).</li> @@ -1771,7 +1872,8 @@ Document to which the attribute node belongs.</q></li> <li>In the algorithm for determining whether two - origins are of the same origin, <q>If either A [the + origins are of the same origin, the following + statement was added: <q>If either A [the first origin to be compared] or B [the second origin to be compared] have additional data, but that data is not identical for both, return @@ -1818,26 +1920,38 @@ is typically <em class="highlight">either</em> a Window object <em class="highlight">or an empty object</em></q>.</li> - <li>Also in the “Script execution contexts” - subsection, the following statement was added: - <q>When the script execution context of a script is - an empty object, it can’t do anything that - interacts with the environment.</q></li> - <li>Also in the “Script execution contexts” - subsection, a related statement was updated to now - read (added text highlighted): <q>A script execution - context always has an associated browsing - context<em class="highlight">, known as the script - browsing context</em>.</q></li> - <li>Also in the “Script execution contexts” - subsection, the following statement was added: - <q>Every script whose script execution context is a - Window object is also associated with a Document - object, known as its <em class="highlight">script - document context</em>. It is used to resolve - URLs. The document is assigned when the script is - created, as with the script browsing - context.</q></li> + <li>In the “Script execution contexts” + subsection, the following changes were made: + <ul> + <li>The following statement was added: + <q>When the script execution context of a script is + an empty object, it can’t do anything that + interacts with the environment.</q></li> + <li>A related statement was updated to now + read (added text highlighted): <q>A script execution + context always has an associated browsing + context<em class="highlight">, known as the script + browsing context</em>.</q></li> + <li>The following statement was added: + <q>Every script whose script execution context is a + Window object is also associated with a Document + object, known as its <em class="highlight">script + document context</em>. It is used to resolve + URLs. The document is assigned when the script is + created, as with the script browsing + context.</q></li> + <li>A pair of statements defining the <q>script + browsing context</q> was updated to now read + (changed text highlighted): <q>A script + execution context always has an associated + browsing context, known as the script browsing + context. If the script execution context is a + <em class="highlighted">WindowBrowsingContext</em> object, then + that object’s browsing context is it</q> (the + text had previously referred to the + <code>Window</code> object).</li> + </ul> + </li> <li>In the “The javascript: protocol” subsection, a statement related to navigating the browsing context to a <code>javascript:</code> protocol URL was @@ -1878,7 +1992,8 @@ <ul> <li>In the “Dialogs implemented using separate documents” subsection, in a step in the algorithm - that user agents must run when the <code class="method">showModalDialog()</code> method, the + that user agents must run when the <code class="method">showModalDialog()</code> method is + invoked, the phrase “browsing context of the Window object that is the script execution context” was replaced with the phrase <q>script browsing context</q>.</li> @@ -2054,12 +2169,11 @@ <p>This section describes various features that concern user interaction with content, including features that allow authors to enable users to interactively edit - documents and parts of documents. During reorganization - after the June 2008 working draft, several subsections - were moved from other sections into this one, including - the “The contenteditable attribute”, “Activation”, and - “Scrolling elements into view”, and “Focus” - subsections.</p> + documents and parts of documents. During reorganization, + several subsections were moved from other sections into + this one, including the “The irrelevant attribute”, + “Activation”, “Scrolling elements into view”, and + “Focus” subsections.</p> </div> <div id="comms_wd2" class="section"> <h2>Section 7, Communication <a class="hash" href="#comms_wd2">#</a> <a class="toc-bak" href="#comms_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#comms">Section 7, Communication</a>” in the @@ -2080,9 +2194,12 @@ “cross-document messaging”). This section defines APIs for enabling those classes of communication; specifically, APIs for cross-document messaging, for server-sent DOM - events, and for network connections — as well as providing - the interface definitions for messages sent in - cross-document messaging and server-sent DOM events.</p> + events, and for so-called “Web Sockets” (for enabling + Web applications to maintain bidirectional + communications with their originating server) — as well + as providing the interface definitions for messages sent + in cross-document messaging and server-sent DOM + events.</p> <div id="server-sent-events_wd2" class="section"> <h2>Section 7.2, Server-sent DOM events <a class="hash" href="#server-sent-events_wd2">#</a> <a class="toc-bak" href="#server-sent-events_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#server-sent-events">Section 7.2, Server-sent DOM events</a>” in the current “Editor’s Draft” @@ -2116,12 +2233,12 @@ and to using the resulting <q>absolute URL</q>.</li> </ul> </div> - <div id="server-sent-events_wd2" class="section"> - <h2>Section 7.3, Web sockets [formerly “Network connections”] <a class="hash" href="#server-sent-events_wd2">#</a> <a class="toc-bak" href="#server-sent-events_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#server-sent-events">Section 7.3, Web sockets [formerly “Network connections”]</a>” in the + <div id="network_wd2" class="section"> + <h2>Section 7.3, Web sockets [formerly “Network connections”] <a class="hash" href="#network_wd2">#</a> <a class="toc-bak" href="#network_wd2-toc">T</a></h2><div class="spec-links"><p class="spec-link">View “<a href="http://www.w3.org/html/wg/html5/#network">Section 7.3, Web sockets [formerly “Network connections”]</a>” in the current “Editor’s Draft” version of the specification.</p><p class="spec-link">View - “<a href="http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html#server-sent-events">Section 7.3, Web sockets [formerly “Network connections”]</a>” + “<a href="http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html#network">Section 7.3, Web sockets [formerly “Network connections”]</a>” in a diff-marked version of the specification, showing changes made between @@ -2145,7 +2262,8 @@ <code class="method">TCPConnection()</code>, which had been intended for creating a direct link to another node on the Internet using TCP/IP; - <code>LocalBroadcastConnection()</code>, which had + <code class="method">LocalBroadcastConnection()</code>, + which had been intended for creating a connection to any listening peer on a local network (a local TCP/IP subnet using UDP, a Bluetooth PAN, or another Index: VERSION =================================================================== RCS file: /sources/public/html5/pubnotes/VERSION,v retrieving revision 1.13 retrieving revision 1.14 diff -u -d -r1.13 -r1.14 --- VERSION 9 Jul 2008 20:45:45 -0000 1.13 +++ VERSION 16 Jul 2008 06:33:07 -0000 1.14 @@ -1,4 +1,4 @@ <!-- * vim: set ft=xml: --> <versions> - <done>1.1046</done> + <done>1.1047</done> </versions> Index: Overview.src.html =================================================================== RCS file: /sources/public/html5/pubnotes/Overview.src.html,v retrieving revision 1.304 retrieving revision 1.305 diff -u -d -r1.304 -r1.305 --- Overview.src.html 9 Jul 2008 21:15:43 -0000 1.304 +++ Overview.src.html 16 Jul 2008 06:33:07 -0000 1.305 @@ -50,21 +50,15 @@ <div id=tocjump style="text-align: center"><a href=#toc>skip to Table of Contents</a></div> <section id=abstract> <h2>Abstract</h2> - <p>This document provides supplemental information on the - 10 June 2008 working draft of the <a + <p>This document provides summaries and details about + changes made between successive drafts of the <a href="http://www.w3.org/TR/2008/WD-html5-20080610/">HTML 5 - specification</a> <a href="#html5">[HTML5]</a>. It - primarily documents changes that - have been made to the HTML 5 draft specification since the - time of its 22 January 2008 publication as a First Public - Working Draft <a href="#html5fpwd">[HTML5FPWD]</a>. Note that it - documents substantive changes only, and omits editorial - changes. It is intended to be readable as a “standalone” - document — meaning that readers are meant to be able to - use it to get an overview of the changes that have been - made, without necessarily needing to read the - specification itself or to read through the entire diff - document that shows all the changes..</p> + specification</a> <a href="#html5">[HTML5]</a>. + It documents substantive changes only, and omits editorial + changes. It’s intended to be readable as a “standalone” + document — so that readers can use it to get an overview + of the changes without necessarily needing to read the + specification itself.</p> </section> <section id=status> <h2>Status of this Document</h2> @@ -73,6 +67,17 @@ <h2>Table of Contents</h2> </section> <div id=this_sections> + <section id=summary_wd2> + <h2>2008-06-10: Summary list of selected changes</h2> + <p>This section provides a high-level list of selected changes + in the current Editor’s Draft of the HTML 5 specification + that were made after the June 2008 working draft. For more + detailed descriptions of the changes, see the sections in + this document that follow this one.</p> + <ul> + <li> </li> + </ul> + </section> <section id=details_wd2> <h2>Current detailed list of changes</h2> <p>This section provides a per-section record of changes @@ -85,6 +90,13 @@ provides both non-normative (informative) background and context information on the specification, as well as normative information.</p> + <section id=background_wd2> + <h2>Section 1.1, Background</h2> + <p>This is is a newly titled section that was created + during reorganization. It contents were + previously in two unsectioned paragraphs directly + following the opening title for the section.</p> + </section> <section id=relationship0_wd2> <h2>Section 1.3, Relationships to other specifications</h2> <p>In this section, which describes the relationship @@ -93,7 +105,7 @@ <ul> <li>Text describing the relationship to XHTML 1.x was moved to create a new “Relationship to XHTML - 1.x” section, with the following content: + 1.x” subsection, with the following content: <blockquote> <p><q>This specification is intended to replace XHTML 1.0 as the normative definition of the XML @@ -118,7 +130,7 @@ </blockquote> </li> <li>A new “Relationship to Web Forms 2.0 and XForms” - section was added, with the following content: + subsection was added, with the following content: <blockquote> <p><q>This specification will eventually supplant Web Forms 2.0. The current Web Forms 2.0 draft @@ -140,18 +152,18 @@ </section> <section id=infrastructure> <h2>Section 2 [NEW], Common infrastructure</h2> - <p>This section was added during reorganization after - the June 2008 working draft; it is a new logical - division containing subsections moved from other - existing sections.</p> + <p>This section was added during reorganization; it is a + new logical division containing subsections moved from + other existing sections.</p> <section id=conformance_wd2> <h2>Section 2.1, Conformance requirements</h2> - <p>This section - provides information about conformance requirements - for Web browsers and user agents, conformance - checkers, data mining tools, authoring tools, and - markup generators. In this section, the following - changes were made:</p> + <p>This section — which provides information about + conformance requirements for Web browsers and user + agents, conformance checkers, data mining tools, + authoring tools, and markup generators — had been in + the “Introduction” section in previous drafts, and was + moved here during reorganization. In this + section, the following changes were made:</p> <ul> <li>In the “Features defined in other specifications” subsection, the following statement @@ -176,9 +188,11 @@ </section> <section id=terminology_wd2> <h2>Section 2.2, Terminology</h2> - <p>This section provides information about specific - technical terms used in the specification. In this - section, the following changes were made:</p> + <p>This section — which provides information about + specific technical terms used in the specification — + had been in the “Introduction” section in previous + drafts, and was moved here during reorganization. In + this section, the following changes were made:</p> <ul> <li>The following statement was added: <blockquote> @@ -194,9 +208,12 @@ <section id=urls_wd2> <h2>Section 2.3, URLs</h2> <p>In previous drafts, the “URLs” section was a - placeholder, with an editorial note about what it - would eventually contain. It is now fairly complete - section whose purposes are to:</p> + placeholder within the “Semantics and structure of + HTML elements” section, with an editorial note about + what it would eventually contain; during + reorganization, it was moved here and + expanded and is now a fairly complete section whose + purposes are to:</p> <ul> <li>define the following terms: <ul> @@ -253,6 +270,16 @@ statements about resolving a URL to obtain an absolute URL.</p> </section> + <section id=common0_wd2> + <h2>Section 2.4, Common microsyntaxes</h2> + <p>This section — which describes the conformance + criteria for instances of particular data types (such as + dates or numbers) used in HTML content, as well as + describing how to parse such instances — had been in + the “Semantics and structure of HTML elements” section + in previous drafts, and was moved here during + reorganization.</p> + </section> <section id=fetching_wd2> <h2>Section 2.6 [NEW], Fetching resources</h2> <p>This section is newly added. It is a placeholder @@ -273,6 +300,15 @@ established</q></p> </blockquote> </section> + <section id=content-type-sniffing> + <h2>Section 2.7, Determining the type of a resource</h2> + <p>This newly titled section — which specifies + content-sniffing behavior — was previously a + subsection titled “Determining the type of a new + resource in a browsing context” within the “Web + browsers” section. It was moved here during + reorganization.</p> + </section> </section> <section id=dom_wd2> <h2>Section 3, Semantics and structure of HTML documents</h2> @@ -300,10 +336,13 @@ <code class=domattribute>innerHTML</code> family of DOM attributes.</li> </ul> - <section id=documents_fpwd> + <section id=documents_wd2> <h2>Section 3.2, Documents</h2> - <p>This section defines the Document object. In this - section, the following changes were made:</p> + <p>This section — which defines the Document object — + had been in the “The Document Object Model” section in + previous drafts, and was moved here during + reorganization. In this section, the following changes + were made:</p> <ul> <li>In the “Resource metadata management” subsection, which deals in part with the @@ -314,10 +353,12 @@ </section> <section id=elements_wd2> <h2>Section 3.3, Elements</h2> - <p>This section defines the + <p>This section — which defines the <code>HTMLElement</code> interface and global HTML content attributes and event-handler content - attributes.</p> + attributes — had been in the “The Document Object + Model” section in previous drafts, and was moved here + during reorganization.</p> <section id=global_wd2> <h2>Section 3.3.3, Global attributes</h2> <p>This section defines attributes that may be specified on @@ -345,12 +386,22 @@ </ul> </section> </section> + <section id=apis-in_wd2> + <h2>Section 3.6, APIs in HTML documents</h2> + <p>This section — which provides details about + case-insensitivity and case-changing behavior of data + returned by certain DOM APIs — had been in the “The + Document Object Model” section in previous drafts, and + was moved here during reorganization.</p> + </section> <section id=dynamic_wd2> <h2>Section 3.7, Dynamic markup insertion</h2> - <p>This section defines mechanisms that enable + <p>This section — which defines mechanisms that enable script authors to dynamically insert markup into a - document. In the section, the following changes were - made:</p> + document — had been in the “The Document Object Model” + section in previous drafts, and was moved here during + reorganization. In the section, the following changes + were made:</p> <ul> <li>In the “Dynamic markup insertion in HTML” subsection, an instance of the phrase “script that @@ -371,16 +422,16 @@ </section> <section id=semantics_wd2> <h2>Section 4 [NEW], The elements of HTML</h2> - <p>This newly titled section was formed from subsections - that had previously been in the “Semantics and structure - of HTML documents” section. It defines the meanings and - content models for each element in the HTML language, - and includes both “authoring conformance” or “document - conformance” requirements (to enable authors to produce - conformant HTML documents) with “implementation - conformance” or “user-agent conformance” requirements - (to enable implementors to produce conformant HTML user - agents).</p> + <p>During reorganization, this newly titled section was + formed from subsections that had previously been in the + “Semantics and structure of HTML documents” section. It + defines the meanings and content models for each element + in the HTML language, and includes both “authoring + conformance” or “document conformance” requirements (to + enable authors to produce conformant HTML documents) + with “implementation conformance” or “user-agent + conformance” requirements (to enable implementors to + produce conformant HTML user agents).</p> <section id=document_wd2> <h2>Section 4.2, Document metadata</h2> <p>This section defines the semantics and structure of @@ -1020,26 +1071,39 @@ is typically <em class=highlight>either</em> a Window object <em class=highlight>or an empty object</em></q>.</li> - <li>Also in the “Script execution contexts” - subsection, the following statement was added: - <q>When the script execution context of a script is - an empty object, it can’t do anything that - interacts with the environment.</q></li> - <li>Also in the “Script execution contexts” - subsection, a related statement was updated to now - read (added text highlighted): <q>A script execution - context always has an associated browsing - context<em class=highlight>, known as the script - browsing context</em>.</q></li> - <li>Also in the “Script execution contexts” - subsection, the following statement was added: - <q>Every script whose script execution context is a - Window object is also associated with a Document - object, known as its <em class=highlight>script - document context</em>. It is used to resolve - URLs. The document is assigned when the script is - created, as with the script browsing - context.</q></li> + <li>In the “Script execution contexts” + subsection, the following changes were made: + <ul> + <li>The following statement was added: + <q>When the script execution context of a script is + an empty object, it can’t do anything that + interacts with the environment.</q></li> + <li>A related statement was updated to now + read (added text highlighted): <q>A script execution + context always has an associated browsing + context<em class=highlight>, known as the script + browsing context</em>.</q></li> + <li>The following statement was added: + <q>Every script whose script execution context is a + Window object is also associated with a Document + object, known as its <em class=highlight>script + document context</em>. It is used to resolve + URLs. The document is assigned when the script is + created, as with the script browsing + context.</q></li> + <li>A pair of statements defining the <q>script + browsing context</q> was updated to now read + (changed text highlighted): <q>A script + execution context always has an associated + browsing context, known as the script browsing + context. If the script execution context is a + <em class=highlighted + >WindowBrowsingContext</em> object, then + that object’s browsing context is it</q> (the + text had previously referred to the + <code>Window</code> object).</li> + </ul> + </li> <li>In the “The javascript: protocol” subsection, a statement related to navigating the browsing context to a <code>javascript:</code> protocol URL was @@ -1189,12 +1253,11 @@ <p>This section describes various features that concern user interaction with content, including features that allow authors to enable users to interactively edit - documents and parts of documents. During reorganization - after the June 2008 working draft, several subsections - were moved from other sections into this one, including - the “The contenteditable attribute”, “Activation”, and - “Scrolling elements into view”, and “Focus” - subsections.</p> + documents and parts of documents. During reorganization, + several subsections were moved from other sections into + this one, including the “The irrelevant attribute”, + “Activation”, “Scrolling elements into view”, and + “Focus” subsections.</p> </section> <section id=comms_wd2> <h2>Section 7, Communication</h2> @@ -1234,7 +1297,7 @@ and to using the resulting <q>absolute URL</q>.</li> </ul> </section> - <section id=server-sent-events_wd2> + <section id=network_wd2> <h2>Section 7.3, Web sockets [formerly “Network connections”]</h2> <p>This section defines a mechanism for enabling Web applications to maintain bidirectional communications
Received on Wednesday, 16 July 2008 06:33:46 UTC