- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 26 Mar 2009 00:41:48 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv29786
Modified Files:
Overview.html
Log Message:
Rename navigator.releaseLocks() to navigator.getStorageUpdates(); make the network layer's seting of cookies grab the lock. (whatwg r2914)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2079
retrieving revision 1.2080
diff -u -d -r1.2079 -r1.2080
--- Overview.html 25 Mar 2009 23:07:14 -0000 1.2079
+++ Overview.html 26 Mar 2009 00:41:46 -0000 1.2080
@@ -146,7 +146,7 @@
<p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 25 March 2009 --><!--:ZZZ--></h2>
+ <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 26 March 2009 --><!--:ZZZ--></h2>
<dl><!-- ZZZ: update the month/day (twice), uncomment out --><dt>This Version:</dt>
<dd><a href=http://www.w3.org/TR/2009/WD-html5-20090212/>http://www.w3.org/TR/2009/WD-html5-20090212/</a></dd>
<!-- :ZZZ -->
@@ -236,7 +236,7 @@
track.
<!--ZZZ:-->
This specification is the 12 February 2009 Working Draft.
- <!-- This specification is the 25 March 2009 Editor's Draft. -->
+ <!-- This specification is the 26 March 2009 Editor's Draft. -->
<!--:ZZZ-->
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are
identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -763,11 +763,11 @@
<li><a href=#system-state-and-capabilities><span class=secno>5.7 </span>System state and capabilities</a>
<ol>
<li><a href=#client-identification><span class=secno>5.7.1 </span>Client identification</a></li>
- <li><a href=#custom-handlers><span class=secno>5.7.2 </span>Custom protocol and content handlers</a></li>
- <li><a href=#manually-releasing-the-storage-mutex><span class=secno>5.7.3 </span>Manually releasing the storage mutex</a>
+ <li><a href=#custom-handlers><span class=secno>5.7.2 </span>Custom protocol and content handlers</a>
<ol>
- <li><a href=#security-and-privacy><span class=secno>5.7.3.1 </span>Security and privacy</a></li>
- <li><a href=#sample-handler-impl><span class=secno>5.7.3.2 </span>Sample user interface</a></ol></ol></li>
+ <li><a href=#security-and-privacy><span class=secno>5.7.2.1 </span>Security and privacy</a></li>
+ <li><a href=#sample-handler-impl><span class=secno>5.7.2.2 </span>Sample user interface</a></ol></li>
+ <li><a href=#manually-releasing-the-storage-mutex><span class=secno>5.7.3 </span>Manually releasing the storage mutex</a></ol></li>
<li><a href=#offline><span class=secno>5.8 </span>Offline Web applications</a>
<ol>
<li><a href=#introduction-2><span class=secno>5.8.1 </span>Introduction</a></li>
@@ -4423,6 +4423,23 @@
</li>
+ <li>
+
+ <p>If there are cookies to be set, then the user agent must run
+ the following substeps:</p>
+
+ <ol><li><p>Wait until ownership of the <a href=#storage-mutex>storage mutex</a> can
+ be taken by this instance of the <a href=#fetch title=fetch>fetching</a> algorithm.</li>
+
+ <li><p>Take ownership of the <a href=#storage-mutex>storage mutex</a>.</li>
+
+ <li><p>Update the cookies. <a href=#references>[COOKIES]</a></li>
+
+ <li><p>Release the <a href=#storage-mutex>storage mutex</a> so that it is once
+ again free.</li>
+
+ </ol></li>
+
<li><p>When the resource is available, <a href=#queue-a-task>queue a task</a>
that uses the resource as appropriate. If the resource can be
processed incrementally, as, for instance, with a progressively
@@ -35961,7 +35978,8 @@
<p>A user agent is required to have one <dfn id=storage-mutex>storage
mutex</dfn>. This mutex is used to control access to shared state
like cookies. At any one point, the <a href=#storage-mutex>storage mutex</a> is
- either free, or owned by a particular <a href=#event-loop>event loop</a>.</p>
+ either free, or owned by a particular <a href=#event-loop>event loop</a> or
+ instance of the <a href=#fetch title=fetch>fetching</a> algorithm.</p>
<h5 id=processing-model-2><span class=secno>5.5.4.2 </span>Processing model</h5>
@@ -37088,7 +37106,7 @@
// content handler registration
void <a href=#dom-navigator-registerprotocolhandler title=dom-navigator-registerProtocolHandler>registerProtocolHandler</a>(in DOMString protocol, in DOMString url, in DOMString title);
void <a href=#dom-navigator-registercontenthandler title=dom-navigator-registerContentHandler>registerContentHandler</a>(in DOMString mimeType, in DOMString url, in DOMString title);
- void <a href=#dom-navigator-releaselock title=dom-navigator-releaseLock>releaseLock</a>();
+ void <a href=#dom-navigator-getstorageupdates title=dom-navigator-getStorageUpdates>getStorageUpdates</a>();
<!-- XXX cookieEnabled geolocator javaEnabled mozIsLocallyAvailable preference
readonly attribute <span>MimeTypeArray</span> <span title="dom-navigator-mimeTypes">mimeTypes</span>;
readonly attribute <span>PluginArray</span> <span title="dom-navigator-plugins">plugins</span>;
@@ -37344,36 +37362,9 @@
part of any non-idempotent transaction), as the remote site would
not be able to fetch the same data.</p>
- </div><h4 id=manually-releasing-the-storage-mutex><span class=secno>5.7.3 </span>Manually releasing the storage mutex</h4><dl class=domintro><dt><var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-releaseLock><a href=#dom-navigator-releaselock>releaseLock</a></code>()</dt>
-
- <dd>
-
- <p>If a script uses the <code title=dom-document-cookie><a href=#dom-document-cookie>document.cookie</a></code> API, or the
- <code title=dom-localStorage>localStorage</code> API, the
- browser will block other scripts from accessing cookies or storage
- until the first script finishes.</p>
-
- <p>Calling the <code title=dom-navigator-releaseLock><a href=#dom-navigator-releaselock>navigator.releaseLock()</a></code>
- method tells the user agent to unblock any other scripts that may
- be blocked, even though the script hasn't returned.</p>
-
- <p>Values of cookies and items in the <code>Storage</code> objects
- of <code title=dom-localStorage>localStorage</code> attributes
- can change after calling this method.</p>
-
- </dd>
-
- </dl><div class=impl>
-
- <p>The <dfn id=dom-navigator-releaselock title=dom-navigator-releaseLock><code>releaseLock()</code></dfn>
- method, when invoked, must, if the <a href=#storage-mutex>storage mutex</a> is
- owned by the <a href=#event-loop>event loop</a> of the <a href=#concept-task title=concept-task>task</a> that resulted in the method being
- called, release the <a href=#storage-mutex>storage mutex</a> so that it is once
- again free. Otherwise, it must do nothing.</p>
-
</div><div class=impl>
- <h5 id=security-and-privacy><span class=secno>5.7.3.1 </span>Security and privacy</h5>
+ <h5 id=security-and-privacy><span class=secno>5.7.2.1 </span>Security and privacy</h5>
<p>These mechanisms can introduce a number of concerns, in
particular privacy concerns.</p>
@@ -37454,7 +37445,7 @@
</div><div class=impl>
- <h5 id=sample-handler-impl><span class=secno>5.7.3.2 </span>Sample user interface</h5>
+ <h5 id=sample-handler-impl><span class=secno>5.7.2.2 </span>Sample user interface</h5>
<p><em>This section is non-normative.</em></p>
@@ -37532,6 +37523,33 @@
method would work equivalently, but for unknown MIME types instead
of unknown protocols.</p>
+ </div><h4 id=manually-releasing-the-storage-mutex><span class=secno>5.7.3 </span>Manually releasing the storage mutex</h4><dl class=domintro><dt><var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-getStorageUpdates><a href=#dom-navigator-getstorageupdates>getStorageUpdates</a></code>()</dt>
+
+ <dd>
+
+ <p>If a script uses the <code title=dom-document-cookie><a href=#dom-document-cookie>document.cookie</a></code> API, or the
+ <code title=dom-localStorage>localStorage</code> API, the
+ browser will block other scripts from accessing cookies or storage
+ until the first script finishes.</p>
+
+ <p>Calling the <code title=dom-navigator-getStorageUpdates><a href=#dom-navigator-getstorageupdates>navigator.getStorageUpdates()</a></code>
+ method tells the user agent to unblock any other scripts that may
+ be blocked, even though the script hasn't returned.</p>
+
+ <p>Values of cookies and items in the <code>Storage</code> objects
+ of <code title=dom-localStorage>localStorage</code> attributes
+ can change after calling this method, whence its name.</p>
+
+ </dd>
+
+ </dl><div class=impl>
+
+ <p>The <dfn id=dom-navigator-getstorageupdates title=dom-navigator-getStorageUpdates><code>getStorageUpdates()</code></dfn>
+ method, when invoked, must, if the <a href=#storage-mutex>storage mutex</a> is
+ owned by the <a href=#event-loop>event loop</a> of the <a href=#concept-task title=concept-task>task</a> that resulted in the method being
+ called, release the <a href=#storage-mutex>storage mutex</a> so that it is once
+ again free. Otherwise, it must do nothing.</p>
+
</div><h3 id=offline><span class=secno>5.8 </span>Offline Web applications</h3><h4 id=introduction-2><span class=secno>5.8.1 </span>Introduction</h4><p><em>This section is non-normative.</em><p class=XXX>...<div class=impl>
<h4 id=appcache><span class=secno>5.8.2 </span>Application caches</h4>
Received on Thursday, 26 March 2009 00:42:00 UTC