[html5] r5811 - [e] (0) try to clarify what is normative and what is not in the definition of th [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Jan 31 16:36:50 PST 2011
Author: ianh
Date: 2011-01-31 16:36:49 -0800 (Mon, 31 Jan 2011)
New Revision: 5811
Modified:
complete.html
index
source
Log:
[e] (0) try to clarify what is normative and what is not in the definition of the appcache stuff.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=11687
Modified: complete.html
===================================================================
--- complete.html 2011-02-01 00:13:33 UTC (rev 5810)
+++ complete.html 2011-02-01 00:36:49 UTC (rev 5811)
@@ -61807,30 +61807,33 @@
<dl><dt><dfn id=concept-appcache-master title=concept-appcache-master>Master entries</dfn>
- <dd>Documents that were added to the cache because a
- <a href=#browsing-context>browsing context</a> was <a href=#navigate title=navigate>navigated</a> to that document and the
- document indicated that this was its cache, using the <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute.
+ <dd><p class=note>These are documents that were added to the
+ cache because a <a href=#browsing-context>browsing context</a> was <a href=#navigate title=navigate>navigated</a> to that document and the
+ document indicated that this was its cache, using the <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute.</p>
<dt><dfn id=concept-appcache-manifest title=concept-appcache-manifest>The manifest</dfn>
- <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
+ <dd><p class=note>This is 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-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.
+ 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.</p>
<dt><dfn id=concept-appcache-explicit title=concept-appcache-explicit>Explicit entries</dfn>
- <dd>Resources that were listed in the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in an <a href=#concept-appcache-manifest-explicit title=concept-appcache-manifest-explicit>explicit
- section</a>.
+ <dd><p class=note>These are the resources that were listed in
+ the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in an <a href=#concept-appcache-manifest-explicit title=concept-appcache-manifest-explicit>explicit
+ section</a>.</p>
<dt><dfn id=concept-appcache-fallback title=concept-appcache-fallback>Fallback entries</dfn>
- <dd>Resources that were listed in the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in a <a href=#concept-appcache-manifest-fallback title=concept-appcache-manifest-fallback>fallback
- section</a>.
+ <dd><p class=note>These are the resources that were listed in
+ the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in a <a href=#concept-appcache-manifest-fallback title=concept-appcache-manifest-fallback>fallback
+ section</a>.</p>
</dl><p><a href=#concept-appcache-explicit title=concept-appcache-explicit>Explicit entries</a>
@@ -61847,24 +61850,43 @@
</li>
- <li>Zero or more <dfn id=concept-appcache-fallback-ns title=concept-appcache-fallback-ns>fallback
- namespaces</dfn>: URLs, used as <a href=#concept-appcache-matches-fallback title=concept-appcache-matches-fallback>prefix match
- patterns</a>, each of which is mapped to a <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entry</a>. Each
- namespace URL has the <a href=#same-origin>same origin</a> as <a href=#concept-appcache-manifest title=concept-appcache-manifest>the manifest</a>.</li>
+ <li>
- <li>Zero or more URLs that form the <dfn id=concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online whitelist
- namespaces</dfn>: URLs, used as prefix match patterns, that the
- user agent will never load from the cache but will instead always
- attempt to obtain from the network.</li>
+ <p>Zero or more <dfn id=concept-appcache-fallback-ns title=concept-appcache-fallback-ns>fallback
+ namespaces</dfn>, each of which is mapped to a <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entry</a>.</p>
- <li>An <dfn id=concept-appcache-onlinewhitelist-wildcard title=concept-appcache-onlinewhitelist-wildcard>online whitelist
- wildcard flag</dfn>, which is either <i title="">open</i>
- (indicating that any URL not listed as cached is to be implicitly
- treated as being in the <a href=#concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online whitelist
- namespaces</a>) or <i title="">blocking</i> (indicating that
- URLs not listed explicitly in the manifest are to be treated as
- unavailable).</li>
+ <p class=note>These are URLs used as <a href=#concept-appcache-matches-fallback title=concept-appcache-matches-fallback>prefix match
+ patterns</a> for resources that are to be fetched from the
+ network if possible, or to be replaced by the corresponding <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entry</a> if not.
+ Each namespace URL has the <a href=#same-origin>same origin</a> as <a href=#concept-appcache-manifest title=concept-appcache-manifest>the manifest</a>.</p>
+ </li>
+
+ <li>
+
+ <p>Zero or more URLs that form the <dfn id=concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online whitelist
+ namespaces</dfn>.</p>
+
+ <p class=note>These are used as prefix match patterns, and
+ declare URLs that the user agent will never load from the cache
+ but will instead always attempt to obtain from the network.</p>
+
+ </li>
+
+ <li>
+
+ <p>An <dfn id=concept-appcache-onlinewhitelist-wildcard title=concept-appcache-onlinewhitelist-wildcard>online whitelist
+ wildcard flag</dfn>, which is either <i title="">open</i> or <i title="">blocking</i>.</p>
+
+ <p class=note>The <i title="">open</i> state indicates that any
+ URL not listed as cached is to be implicitly treated as being in
+ the <a href=#concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online
+ whitelist namespaces</a>; the <i title="">blocking</i> state
+ indicates that URLs not listed explicitly in the manifest are to
+ be treated as unavailable.</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>
Modified: index
===================================================================
--- index 2011-02-01 00:13:33 UTC (rev 5810)
+++ index 2011-02-01 00:36:49 UTC (rev 5811)
@@ -61792,30 +61792,33 @@
<dl><dt><dfn id=concept-appcache-master title=concept-appcache-master>Master entries</dfn>
- <dd>Documents that were added to the cache because a
- <a href=#browsing-context>browsing context</a> was <a href=#navigate title=navigate>navigated</a> to that document and the
- document indicated that this was its cache, using the <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute.
+ <dd><p class=note>These are documents that were added to the
+ cache because a <a href=#browsing-context>browsing context</a> was <a href=#navigate title=navigate>navigated</a> to that document and the
+ document indicated that this was its cache, using the <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute.</p>
<dt><dfn id=concept-appcache-manifest title=concept-appcache-manifest>The manifest</dfn>
- <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
+ <dd><p class=note>This is 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-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.
+ 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.</p>
<dt><dfn id=concept-appcache-explicit title=concept-appcache-explicit>Explicit entries</dfn>
- <dd>Resources that were listed in the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in an <a href=#concept-appcache-manifest-explicit title=concept-appcache-manifest-explicit>explicit
- section</a>.
+ <dd><p class=note>These are the resources that were listed in
+ the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in an <a href=#concept-appcache-manifest-explicit title=concept-appcache-manifest-explicit>explicit
+ section</a>.</p>
<dt><dfn id=concept-appcache-fallback title=concept-appcache-fallback>Fallback entries</dfn>
- <dd>Resources that were listed in the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in a <a href=#concept-appcache-manifest-fallback title=concept-appcache-manifest-fallback>fallback
- section</a>.
+ <dd><p class=note>These are the resources that were listed in
+ the cache's <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a> in a <a href=#concept-appcache-manifest-fallback title=concept-appcache-manifest-fallback>fallback
+ section</a>.</p>
</dl><p><a href=#concept-appcache-explicit title=concept-appcache-explicit>Explicit entries</a>
@@ -61832,24 +61835,43 @@
</li>
- <li>Zero or more <dfn id=concept-appcache-fallback-ns title=concept-appcache-fallback-ns>fallback
- namespaces</dfn>: URLs, used as <a href=#concept-appcache-matches-fallback title=concept-appcache-matches-fallback>prefix match
- patterns</a>, each of which is mapped to a <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entry</a>. Each
- namespace URL has the <a href=#same-origin>same origin</a> as <a href=#concept-appcache-manifest title=concept-appcache-manifest>the manifest</a>.</li>
+ <li>
- <li>Zero or more URLs that form the <dfn id=concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online whitelist
- namespaces</dfn>: URLs, used as prefix match patterns, that the
- user agent will never load from the cache but will instead always
- attempt to obtain from the network.</li>
+ <p>Zero or more <dfn id=concept-appcache-fallback-ns title=concept-appcache-fallback-ns>fallback
+ namespaces</dfn>, each of which is mapped to a <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entry</a>.</p>
- <li>An <dfn id=concept-appcache-onlinewhitelist-wildcard title=concept-appcache-onlinewhitelist-wildcard>online whitelist
- wildcard flag</dfn>, which is either <i title="">open</i>
- (indicating that any URL not listed as cached is to be implicitly
- treated as being in the <a href=#concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online whitelist
- namespaces</a>) or <i title="">blocking</i> (indicating that
- URLs not listed explicitly in the manifest are to be treated as
- unavailable).</li>
+ <p class=note>These are URLs used as <a href=#concept-appcache-matches-fallback title=concept-appcache-matches-fallback>prefix match
+ patterns</a> for resources that are to be fetched from the
+ network if possible, or to be replaced by the corresponding <a href=#concept-appcache-fallback title=concept-appcache-fallback>fallback entry</a> if not.
+ Each namespace URL has the <a href=#same-origin>same origin</a> as <a href=#concept-appcache-manifest title=concept-appcache-manifest>the manifest</a>.</p>
+ </li>
+
+ <li>
+
+ <p>Zero or more URLs that form the <dfn id=concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online whitelist
+ namespaces</dfn>.</p>
+
+ <p class=note>These are used as prefix match patterns, and
+ declare URLs that the user agent will never load from the cache
+ but will instead always attempt to obtain from the network.</p>
+
+ </li>
+
+ <li>
+
+ <p>An <dfn id=concept-appcache-onlinewhitelist-wildcard title=concept-appcache-onlinewhitelist-wildcard>online whitelist
+ wildcard flag</dfn>, which is either <i title="">open</i> or <i title="">blocking</i>.</p>
+
+ <p class=note>The <i title="">open</i> state indicates that any
+ URL not listed as cached is to be implicitly treated as being in
+ the <a href=#concept-appcache-onlinewhitelist title=concept-appcache-onlinewhitelist>online
+ whitelist namespaces</a>; the <i title="">blocking</i> state
+ indicates that URLs not listed explicitly in the manifest are to
+ be treated as unavailable.</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>
Modified: source
===================================================================
--- source 2011-02-01 00:13:33 UTC (rev 5810)
+++ source 2011-02-01 00:36:49 UTC (rev 5811)
@@ -70236,38 +70236,40 @@
<dt><dfn title="concept-appcache-master">Master entries</dfn>
- <dd>Documents that were added to the cache because a
- <span>browsing context</span> was <span
+ <dd><p class="note">These are documents that were added to the
+ cache because a <span>browsing context</span> was <span
title="navigate">navigated</span> to that document and the
document indicated that this was its cache, using the <code
- title="attr-html-manifest">manifest</code> attribute.
+ title="attr-html-manifest">manifest</code> attribute.</p>
<dt><dfn title="concept-appcache-manifest">The manifest</dfn>
- <dd>The resource corresponding to the URL that was given in a
- master entry's <code>html</code> element's <code
- title="attr-html-manifest">manifest</code> attribute. The
+ <dd><p class="note">This is the resource corresponding to the URL
+ that was given in a master entry's <code>html</code> element's
+ <code title="attr-html-manifest">manifest</code> attribute. The
manifest is fetched and processed during the <span>application
cache download process</span>. All the <span
- title="concept-appcache-master">master entries</span> have
- the <span title="same origin">same origin</span> as the manifest.
+ title="concept-appcache-master">master entries</span> have the
+ <span title="same origin">same origin</span> as the manifest.</p>
<dt><dfn title="concept-appcache-explicit">Explicit entries</dfn>
- <dd>Resources that were listed in the cache's <span
+ <dd><p class="note">These are the resources that were listed in
+ the cache's <span
title="concept-appcache-manifest">manifest</span> in an <span
title="concept-appcache-manifest-explicit">explicit
- section</span>.
+ section</span>.</p>
<dt><dfn title="concept-appcache-fallback">Fallback entries</dfn>
- <dd>Resources that were listed in the cache's <span
+ <dd><p class="note">These are the resources that were listed in
+ the cache's <span
title="concept-appcache-manifest">manifest</span> in a <span
title="concept-appcache-manifest-fallback">fallback
- section</span>.
+ section</span>.</p>
</dl>
@@ -70288,30 +70290,50 @@
</li>
- <li>Zero or more <dfn title="concept-appcache-fallback-ns">fallback
- namespaces</dfn>: URLs, used as <span
- title="concept-appcache-matches-fallback">prefix match
- patterns</span>, each of which is mapped to a <span
- title="concept-appcache-fallback">fallback entry</span>. Each
- namespace URL has the <span>same origin</span> as <span
- title="concept-appcache-manifest">the manifest</span>.</li>
+ <li>
- <li>Zero or more URLs that form the <dfn
- title="concept-appcache-onlinewhitelist">online whitelist
- namespaces</dfn>: URLs, used as prefix match patterns, that the
- user agent will never load from the cache but will instead always
- attempt to obtain from the network.</li>
+ <p>Zero or more <dfn title="concept-appcache-fallback-ns">fallback
+ namespaces</dfn>, each of which is mapped to a <span
+ title="concept-appcache-fallback">fallback entry</span>.</p>
- <li>An <dfn
- title="concept-appcache-onlinewhitelist-wildcard">online whitelist
- wildcard flag</dfn>, which is either <i title="">open</i>
- (indicating that any URL not listed as cached is to be implicitly
- treated as being in the <span
- title="concept-appcache-onlinewhitelist">online whitelist
- namespaces</span>) or <i title="">blocking</i> (indicating that
- URLs not listed explicitly in the manifest are to be treated as
- unavailable).</li>
+ <p class="note">These are URLs used as <span
+ title="concept-appcache-matches-fallback">prefix match
+ patterns</span> for resources that are to be fetched from the
+ network if possible, or to be replaced by the corresponding <span
+ title="concept-appcache-fallback">fallback entry</span> if not.
+ Each namespace URL has the <span>same origin</span> as <span
+ title="concept-appcache-manifest">the manifest</span>.</p>
+ </li>
+
+ <li>
+
+ <p>Zero or more URLs that form the <dfn
+ title="concept-appcache-onlinewhitelist">online whitelist
+ namespaces</dfn>.</p>
+
+ <p class="note">These are used as prefix match patterns, and
+ declare URLs that the user agent will never load from the cache
+ but will instead always attempt to obtain from the network.</p>
+
+ </li>
+
+ <li>
+
+ <p>An <dfn
+ title="concept-appcache-onlinewhitelist-wildcard">online whitelist
+ wildcard flag</dfn>, which is either <i title="">open</i> or <i
+ title="">blocking</i>.</p>
+
+ <p class="note">The <i title="">open</i> state indicates that any
+ URL not listed as cached is to be implicitly treated as being in
+ the <span title="concept-appcache-onlinewhitelist">online
+ whitelist namespaces</span>; the <i title="">blocking</i> state
+ indicates that URLs not listed explicitly in the manifest are to
+ be treated as unavailable.</p>
+
+ </li>
+
</ul>
<p>Each <span>application cache</span> has a <dfn
More information about the Commit-Watchers
mailing list