- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 11 Nov 2010 02:16:13 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27680
Modified Files:
Overview.html
Log Message:
tweak wording and add an example to make things clearer (whatwg r5678)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4544
retrieving revision 1.4545
diff -u -d -r1.4544 -r1.4545
--- Overview.html 11 Nov 2010 01:27:04 -0000 1.4544
+++ Overview.html 11 Nov 2010 02:16:09 -0000 1.4545
@@ -65625,9 +65625,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="#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="#dom-alert">window.alert()</a></code>) is expected to be
- rendered as a separate bidirectional algorithm paragraph. <a href="#refsBIDI">[BIDI]</a></p>
+ which the text was obtained.</p>
<div class="example">
@@ -65658,6 +65656,34 @@
</div>
+ <p>A string provided by a script (e.g. the argument to <code title="dom-alert"><a href="#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="#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">لا أفهم</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">لا أفهم! derF ,kO, لا أفهم, rac eht teg lliw amliW 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>
Received on Thursday, 11 November 2010 02:16:15 UTC