[html5] r8782 - [e] (0) Reframe the 'update the rendering' step so we can add substeps. Fixing h [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Sep 17 13:42:13 PDT 2014


Author: ianh
Date: 2014-09-17 13:42:09 -0700 (Wed, 17 Sep 2014)
New Revision: 8782

Modified:
   complete.html
   index
   source
Log:
[e] (0) Reframe the 'update the rendering' step so we can add substeps.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=26636
Affected topics: DOM APIs

Modified: complete.html
===================================================================
--- complete.html	2014-09-17 17:19:38 UTC (rev 8781)
+++ complete.html	2014-09-17 20:42:09 UTC (rev 8782)
@@ -62820,10 +62820,21 @@
    queue</a>.<li><p>Set the <a href=#event-loop id=processing-model-9:event-loop-4>event loop</a>'s <a href=#currently-running-task id=processing-model-9:currently-running-task>currently running task</a> to the <a href=#concept-task id=processing-model-9:concept-task-2>task</a> selected in the previous step.<li><p><i>Run</i>: Run the selected <a href=#concept-task id=processing-model-9:concept-task-3>task</a>.<li><p>Set the <a href=#event-loop id=processing-model-9:event-loop-5>event loop</a>'s <a href=#currently-running-task id=processing-model-9:currently-running-task-2>currently running task</a> back to
    null.<li><p>If the <a href=#storage-mutex id=processing-model-9:storage-mutex>storage mutex</a> is now owned by the <a href=#event-loop id=processing-model-9:event-loop-6>event loop</a>, release it
    so that it is once again free.<li><p>If a task was run in the <i>run</i> step above, remove that task from its <a href=#task-queue id=processing-model-9:task-queue-3>task
-   queue</a>.<li><p><a href=#perform-a-microtask-checkpoint id=processing-model-9:perform-a-microtask-checkpoint>Perform a microtask checkpoint</a>.<li><p><i>Update the rendering</i>: If this <a href=#event-loop id=processing-model-9:event-loop-7>event loop</a> is a <a href=#browsing-context id=processing-model-9:browsing-context-2>browsing
-   context</a> <a href=#event-loop id=processing-model-9:event-loop-8>event loop</a> (as opposed to a <a href=#workers>worker</a> <a href=#event-loop id=processing-model-9:event-loop-9>event
-   loop</a>), then, if necessary, update the rendering or user interface of any
-   <code id=processing-model-9:document-2><a href=#document>Document</a></code> or <a href=#browsing-context id=processing-model-9:browsing-context-3>browsing context</a> to reflect the current state.<li><p>If this is a <a href=#workers>worker</a> <a href=#event-loop id=processing-model-9:event-loop-10>event loop</a> (i.e. one running for a
+   queue</a>.<li><p><a href=#perform-a-microtask-checkpoint id=processing-model-9:perform-a-microtask-checkpoint>Perform a microtask checkpoint</a>.<li>
+
+    <p><i>Update the rendering</i>: If this <a href=#event-loop id=processing-model-9:event-loop-7>event loop</a> is a <a href=#browsing-context id=processing-model-9:browsing-context-2>browsing
+    context</a> <a href=#event-loop id=processing-model-9:event-loop-8>event loop</a> (as opposed to a <a href=#workers>worker</a>
+    <a href=#event-loop id=processing-model-9:event-loop-9>event loop</a>), then, if necessary, run the following steps.</p>
+
+    <ol><li><p>Update the rendering or user interface of any <code id=processing-model-9:document-2><a href=#document>Document</a></code> or <a href=#browsing-context id=processing-model-9:browsing-context-3>browsing
+     context</a> to reflect the current state.</ol>
+
+    <p class=note>Whether these steps are necessary depends on the update frequency. For example,
+    if the browser is attempting to achieve a 60 Hz refresh rate, then these steps are only
+    necessary every 60th of a second (about 16.7ms). This specification does not mandate any
+    particular model for when to update the rendering.</p>
+
+   <li><p>If this is a <a href=#workers>worker</a> <a href=#event-loop id=processing-model-9:event-loop-10>event loop</a> (i.e. one running for a
    <code id=processing-model-9:workerglobalscope><a href=#workerglobalscope>WorkerGlobalScope</a></code>), but there are no <a href=#concept-task id=processing-model-9:concept-task-4>tasks</a> in the
    <a href=#event-loop id=processing-model-9:event-loop-11>event loop</a>'s <a href=#task-queue id=processing-model-9:task-queue-4>task queues</a> and the
    <code id=processing-model-9:workerglobalscope-2><a href=#workerglobalscope>WorkerGlobalScope</a></code> object's <a href=#dom-workerglobalscope-closing id=processing-model-9:dom-workerglobalscope-closing>closing</a> flag is true, then destroy the <a href=#event-loop id=processing-model-9:event-loop-12>event

Modified: index
===================================================================
--- index	2014-09-17 17:19:38 UTC (rev 8781)
+++ index	2014-09-17 20:42:09 UTC (rev 8782)
@@ -62820,10 +62820,21 @@
    queue</a>.<li><p>Set the <a href=#event-loop id=processing-model-9:event-loop-4>event loop</a>'s <a href=#currently-running-task id=processing-model-9:currently-running-task>currently running task</a> to the <a href=#concept-task id=processing-model-9:concept-task-2>task</a> selected in the previous step.<li><p><i>Run</i>: Run the selected <a href=#concept-task id=processing-model-9:concept-task-3>task</a>.<li><p>Set the <a href=#event-loop id=processing-model-9:event-loop-5>event loop</a>'s <a href=#currently-running-task id=processing-model-9:currently-running-task-2>currently running task</a> back to
    null.<li><p>If the <a href=#storage-mutex id=processing-model-9:storage-mutex>storage mutex</a> is now owned by the <a href=#event-loop id=processing-model-9:event-loop-6>event loop</a>, release it
    so that it is once again free.<li><p>If a task was run in the <i>run</i> step above, remove that task from its <a href=#task-queue id=processing-model-9:task-queue-3>task
