[html5] r3271 - [a] (0) Include a note about the dangers of ASCII art.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-06-15 18:01:49 -0700 (Mon, 15 Jun 2009)
New Revision: 3271

Modified:
   index
   source
Log:
[a] (0) Include a note about the dangers of ASCII art.

Modified: index
===================================================================
--- index	2009-06-16 01:00:14 UTC (rev 3270)
+++ index	2009-06-16 01:01:49 UTC (rev 3271)
@@ -12788,9 +12788,16 @@
    <li>Including fragments of computer code, with structure indicated
    according to the conventions of that language.</li>
 
-   <li>Displaying ASCII art.</li> <!-- XXX need a note about non-visual UAs -->
+   <li>Displaying ASCII art.</li>
 
-  </ul><p>To represent a block of computer code, the <code><a href=#the-pre-element>pre</a></code>
+  </ul><p class=note>Authors are encouraged to consider how preformatted
+  text will be experienced when the formatting is lost, as will be the
+  case for users of speech synthesizers, braille displays, and the
+  like. For cases like ASCII art, it is likely that an alternative
+  presentation, such as a textual description, would be more
+  universally accessible to the readers of the document.</p>
+
+  <p>To represent a block of computer code, the <code><a href=#the-pre-element>pre</a></code>
   element can be used with a <code><a href=#the-code-element>code</a></code> element; to represent a
   block of computer output the <code><a href=#the-pre-element>pre</a></code> element can be used
   with a <code><a href=#the-samp-element>samp</a></code> element. Similarly, the <code><a href=#the-kbd-element>kbd</a></code>

Modified: source
===================================================================
--- source	2009-06-16 01:00:14 UTC (rev 3270)
+++ source	2009-06-16 01:01:49 UTC (rev 3271)
@@ -13517,10 +13517,17 @@
    <li>Including fragments of computer code, with structure indicated
    according to the conventions of that language.</li>
 
-   <li>Displaying ASCII art.</li> <!-- XXX need a note about non-visual UAs -->
+   <li>Displaying ASCII art.</li>
 
   </ul>
 
+  <p class="note">Authors are encouraged to consider how preformatted
+  text will be experienced when the formatting is lost, as will be the
+  case for users of speech synthesizers, braille displays, and the
+  like. For cases like ASCII art, it is likely that an alternative
+  presentation, such as a textual description, would be more
+  universally accessible to the readers of the document.</p>
+
   <p>To represent a block of computer code, the <code>pre</code>
   element can be used with a <code>code</code> element; to represent a
   block of computer output the <code>pre</code> element can be used