Skip to content

Commit a025ec5

Browse files
Editorial: Less specific description for dir auto
1 parent de3dcc6 commit a025ec5

File tree

1 file changed

+8
-34
lines changed

1 file changed

+8
-34
lines changed

index.html

+8-34
Original file line numberDiff line numberDiff line change
@@ -446,9 +446,9 @@ <h3>
446446
</h3>
447447
<p>
448448
The [=manifest's=] <code><dfn data-export="" data-dfn-for=
449-
"manifest">dir</dfn></code> member specifies the <dfn>base
450-
direction</dfn> for the <a>localizable members</a> of the
451-
<a>manifest</a>. The [=manifest/dir=] member's value can be set to a
449+
"manifest">dir</dfn></code> member specifies the string direction for
450+
the <a>localizable members</a> of the <a>manifest</a>. The
451+
[=manifest/dir=] member's value can be set to a
452452
<a>text-direction</a>.
453453
</p>
454454
<p>
@@ -487,43 +487,16 @@ <h3>
487487
"<dfn data-dfn-for="text-direction">auto</dfn>" (default)
488488
</dt>
489489
<dd>
490-
<p>
491-
Direction determined from content using <a data-cite=
492-
"UAX9#P2">Rule P2</a> of the [[UAX9]] algorithm.
493-
</p>
494-
<aside class="note">
495-
<p>
496-
[=text-direction/auto=] means that the directionality of each
497-
member is determined by its first strongly directional
498-
character (as per the <a data-cite="UAX9#P2">Rule P2</a>). An
499-
explicit direction value such as "[=text-direction/rtl=]" or
500-
"[=text-direction/ltr=]" is preferred to relying on the default
501-
of "[=text-direction/auto=]".
502-
</p>
503-
</aside>
490+
The user agent SHOULD use heuristics, preferably based on the
491+
Unicode Standard's first-strong detection algorithm, to detect the
492+
base direction of a string.
504493
</dd>
505494
</dl>
506495
<p>
507496
The <dfn>text-direction list</dfn> is the [=list=] «
508497
"[=text-direction/ltr=]", "[=text-direction/rtl=]",
509498
"[=text-direction/auto=]" ».
510499
</p>
511-
<p>
512-
When displaying the <a>localizable members</a> to an end-user, the
513-
use agent SHOULD:
514-
</p>
515-
<ol class="algorithm">
516-
<li>If the <a>base direction</a> is [=text-direction/ltr=] or
517-
[=text-direction/rtl=], override <a data-cite="UAX9#P3">Rule P3</a>
518-
of [[UAX9]], setting the paragraph embedding level to 0 if the
519-
<a>base direction</a> is [=text-direction/ltr=], or 1 if the <a>base
520-
direction</a> is [=text-direction/rtl=].
521-
</li>
522-
<li>Otherwise the <a>base direction</a> is "[=text-direction/auto=]",
523-
in which case determine the text's direction by applying
524-
<a data-cite="UAX9#P1">Rule P1</a> of [[UAX9]].
525-
</li>
526-
</ol>
527500
<p>
528501
To <dfn>process the `dir` member</dfn>, given [=ordered map=]
529502
|json:ordered map| and [=ordered map=] |manifest:ordered map|:
@@ -549,7 +522,8 @@ <h3>
549522
The [=manifest's=] <code><dfn data-export="" data-dfn-for=
550523
"manifest">lang</dfn></code> member is a [=string=] in the form of a
551524
[=language tag=] that specifies the language for the values of the
552-
manifest's [=localizable members=].
525+
manifest's [=localizable members=]. If the `lang` member is not
526+
specified, the language is treated as unknown.
553527
</p>
554528
<p class="note">
555529
Specifying the language improves the user experience by helping

0 commit comments

Comments
 (0)