html5/spec rendering.html,1.54,1.55 spec.html,1.1324,1.1325

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv31062

Modified Files:
	rendering.html spec.html 
Log Message:
tweak wording and add an example to make things clearer (whatwg r5678)

[updated by splitter]


Index: rendering.html
===================================================================
RCS file: /sources/public/html5/spec/rendering.html,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -d -r1.54 -r1.55
--- rendering.html	11 Nov 2010 01:47:01 -0000	1.54
+++ rendering.html	11 Nov 2010 02:46:43 -0000	1.55
@@ -3531,9 +3531,7 @@
   menus, and tooltips. Text from elements (either attribute values or
   the contents of elements) is expected to be rendered in a manner
   that honors <a href="elements.html#the-directionality">the directionality</a> of the element from
-  which the text was obtained. Text from scripts (e.g. the argument to
-  <code title="dom-alert"><a href="timers.html#dom-alert">window.alert()</a></code>) is expected to be
-  rendered as a separate bidirectional algorithm paragraph. <a href="references.html#refsBIDI">[BIDI]</a></p>
+  which the text was obtained.</p>
 
   <div class="example">
 
@@ -3564,6 +3562,34 @@
 
   </div>
 
+  <p>A string provided by a script (e.g. the argument to <code title="dom-alert"><a href="timers.html#dom-alert">window.alert()</a></code>) is expected to be treated
+  as an independent set of one or more bidirectional algorithm
+  paragraphs when displayed, as defined by the bidirectional
+  algorithm, including, for instance, supporting the
+  paragraph-breaking behaviour of U+000A LINE FEED (LF) characters. <a href="references.html#refsBIDI">[BIDI]</a></p>
+
+  <div class="example">
+
+    <p>For example, consider the following script:</p>
+
+    <pre>var s;
+if (s = prompt('What is your name?')) {
+  alert(s + '! Ok, Fred, ' + s + ', and Wilma will get the car.');
+}</pre>
+
+    <p>When the user enters "<kbd>Kitty</kbd>", the user agent would
+    alert "<samp>Kitty! Ok, Fred, Kitty, and Wilma will get the
+    car.</samp>". However, if the user enters "<kbd dir="rtl" lang="ar">&#1604;&#1575;&#160;&#1571;&#1601;&#1607;&#1605;</kbd>",
+    then the bidirectional algorithm will determine that the direction
+    of the paragraph is right-to-left, and so the output will be
+    "<samp lang=""><bdo dir="rtl">&#1604;&#1575;&#160;&#1571;&#1601;&#1607;&#1605;!&#160;derF&#160;,kO,&#160;&#1604;&#1575;&#160;&#1571;&#1601;&#1607;&#1605;,&#160;rac&#160;eht&#160;teg&#160;lliw&#160;amliW&#160;dna.</bdo></samp>"!</p>
+
+    <p>Authors can enforce a particular interpretation by using the
+    Unicode U+200E LEFT-TO-RIGHT MARK and U+200F RIGHT-TO-LEFT MARK
+    characters.</p>
+
+  </div>
+
 
 
   <h3 id="print-media"><span class="secno">10.7 </span>Print media</h3>

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1324
retrieving revision 1.1325
diff -u -d -r1.1324 -r1.1325
--- spec.html	11 Nov 2010 01:47:02 -0000	1.1324
+++ spec.html	11 Nov 2010 02:46:43 -0000	1.1325
@@ -385,7 +385,7 @@
     <a href="Overview.html">single page HTML</a>,
     <a href="spec.html">multipage HTML</a>,
     <a href="author/">web developer edition</a>.
-This is revision 1.4544.
+This is revision 1.4545.
    </p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2010 <a href="http://www.w3.org/"><abbr title="World Wide

Received on Thursday, 11 November 2010 02:46:47 UTC