-   queue</a>.<li><p><a href=#perform-a-microtask-checkpoint id=processing-model-9:perform-a-microtask-checkpoint>Perform a microtask checkpoint</a>.<li><p><i>Update the rendering</i>: If this <a href=#event-loop id=processing-model-9:event-loop-7>event loop</a> is a <a href=#browsing-context id=processing-model-9:browsing-context-2>browsing
-   context</a> <a href=#event-loop id=processing-model-9:event-loop-8>event loop</a> (as opposed to a <a href=#workers>worker</a> <a href=#event-loop id=processing-model-9:event-loop-9>event
-   loop</a>), then, if necessary, update the rendering or user interface of any
-   <code id=processing-model-9:document-2><a href=#document>Document</a></code> or <a href=#browsing-context id=processing-model-9:browsing-context-3>browsing context</a> to reflect the current state.<li><p>If this is a <a href=#workers>worker</a> <a href=#event-loop id=processing-model-9:event-loop-10>event loop</a> (i.e. one running for a
+   queue</a>.<li><p><a href=#perform-a-microtask-checkpoint id=processing-model-9:perform-a-microtask-checkpoint>Perform a microtask checkpoint</a>.<li>
+
+    <p><i>Update the rendering</i>: If this <a href=#event-loop id=processing-model-9:event-loop-7>event loop</a> is a <a href=#browsing-context id=processing-model-9:browsing-context-2>browsing
+    context</a> <a href=#event-loop id=processing-model-9:event-loop-8>event loop</a> (as opposed to a <a href=#workers>worker</a>
+    <a href=#event-loop id=processing-model-9:event-loop-9>event loop</a>), then, if necessary, run the following steps.</p>
+
+    <ol><li><p>Update the rendering or user interface of any <code id=processing-model-9:document-2><a href=#document>Document</a></code> or <a href=#browsing-context id=processing-model-9:browsing-context-3>browsing
+     context</a> to reflect the current state.</ol>
+
+    <p class=note>Whether these steps are necessary depends on the update frequency. For example,
+    if the browser is attempting to achieve a 60 Hz refresh rate, then these steps are only
+    necessary every 60th of a second (about 16.7ms). This specification does not mandate any
+    particular model for when to update the rendering.</p>
+
+   <li><p>If this is a <a href=#workers>worker</a> <a href=#event-loop id=processing-model-9:event-loop-10>event loop</a> (i.e. one running for a
    <code id=processing-model-9:workerglobalscope><a href=#workerglobalscope>WorkerGlobalScope</a></code>), but there are no <a href=#concept-task id=processing-model-9:concept-task-4>tasks</a> in the
    <a href=#event-loop id=processing-model-9:event-loop-11>event loop</a>'s <a href=#task-queue id=processing-model-9:task-queue-4>task queues</a> and the
    <code id=processing-model-9:workerglobalscope-2><a href=#workerglobalscope>WorkerGlobalScope</a></code> object's <a href=#dom-workerglobalscope-closing id=processing-model-9:dom-workerglobalscope-closing>closing</a> flag is true, then destroy the <a href=#event-loop id=processing-model-9:event-loop-12>event

Modified: source
===================================================================
--- source	2014-09-17 17:19:38 UTC (rev 8781)
+++ source	2014-09-17 20:42:09 UTC (rev 8782)
@@ -84952,11 +84952,26 @@
 
    <li><p><span>Perform a microtask checkpoint</span>.</p></li>
 
-   <li><p><i>Update the rendering</i>: If this <span>event loop</span> is a <span>browsing
-   context</span> <span>event loop</span> (as opposed to a <a href="#workers">worker</a> <span>event
-   loop</span>), then, if necessary, update the rendering or user interface of any
-   <code>Document</code> or <span>browsing context</span> to reflect the current state.</p></li>
+   <li>
 
+    <p><i>Update the rendering</i>: If this <span>event loop</span> is a <span>browsing
+    context</span> <span>event loop</span> (as opposed to a <a href="#workers">worker</a>
+    <span>event loop</span>), then, if necessary, run the following steps.</p>
+
+    <ol>
+
+     <li><p>Update the rendering or user interface of any <code>Document</code> or <span>browsing
+     context</span> to reflect the current state.</p></li>
+
+    </ol>
+
+    <p class="note">Whether these steps are necessary depends on the update frequency. For example,
+    if the browser is attempting to achieve a 60 Hz refresh rate, then these steps are only
+    necessary every 60th of a second (about 16.7ms). This specification does not mandate any
+    particular model for when to update the rendering.</p>
+
+   </li>
+
    <li><p>If this is a <a href="#workers">worker</a> <span>event loop</span> (i.e. one running for a
    <code>WorkerGlobalScope</code>), but there are no <span data-x="concept-task">tasks</span> in the
    <span>event loop</span>'s <span data-x="task queue">task queues</span> and the



More information about the Commit-Watchers mailing list