- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 14 Jun 2012 22:48:21 +0000
- To: public-html-commits@w3.org
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 — 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