html5/spec editing.html,1.1050,1.1051 offline.html,1.1051,1.1052 spec.html,1.1641,1.1642

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11493

Modified Files:
	editing.html offline.html spec.html 
Log Message:
add a note about accessibility (whatwg r6511)

[updated by splitter]


Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec/editing.html,v
retrieving revision 1.1050
retrieving revision 1.1051
diff -u -d -r1.1050 -r1.1051
--- editing.html	17 Aug 2011 04:47:26 -0000	1.1050
+++ editing.html	18 Aug 2011 21:46:28 -0000	1.1051
@@ -757,7 +757,10 @@
 
     <p>Do not use this method to hide the focus ring if you find the
     focus ring unsightly. Instead, use a CSS rule to override the
-    'outline' property.</p>
+    'outline' property. (Be aware, however, that this makes the page
+    significantly less usable for some people, especially those with
+    reduced vision who use focus outlines to help them navigate the
+    page.)</p>
 
     <div class="example">
 

Index: offline.html
===================================================================
RCS file: /sources/public/html5/spec/offline.html,v
retrieving revision 1.1051
retrieving revision 1.1052
diff -u -d -r1.1051 -r1.1052
--- offline.html	17 Aug 2011 23:46:33 -0000	1.1051
+++ offline.html	18 Aug 2011 21:46:28 -0000	1.1052
@@ -2108,6 +2108,15 @@
 
     <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if there is no application cache to update.</p>
 
+    <p>Calling this method is not usually necessary, as user agents
+    will generally take care of updating <a href="#application-cache" title="application
+    cache">application caches</a> automatically.</p>
+
+    <p>The method can be useful in situations such as long-lived
+    applications. For example, a Web mail application might stay open
+    in a browser tab for weeks at a time. Such an application could
+    want to test for updates each day.</p>
+
    </dd>
 
    <dt><var title="">cache</var> . <code title="dom-appcache-abort"><a href="#dom-appcache-abort">abort</a></code>()</dt>
@@ -2115,6 +2124,10 @@
 
     <p>Cancels the <a href="#application-cache-download-process">application cache download process</a>.</p>
 
+    <p>This method is intended to be used by Web application showing
+    their own caching progress UI, in case the user wants to stop the
+    update (e.g. because bandwidth is limited).</p>
+
    </dd>
 
    <dt><var title="">cache</var> . <code title="dom-appcache-swapCache"><a href="#dom-appcache-swapcache">swapCache</a></code>()</dt>
@@ -2130,6 +2143,18 @@
     that subsequent requests for cached resources will obtain the
     newer copies.</p>
 
+    <p>The <code title="event-appcache-updateready"><a href="#event-appcache-updateready">updateready</a></code>
+    event will fire before this method can be called. Once it fires,
+    the Web application can, at its leisure, call this method to
+    switch the underlying cache to the one with the more recent
+    updates. To make proper use of this, applications have to be able
+    to bring the new features into play; for example, reloading
+    scripts to enable new features.</p>
+
+    <p>An easier alternative to <code title="dom-appcache-swapCache"><a href="#dom-appcache-swapcache">swapCache()</a></code> is just to
+    reload the entire page at a time suitable for the user, using
+    <code title="dom-location-reload"><a href="history.html#dom-location-reload">location.reload()</a></code>.</p>
+
    </dd>
 
   </dl><div class="impl">

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1641
retrieving revision 1.1642
diff -u -d -r1.1641 -r1.1642
--- spec.html	18 Aug 2011 00:47:17 -0000	1.1641
+++ spec.html	18 Aug 2011 21:46:28 -0000	1.1642
@@ -350,7 +350,7 @@
     <a href="Overview.html">single page HTML</a>,
     <a href="spec.html">multipage HTML</a>,
     <a href="author/">web developer edition</a>.
-This is revision 1.5209.
+This is revision 1.5211.
    </p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2011 <a href="http://www.w3.org/"><abbr title="World Wide

Received on Thursday, 18 August 2011 21:46:36 UTC