# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1130091491 0
# Node ID 8ad92df59512ed0479bd610c5e4ec156facf33e2
# Parent  72170abe8953c21a2e696f43fc3adf4e66733368
(Overlay Arrow): Clarify about local bindings of overlay-arrow-position.

diff -r 72170abe8953 -r 8ad92df59512 lispref/display.texi
--- a/lispref/display.texi	Sun Oct 23 18:01:25 2005 +0000
+++ b/lispref/display.texi	Sun Oct 23 18:18:11 2005 +0000
@@ -2922,9 +2922,12 @@
 usually begins with indentation, normally nothing significant is
 overwritten.
 
-The overlay string is displayed only in the buffer that this marker
-points into.  Thus, only one buffer can have an overlay arrow at any
-given time.
+The overlay-arrow string is displayed in any given buffer if the value
+of @code{overlay-arrow-position} in that buffer points into that
+buffer.  Thus, it works to can display multiple overlay arrow strings
+by creating buffer-local bindings of @code{overlay-arrow-position}.
+However, it is usually cleaner to use
+@code{overlay-arrow-variable-list} to achieve this result.
 @c !!! overlay-arrow-position: but the overlay string may remain in the display
 @c of some other buffer until an update is required.  This should be fixed
 @c now.  Is it?