Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[e] (0) Rename the 'application cache update process' to the 'applica…
…tion cache download process'

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7773

git-svn-id: http://svn.whatwg.org/webapps@4169 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Oct 18, 2009
1 parent bccf674 commit 137e8d5
Show file tree
Hide file tree
Showing 3 changed files with 107 additions and 89 deletions.
68 changes: 37 additions & 31 deletions complete.html
Expand Up @@ -735,7 +735,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<li><a href=#a-sample-manifest><span class=secno>6.9.3.1 </span>A sample manifest</a></li>
<li><a href=#writing-cache-manifests><span class=secno>6.9.3.2 </span>Writing cache manifests</a></li>
<li><a href=#parsing-cache-manifests><span class=secno>6.9.3.3 </span>Parsing cache manifests</a></ol></li>
<li><a href=#updating-an-application-cache><span class=secno>6.9.4 </span>Updating an application cache</a></li>
<li><a href=#downloading-or-updating-an-application-cache><span class=secno>6.9.4 </span>Downloading or updating an application cache</a></li>
<li><a href=#the-application-cache-selection-algorithm><span class=secno>6.9.5 </span>The application cache selection algorithm</a></li>
<li><a href=#changesToNetworkingModel><span class=secno>6.9.6 </span>Changes to the networking model</a></li>
<li><a href=#expiring-application-caches><span class=secno>6.9.7 </span>Expiring application caches</a></li>
Expand Down Expand Up @@ -52701,8 +52701,8 @@ <h4 id=appcache><span class=secno>6.9.2 </span>Application caches</h4>

<dd>The resource corresponding to the URL that was given in a
master entry's <code><a href=#the-html-element-0>html</a></code> element's <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute. The
manifest is fetched and processed during the <a href=#application-cache-update-process>application
cache update process</a>. All the <a href=#concept-appcache-master title=concept-appcache-master>master entries</a> have
manifest is fetched and processed during the <a href=#application-cache-download-process>application
cache download process</a>. All the <a href=#concept-appcache-master title=concept-appcache-master>master entries</a> have
the <a href=#same-origin title="same origin">same origin</a> as the manifest.


Expand Down Expand Up @@ -52765,7 +52765,8 @@ <h4 id=appcache><span class=secno>6.9.2 </span>Application caches</h4>
<p>Each <a href=#application-cache-group>application cache group</a> has a <dfn id=concept-appcache-pending-masters title=concept-appcache-pending-masters>list of pending master
entries</dfn>. Each entry in this list consists of a resource and a
corresponding <code>Document</code> object. It is used during the
update process to ensure that new master entries are cached.</p>
<a href=#application-cache-download-process>application cache download process</a> to ensure that new
master entries are cached.</p>

<p>An <a href=#application-cache-group>application cache group</a> can be marked as <dfn id=concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</dfn>, meaning that it
must be ignored when looking at what <a href=#application-cache-group title="application cache
Expand Down Expand Up @@ -53326,10 +53327,10 @@ <h5 id=parsing-cache-manifests><span class=secno>6.9.3.3 </span>Parsing cache ma
</div>


<h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an application cache</h4>
<h4 id=downloading-or-updating-an-application-cache><span class=secno>6.9.4 </span>Downloading or updating an application cache</h4>

<p>When the user agent is required (by other parts of this
specification) to start the <dfn id=application-cache-update-process>application cache update
specification) to start the <dfn id=application-cache-download-process>application cache download
process</dfn> for an <a href=#absolute-url>absolute URL</a> purported to identify
a <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a>, or for an
<a href=#application-cache-group>application cache group</a>, potentially given a particular
Expand All @@ -53340,26 +53341,26 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an
agent <dfn id=shows-caching-progress>shows caching progress</dfn>. Support for this is
optional. Caching progress UI could consist of a progress bar or
message panel in the user agent's interface, or an overlay, or
something else. Certain events fired during the <a href=#application-cache-update-process>application
cache update process</a> allow the script to override the display
something else. Certain events fired during the <a href=#application-cache-download-process>application
cache download process</a> allow the script to override the display
of such an interface. The goal of this is to allow Web applications
to provide more seamless update mechanisms, hiding from the user the
mechanics of the application cache mechanism. User agents may
display user interfaces independent of this, but are encouraged to
not show prominent update progress notifications for applications
that cancel the relevant events.</p>

<p>The <a href=#application-cache-update-process>application cache update process</a> steps are as
<p>The <a href=#application-cache-download-process>application cache download process</a> steps are as
follows:

<ol><li><p>Optionally, wait until the permission to start the cache
update process has been obtained from the user. This could include
doing nothing until the user explicitly opts-in to caching the
site, or could involve prompting the user for permission. The
algorithm might never get past this point. (This step is
particularly intended to be used by user agents running on severely
space-constrained devices or in highly privacy-sensitive
environments).</li>
<ol><li><p>Optionally, wait until the permission to start the
<a href=#application-cache-download-process>application cache download process</a> has been obtained
from the user. This could include doing nothing until the user
explicitly opts-in to caching the site, or could involve prompting
the user for permission. The algorithm might never get past this
point. (This step is particularly intended to be used by user
agents running on severely space-constrained devices or in highly
privacy-sensitive environments).</li>

