[html5] r7855 - [] (0) Make it clearer that the optional icon doesn't make sense in plain text F [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2013-04-26 15:18:20 -0700 (Fri, 26 Apr 2013)
New Revision: 7855

Modified:
   complete.html
   index
   source
Log:
[] (0) Make it clearer that the optional icon doesn't make sense in plain text
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=21403
Affected topics: Rendering

Modified: complete.html
===================================================================
--- complete.html	2013-04-26 20:45:51 UTC (rev 7854)
+++ complete.html	2013-04-26 22:18:20 UTC (rev 7855)
@@ -93898,7 +93898,9 @@
 
   <p>When an <code><a href=#the-img-element>img</a></code> element <a href=#represents>represents</a> some text and the user agent does not
   expect this to change, the element is expected to be treated as a non-replaced phrasing element
-  whose content is the text, optionally with an icon indicating that an image is missing.</p>
+  whose content is the text, optionally with an icon indicating that an image is missing, so that
+  the user can request the image be displayed or investigate why it is not rendering. In
+  non-graphical contexts, such an icon should be omitted.</p>
 
   <p>When an <code><a href=#the-img-element>img</a></code> element <a href=#represents>represents</a> nothing and the user agent does not
   expect this to change, the element is expected to not be rendered at all.</p>

Modified: index
===================================================================
--- index	2013-04-26 20:45:51 UTC (rev 7854)
+++ index	2013-04-26 22:18:20 UTC (rev 7855)
@@ -93898,7 +93898,9 @@
 
   <p>When an <code><a href=#the-img-element>img</a></code> element <a href=#represents>represents</a> some text and the user agent does not
   expect this to change, the element is expected to be treated as a non-replaced phrasing element
-  whose content is the text, optionally with an icon indicating that an image is missing.</p>
+  whose content is the text, optionally with an icon indicating that an image is missing, so that
+  the user can request the image be displayed or investigate why it is not rendering. In
+  non-graphical contexts, such an icon should be omitted.</p>
 
   <p>When an <code><a href=#the-img-element>img</a></code> element <a href=#represents>represents</a> nothing and the user agent does not
   expect this to change, the element is expected to not be rendered at all.</p>

Modified: source
===================================================================
--- source	2013-04-26 20:45:51 UTC (rev 7854)
+++ source	2013-04-26 22:18:20 UTC (rev 7855)
@@ -104980,7 +104980,9 @@
 
   <p>When an <code>img</code> element <span>represents</span> some text and the user agent does not
   expect this to change, the element is expected to be treated as a non-replaced phrasing element
-  whose content is the text, optionally with an icon indicating that an image is missing.</p>
+  whose content is the text, optionally with an icon indicating that an image is missing, so that
+  the user can request the image be displayed or investigate why it is not rendering. In
+  non-graphical contexts, such an icon should be omitted.</p>
 
   <p>When an <code>img</code> element <span>represents</span> nothing and the user agent does not
   expect this to change, the element is expected to not be rendered at all.</p>