html5/spec Overview.html,1.5687,1.5688

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

Modified Files:
	Overview.html 
Log Message:
Add a feature to appcache to make it possible to mark a cache as preferring online resources than cached resources. (whatwg r7136)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5687
retrieving revision 1.5688
diff -u -d -r1.5687 -r1.5688
--- Overview.html	14 Jun 2012 20:57:03 -0000	1.5687
+++ Overview.html	14 Jun 2012 22:48:17 -0000	1.5688
@@ -55506,9 +55506,10 @@
     application caches</a> that are identified by a URL with the
     <a href="#same-origin">same origin</a> as the URL in question, and that have
     this URL as one of their entries, excluding entries marked as
-    <a href="#concept-appcache-foreign" title="concept-appcache-foreign">foreign</a>, then get
-    the resource from the <a href="#concept-appcache-selection" title="concept-appcache-selection">most appropriate application
-    cache</a> of those that match.</p>
+    <a href="#concept-appcache-foreign" title="concept-appcache-foreign">foreign</a>, and whose
+    <a href="#concept-appcache-mode" title="concept-appcache-mode">mode</a> is <a href="#concept-appcache-mode-fast" title="concept-appcache-mode-fast">fast</a>, then get the
+    resource from the <a href="#concept-appcache-selection" title="concept-appcache-selection">most
+    appropriate application cache</a> of those that match.</p>
 
     <p class="example">For example, imagine an HTML page with an
     associated application cache displaying an image and a form, where
@@ -55623,6 +55624,7 @@
 
    </li>
 
+
    <li>
 
     <p><i>Resource handling</i>: If the resource's out-of-band
@@ -57027,7 +57029,7 @@
      <td> The user agent will try fetching the files again momentarily.
   </table><div class="impl">
 
-  <h4 id="appcache"><span class="secno">5.7.2 </span>Application caches</h4>
+  <h4 id="appcache"><span class="secno">5.7.2 </span>Application caches</h4> 
 
   <p>An <dfn id="application-cache">application cache</dfn> is a set of cached resources
   consisting of:</p>
@@ -57121,6 +57123,15 @@
 
    </li>
 
+   <li>
+
+    <p>A <dfn id="concept-appcache-mode" title="concept-appcache-mode">cache mode flag</dfn>,
+    which is 
+    in the <dfn id="concept-appcache-mode-fast" title="concept-appcache-mode-fast"><i>fast</i></dfn>
+    state.</p>
+
+   </li>
+
   </ul><p>Each <a href="#application-cache">application cache</a> has a <dfn id="concept-appcache-completeness" title="concept-appcache-completeness">completeness flag</dfn>, which is
   either <i>complete</i> or <i>incomplete</i>.</p>
 
@@ -57371,7 +57382,8 @@
 
    <dt>A section header
    <dd>
-    <p>Section headers change the current section. There are three
+
+    <p>Section headers change the current section. There are four
     possible section headers:
 
     <dl><dt><code>CACHE:</code>
@@ -57383,6 +57395,7 @@
      <dt><code>NETWORK:</code>
      <dd>Switches to the <dfn id="concept-appcache-manifest-network" title="concept-appcache-manifest-network">online whitelist section</dfn>.
 
+
     </dl><p>Section header lines must consist of zero or more U+0020 SPACE
     and "tab" (U+0009) characters, followed by one
     of the names above (including the ":)" (U+003A) character
@@ -57420,6 +57433,7 @@
 
 
 
+
   </dl><p>Manifests may contain sections more than once. Sections may be
   empty.</p>
 
@@ -57491,6 +57505,8 @@
 
    <li><p>Let <var title="">online whitelist wildcard flag</var> be <i title="">blocking</i>. </li>
 
+   <li><p>Let <var title="">cache mode flag</var> be <i title="">fast</i>. </li>
+
    <li><p>Let <var title="">input</var> be the decoded text of the
    manifest's byte stream.</li>
 
@@ -57554,6 +57570,7 @@
    "NETWORK" followed by a ":)" (U+003A) character, then set <var title="">mode</var> to "online whitelist" and jump back to the step
    labeled "start of line".</li>
 
+
    <li><p>If <var title="">line</var> ends with a ":" (U+003A) character, then set <var title="">mode</var> to "unknown" and
    jump back to the step labeled "start of line".</li>
 
@@ -57675,6 +57692,7 @@
 
      </dd>
 
+
      <dt>If <var title="">mode</var> is "unknown"</dt>
 
      <dd>
@@ -57690,8 +57708,9 @@
    reached.)</li>
 
    <li><p>Return the <var title="">explicit URLs</var> list, the <var title="">fallback URLs</var> mapping, the <var title="">online
-   whitelist namespaces</var>, and the <var title="">online whitelist
-   wildcard flag</var>.</li>
+   whitelist namespaces</var>, the <var title="">online whitelist
+   wildcard flag</var>, and the <var title="">cache mode
+   flag</var>.</li>
 
   </ol><div class="note">
 
@@ -57885,8 +57904,8 @@
     obtaining a list of <a href="#concept-appcache-explicit" title="concept-appcache-explicit">explicit entries</a>, <a href="#concept-appcache-fallback" title="concept-appcache-fallback">fallback entries</a> and the
     <a href="#concept-appcache-fallback-ns" title="concept-appcache-fallback-ns">fallback
     namespaces</a> that map to them, entries for the <a href="#concept-appcache-onlinewhitelist" title="concept-appcache-onlinewhitelist">online whitelist</a>,
-    and a value for the <a href="#concept-appcache-onlinewhitelist-wildcard" title="concept-appcache-onlinewhitelist-wildcard">online whitelist
-    wildcard flag</a>.</p>
+    and values for the <a href="#concept-appcache-onlinewhitelist-wildcard" title="concept-appcache-onlinewhitelist-wildcard">online whitelist
+    wildcard flag</a> and the <a href="#concept-appcache-mode" title="concept-appcache-mode">cache mode flag</a>.</p>
 
     <p class="note">The <a href="#mime-type">MIME type</a> of the resource is
     ignored &mdash; it is assumed to be
@@ -58278,6 +58297,8 @@
    <li><p>Store the value of the new <a href="#concept-appcache-onlinewhitelist-wildcard" title="concept-appcache-onlinewhitelist-wildcard">online whitelist
    wildcard flag</a> in <var title="">new cache</var>.</li>
 
+   <li><p>Store the value of the new <a href="#concept-appcache-mode" title="concept-appcache-mode">cache mode flag</a> in <var title="">new cache</var>.</li>
+
    <li>
 
     <p>For each entry in <var title="">cache group</var>'s <a href="#concept-appcache-pending-masters" title="concept-appcache-pending-masters">list of pending master
@@ -58573,6 +58594,15 @@
     the <a href="#concept-appcache-master" title="concept-appcache-master">master</a>
     resource.</p>
 
+    <p>If there are <a href="#relevant-application-cache" title="relevant application cache">relevant
+    application caches</a> that are identified by a URL with the
+    <a href="#same-origin">same origin</a> as the URL of <var title="">document</var>, and that have this URL as one of their
+    entries, excluding entries marked as <a href="#concept-appcache-foreign" title="concept-appcache-foreign">foreign</a>, then the user
+    agent should use the <a href="#concept-appcache-selection" title="concept-appcache-selection">most
+    appropriate application cache</a> of those that match as an
+    HTTP cache for any subresource loads. User agents may also have
+    other caches in place that are also honored.</p>
+
    </dd>
 
 

Received on Thursday, 14 June 2012 22:48:24 UTC