From dbe6cc8f35ab9979cc22350ce205f7abbdf00fe8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philip=20J=C3=A4genstedt?= <philip@foolip.org>
Date: Sat, 14 Nov 2015 11:21:38 +0100
Subject: [PATCH] Remove navigator.yieldForStorageUpdates() due to lack of
 implementation

Also rename NavigatorStorageUtils to NavigatorCookies.

Fixes https://github.com/whatwg/html/issues/334
---
 source | 57 +++------------------------------------------------------
 1 file changed, 3 insertions(+), 54 deletions(-)

diff --git a/source b/source
index be16d2e44ac..30e170caafb 100644
--- a/source
+++ b/source
@@ -637,11 +637,6 @@
   be thought of as completely serialising the execution of all scripts in all <span data-x="browsing
   context">browsing contexts</span>.</p>
 
-  <p class="note">The <code
-  data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method, in
-  this model, is equivalent to allowing other scripts to run while the calling script is
-  blocked.</p>
-
   </div>
 
 
@@ -88860,10 +88855,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
 
     <p>Displays a modal alert with the given message, and waits for the user to dismiss it.</p>
 
-    <p>A call to the <code
-    data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
-    implied when this method is invoked.</p>
-
    </dd>
 
    <dt><var>result</var> = <var>window</var> . <code subdfn data-x="dom-confirm">confirm</code>(<var>message</var>)</dt>
@@ -88872,10 +88863,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
     <p>Displays a modal OK/Cancel prompt with the given message, waits for the user to dismiss it,
     and returns true if the user clicks OK and false if the user clicks Cancel.</p>
 
-    <p>A call to the <code
-    data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
-    implied when this method is invoked.</p>
-
    </dd>
 
    <dt><var>result</var> = <var>window</var> . <code subdfn data-x="dom-prompt">prompt</code>(<var>message</var> [, <var>default</var>] )</dt>
@@ -88885,10 +88872,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
     and returns the value that the user entered. If the user cancels the prompt, then returns null
     instead. If the second argument is present, then the given value is used as a default.</p>
 
-    <p>A call to the <code
-    data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
-    implied when this method is invoked.</p>
-
    </dd>
 
   </dl>
@@ -89000,10 +88983,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
 
     <p>Prompts the user to print the page.</p>
 
-    <p>A call to the <code
-    data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
-    implied when this method is invoked.</p>
-
    </dd>
 
   </dl>
@@ -89116,10 +89095,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
     <p>Prompts the user with the given page, waits for that page to close, and returns the return
     value.</p>
 
-    <p>A call to the <code
-    data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method
-    is implied when this method is invoked.</p>
-
    </dd>
 
   </dl>
@@ -89404,7 +89379,7 @@ interface <dfn>WindowModal</dfn> {
 <span>Navigator</span> implements <span>NavigatorLanguage</span>;
 <span>Navigator</span> implements <span>NavigatorOnLine</span>;
 <span>Navigator</span> implements <span>NavigatorContentUtils</span>;
-<span>Navigator</span> implements <span>NavigatorStorageUtils</span>;
+<span>Navigator</span> implements <span>NavigatorCookies</span>;
 <span>Navigator</span> implements <span>NavigatorPlugins</span>;</pre>
 
 <!-- v2:
@@ -90303,12 +90278,11 @@ interface <dfn>NavigatorContentUtils</dfn> {
 
 
 
-  <h5>Manually releasing the storage mutex</h5>
+  <h5>Cookies</h5>
 
   <pre class="idl">[NoInterfaceObject]
-interface <dfn>NavigatorStorageUtils</dfn> {
+interface <dfn>NavigatorCookies</dfn> {
   readonly attribute boolean <span data-x="dom-navigator-cookieEnabled">cookieEnabled</span>;
-  void <span data-x="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates</span>();
 };</pre>
 
   <dl class="domintro">
@@ -90321,26 +90295,6 @@ interface <dfn>NavigatorStorageUtils</dfn> {
 
    </dd>
 
-
-   <dt><var>window</var> . <code data-x="dom-navigator">navigator</code> . <code subdfn data-x="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates</code>()</dt>
-
-   <dd>
-
-    <p>If a script uses the <code data-x="dom-document-cookie">document.cookie</code> API, or the
-    <code data-x="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
-    data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</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
-    data-x="dom-localStorage">localStorage</code> attributes can change after calling this method,
-    whence its name.</p>
-
-   </dd>
-
   </dl>
 
   <div w-nodev>
@@ -90349,11 +90303,6 @@ interface <dfn>NavigatorStorageUtils</dfn> {
    return true if the user agent attempts to handle cookies according to the cookie specification,
    and false if it ignores cookie change requests. <ref spec=COOKIES></p>
 
-   <p>The <dfn><code data-x="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates()</code></dfn> method,
-   when invoked, must, if the <span>storage mutex</span> is owned by the <span>event loop</span> of
-   the <span data-x="concept-task">task</span> that resulted in the method being called, release the
-   <span>storage mutex</span> so that it is once again free. Otherwise, it must do nothing.</p>
-
   </div>