[html5] r5678 - [e] (0) tweak wording and add an example to make things clearer Fixing http://ww [...]
whatwg at whatwg.org
whatwg at whatwg.org
Wed Nov 10 18:16:04 PST 2010
Author: ianh
Date: 2010-11-10 18:16:02 -0800 (Wed, 10 Nov 2010)
New Revision: 5678
Modified:
complete.html
index
source
Log:
[e] (0) tweak wording and add an example to make things clearer
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10827
Modified: complete.html
===================================================================
--- complete.html 2010-11-11 00:57:10 UTC (rev 5677)
+++ complete.html 2010-11-11 02:16:02 UTC (rev 5678)
@@ -86848,9 +86848,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>
@@ -86881,8 +86879,36 @@
</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>14.7 </span>Print media</h3>
<p>User agents are expected to allow the user to request the
Modified: index
===================================================================
--- index 2010-11-11 00:57:10 UTC (rev 5677)
+++ index 2010-11-11 02:16:02 UTC (rev 5678)
@@ -82762,9 +82762,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>
@@ -82795,8 +82793,36 @@
</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>12.7 </span>Print media</h3>
<p>User agents are expected to allow the user to request the
Modified: source
===================================================================
--- source 2010-11-11 00:57:10 UTC (rev 5677)
+++ source 2010-11-11 02:16:02 UTC (rev 5678)
@@ -99542,10 +99542,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 <span>the directionality</span> of the element from
- which the text was obtained. Text from scripts (e.g. the argument to
- <code title="dom-alert">window.alert()</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">
@@ -99577,8 +99574,40 @@
</div>
+ <p>A string provided by a script (e.g. the argument to <code
+ title="dom-alert">window.alert()</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>Print media</h3>
<p>User agents are expected to allow the user to request the
More information about the Commit-Watchers
mailing list