[html5] r6379 - [e] (0) Try to clarify that UAs don't have to continually be rescanning for icon [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2011-08-05 17:31:44 -0700 (Fri, 05 Aug 2011)
New Revision: 6379

Modified:
   complete.html
   index
   source
Log:
[e] (0) Try to clarify that UAs don't have to continually be rescanning for icons and sorting each time.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13106

Modified: complete.html
===================================================================
--- complete.html	2011-08-05 23:43:48 UTC (rev 6378)
+++ complete.html	2011-08-06 00:31:44 UTC (rev 6379)
@@ -239,7 +239,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 5 August 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 6 August 2011</h2>
    </hgroup><dl><dt>Multiple-page version:</dt>
     <dd><a href=http://www.whatwg.org/specs/web-apps/current-work/complete/>http://www.whatwg.org/specs/web-apps/current-work/complete/</a></dd>
     <dt>One-page version:</dt>
@@ -54756,14 +54756,18 @@
   icons. <span class=impl>If multiple icons are provided, the user
   agent must select the most appropriate icon according to the <code title=attr-link-type><a href=#attr-link-type>type</a></code>, <code title=attr-link-media><a href=#attr-link-media>media</a></code>, and <code title=attr-link-sizes><a href=#attr-link-sizes>sizes</a></code> attributes. If there are
   multiple equally appropriate icons, user agents must use the last
-  one declared in <a href=#tree-order>tree order</a>. If the user agent tries to
-  use an icon but that icon is determined, upon closer examination, to
-  in fact be inappropriate (e.g. because it uses an unsupported
-  format), then the user agent must try the next-most-appropriate icon
-  as determined by the attributes.</span></p>
+  one declared in <a href=#tree-order>tree order</a> at the time that the user
+  agent collected the list of icons. If the user agent tries to use an
+  icon but that icon is determined, upon closer examination, to in
+  fact be inappropriate (e.g. because it uses an unsupported format),
+  then the user agent must try the next-most-appropriate icon as
+  determined by the attributes.</span></p>
 
   <div class=impl>
 
+  <p class=note>User agents are not required to update icons when
+  the list of icons changes, but are encouraged to do so.</p>
+
   <p>There is no default type for resources given by the <code title=rel-icon><a href=#rel-icon>icon</a></code> keyword. However, for the purposes of
   <a href=#concept-link-type-sniffing>determining the type of the
   resource</a>, user agents must expect the resource to be an image.</p>

Modified: index
===================================================================
--- index	2011-08-05 23:43:48 UTC (rev 6378)
+++ index	2011-08-06 00:31:44 UTC (rev 6379)
@@ -243,7 +243,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 5 August 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 6 August 2011</h2>
    </hgroup><dl><dt><strong>Web developer edition</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -54628,14 +54628,18 @@
   icons. <span class=impl>If multiple icons are provided, the user
   agent must select the most appropriate icon according to the <code title=attr-link-type><a href=#attr-link-type>type</a></code>, <code title=attr-link-media><a href=#attr-link-media>media</a></code>, and <code title=attr-link-sizes><a href=#attr-link-sizes>sizes</a></code> attributes. If there are
   multiple equally appropriate icons, user agents must use the last
-  one declared in <a href=#tree-order>tree order</a>. If the user agent tries to
-  use an icon but that icon is determined, upon closer examination, to
-  in fact be inappropriate (e.g. because it uses an unsupported
-  format), then the user agent must try the next-most-appropriate icon
-  as determined by the attributes.</span></p>
+  one declared in <a href=#tree-order>tree order</a> at the time that the user
+  agent collected the list of icons. If the user agent tries to use an
+  icon but that icon is determined, upon closer examination, to in
+  fact be inappropriate (e.g. because it uses an unsupported format),
+  then the user agent must try the next-most-appropriate icon as
+  determined by the attributes.</span></p>
 
   <div class=impl>
 
+  <p class=note>User agents are not required to update icons when
+  the list of icons changes, but are encouraged to do so.</p>
+
   <p>There is no default type for resources given by the <code title=rel-icon><a href=#rel-icon>icon</a></code> keyword. However, for the purposes of
   <a href=#concept-link-type-sniffing>determining the type of the
   resource</a>, user agents must expect the resource to be an image.</p>

Modified: source
===================================================================
--- source	2011-08-05 23:43:48 UTC (rev 6378)
+++ source	2011-08-06 00:31:44 UTC (rev 6379)
@@ -61732,14 +61732,18 @@
   title="attr-link-media">media</code>, and <code
   title="attr-link-sizes">sizes</code> attributes. If there are
   multiple equally appropriate icons, user agents must use the last
-  one declared in <span>tree order</span>. If the user agent tries to
-  use an icon but that icon is determined, upon closer examination, to
-  in fact be inappropriate (e.g. because it uses an unsupported
-  format), then the user agent must try the next-most-appropriate icon
-  as determined by the attributes.</span></p>
+  one declared in <span>tree order</span> at the time that the user
+  agent collected the list of icons. If the user agent tries to use an
+  icon but that icon is determined, upon closer examination, to in
+  fact be inappropriate (e.g. because it uses an unsupported format),
+  then the user agent must try the next-most-appropriate icon as
+  determined by the attributes.</span></p>
 
   <div class="impl">
 
+  <p class="note">User agents are not required to update icons when
+  the list of icons changes, but are encouraged to do so.</p>
+
   <p>There is no default type for resources given by the <code
   title="rel-icon">icon</code> keyword. However, for the purposes of
   <a href="#concept-link-type-sniffing">determining the type of the