right-char and left-char

[Chong Yidong <cyd@stupidchicken.com>]

In the Emacs manual, the documentation for right-char says:

`<right>'
     Move one character to the right (`right-char').  This moves one
     character forward in text that is read in the usual left-to-right
     direction, but one character _backward_ if the text is read
     right-to-left, as needed for right-to-left scripts such as Arabic.

But in fact, the directionality of right-char and left-char depends on
current-bidi-paragraph-direction.  If you have RTL text embedded in LTR
paragraphs, like in the HELLO file, <right> moves left while in the RTL
segment.  This contradicts the manual description, which merely states
"if the text is read right-to-left".

Which is the intended behavior?