<li>

Expand Down Expand Up @@ -53431,8 +53432,9 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an

<li><p>If the <a href=#concept-appcache-status title=concept-appcache-status>status</a>
of the <var title="">cache group</var> is either <i>checking</i>
or <i>downloading</i>, then abort this instance of the update
process, as an update is already in progress for them.</li>
or <i>downloading</i>, then abort this instance of the
<a href=#application-cache-download-process>application cache download process</a>, as an update is
already in progress.</li>

<li><p>Set the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> to <i>checking</i>.</p>

Expand Down Expand Up @@ -53525,7 +53527,8 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an

<li><p>Let the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> be <i>idle</i>.</li>

<li><p>Abort the update process.</li>
<li><p>Abort the <a href=#application-cache-download-process>application cache download
process</a>.</li>

</ol></li>

Expand Down Expand Up @@ -53579,7 +53582,7 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an
(application caches never include fragment identifiers).</p>

<p class=note>HTTP caching rules, such as <code title="">Cache-Control: no-store</code>, are ignored for the
purposes of the <a href=#application-cache-update-process>application cache update
purposes of the <a href=#application-cache-download-process>application cache download
process</a>.</p>

</li>
Expand All @@ -53602,7 +53605,8 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an

<li><p>Let the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> be <i>idle</i>.</li>

<li><p>Abort the update process.</li>
<li><p>Abort the <a href=#application-cache-download-process>application cache download
process</a>.</li>

</ol></li>

Expand Down Expand Up @@ -53854,7 +53858,8 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an
<li><p>If appropriate, remove any user interface indicating
that an update for this cache is in progress.</li>

<li><p>Abort the update process.</li>
<li><p>Abort the <a href=#application-cache-download-process>application cache download
process</a>.</li>

</ol></li>

Expand Down Expand Up @@ -53985,14 +53990,15 @@ <h4 id=updating-an-application-cache><span class=secno>6.9.4 </span>Updating an
attempt</a>, discard <var title="">cache group</var>
altogether.</p>

<li><p>Abort the update process.</li>
<li><p>Abort the <a href=#application-cache-download-process>application cache download
process</a>.</li>

</ol><p>Attempts to <a href=#fetch>fetch</a> resources as part of the
<a href=#application-cache-update-process>application cache update process</a> may be done with
<a href=#application-cache-download-process>application cache download process</a> may be done with
cache-defeating semantics, to avoid problems with stale or
inconsistent intermediary caches.</p>

<hr><p>User agents may invoke the <a href=#application-cache-update-process>application cache update
<hr><p>User agents may invoke the <a href=#application-cache-download-process>application cache download
process</a>, in the background, for any <a href=#application-cache>application
cache</a>, at any time (with no <a href=#cache-host>cache host</a>). This
allows user agents to keep caches primed and to update caches even
Expand Down Expand Up @@ -54049,7 +54055,7 @@ <h4 id=the-application-cache-selection-algorithm><span class=secno>6.9.5 </span>

<p>Associate <var title="">document</var> with the
<a href=#application-cache>application cache</a> from which it was loaded. Invoke
the <a href=#application-cache-update-process>application cache update process</a> for that
the <a href=#application-cache-download-process>application cache download process</a> for that
<a href=#application-cache>application cache</a>'s <a href=#application-cache-group>application cache
group</a>, with <var title="">document</var> as the <a href=#cache-host>cache
host</a>.</p>
Expand All @@ -54066,7 +54072,7 @@ <h4 id=the-application-cache-selection-algorithm><span class=secno>6.9.5 </span>

<dd>

<p>Invoke the <a href=#application-cache-update-process>application cache update process</a> for
<p>Invoke the <a href=#application-cache-download-process>application cache download process</a> for
<var title="">manifest URL</var>, with <var title="">document</var> as the <a href=#cache-host>cache host</a> and with
the resource from which <var title="">document</var> was parsed as
the new <a href=#concept-appcache-master title=concept-appcache-master>master</a>
Expand Down Expand Up @@ -54223,7 +54229,7 @@ <h4 id=application-cache-api><span class=secno>6.9.8 </span>Application cache AP
<dt><var title="">cache</var> . <code title=dom-appcache-update><a href=#dom-appcache-update>update</a></code>()</dt>
<dd>

<p>Invokes the application cache update process.</p>
<p>Invokes the <a href=#application-cache-download-process>application cache download process</a>.</p>

<p>Throws an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception if there is no application cache to update.</p>

Expand Down Expand Up @@ -54323,8 +54329,8 @@ <h4 id=application-cache-api><span class=secno>6.9.8 </span>Application cache AP
</dl><div class=impl>

<hr><p>If the <dfn id=dom-appcache-update title=dom-appcache-update><code>update()</code></dfn> method is
invoked, the user agent must invoke the <a href=#application-cache-update-process>application cache
update process</a>, in the background, for the <a href=#application-cache>application
invoked, the user agent must invoke the <a href=#application-cache-download-process>application cache
download process</a>, in the background, for the <a href=#application-cache>application
cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object's
<a href=#cache-host>cache host</a> is associated, but without giving that
<a href=#cache-host>cache host</a> to the algorithm. If there is no such
Expand Down

0 comments on commit 137e8d5

Please sign in to comment.