# HG changeset patch
# User Eli Zaretskii <eliz@gnu.org>
# Date 1274180336 -10800
# Node ID 6b0a523f9990b902e499d9f9db0d0f8540be849a
# Parent  f5b2fcb51f423c0dc2ca4ff8927d1e7ff4d1ad27
Document bidi-aware behavior of arrow keys and display features.
 display.texi (Fringes): Document reversal of fringe arrows for R2L
 paragraphs.
 (Line Truncation): Fix wording for bidi display.
 basic.texi (Moving Point): Document bidi-aware behavior of the arrow keys.

diff -r f5b2fcb51f42 -r 6b0a523f9990 doc/emacs/ChangeLog
--- a/doc/emacs/ChangeLog	Tue May 18 10:33:29 2010 +0200
+++ b/doc/emacs/ChangeLog	Tue May 18 13:58:56 2010 +0300
@@ -1,3 +1,12 @@
+2010-05-18  Eli Zaretskii  <eliz@gnu.org>
+
+	* display.texi (Fringes): Document reversal of fringe arrows for R2L
+	paragraphs.
+	(Line Truncation): Fix wording for bidi display.
+
+	* basic.texi (Moving Point): Document bidi-aware behavior of he arrow
+	keys.
+
 2010-05-08  Chong Yidong  <cyd@stupidchicken.com>
 
 	* building.texi (GDB Graphical Interface): Remove misleading comparison
diff -r f5b2fcb51f42 -r 6b0a523f9990 doc/emacs/basic.texi
--- a/doc/emacs/basic.texi	Tue May 18 10:33:29 2010 +0200
+++ b/doc/emacs/basic.texi	Tue May 18 13:58:56 2010 +0300
@@ -146,6 +146,8 @@
 @findex move-end-of-line
 @findex forward-char
 @findex backward-char
+@findex right-arrow-command
+@findex left-arrow-command
 @findex next-line
 @findex previous-line
 @findex beginning-of-buffer
@@ -161,11 +163,19 @@
 @itemx @key{End}
 Move to the end of the line (@code{move-end-of-line}).
 @item C-f
-@itemx @key{right}
 Move forward one character (@code{forward-char}).
+@item @key{right}
+Move one character to the right (@code{right-arrow-command}).  This
+moves one character forward in text that is read in the usual
+left-to-right direction, but one character @emph{backward} if the text
+is read right-to-left, as needed for right-to-left scripts such as
+Arabic.  @xref{Bidirectional Editing}.
 @item C-b
-@itemx @key{left}
 Move backward one character (@code{backward-char}).
+@item @key{left}
+Move one character to the left (@code{left-arrow-command}).  This
+moves one character backward in left-to-right text and one character
+forward in right-to-left text.
 @item M-f
 @itemx M-@key{right}
 @itemx C-@key{right}
diff -r f5b2fcb51f42 -r 6b0a523f9990 doc/emacs/display.texi
--- a/doc/emacs/display.texi	Tue May 18 10:33:29 2010 +0200
+++ b/doc/emacs/display.texi	Tue May 18 13:58:56 2010 +0300
@@ -804,7 +804,10 @@
 screen.  The left fringe shows a curving arrow for each screen line
 except the first, indicating that ``this is not the real beginning.''
 The right fringe shows a curving arrow for each screen line except the
-last, indicating that ``this is not the real end.''
+last, indicating that ``this is not the real end.''  If the line's
+direction is right-to-left (@pxref{Bidirectional Editing}), the
+meaning of the curving arrows in the left and right fringes are
+swapped.
 
   The fringes indicate line truncation with short horizontal arrows
 meaning ``there's more text on this line which is scrolled
@@ -1191,8 +1194,8 @@
 characters that do not fit in the width of the screen or window do not
 appear at all.  On graphical displays, a small straight arrow in the
 fringe indicates truncation at either end of the line.  On text-only
-terminals, @samp{$} appears in the first column when there is text
-truncated to the left, and in the last column when there is text
+terminals, @samp{$} appears in the leftmost column when there is text
+truncated to the left, and in the rightmost column when there is text
 truncated to the right.
 
 @vindex truncate-lines