From: Richard M. Stallman <rms@gnu.org>
Date: Sun, 23 Oct 2005 18:18:11 +0000 (+0000)
Subject: (Overlay Arrow): Clarify about local bindings of overlay-arrow-position.
X-Git-Tag: emacs-pretest-22.0.90~6381
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=751fc7d9089a9c050ce8fd11a8f10179391fb15b;p=emacs.git

(Overlay Arrow): Clarify about local bindings of overlay-arrow-position.
---

diff --git a/lispref/display.texi b/lispref/display.texi
index ba27b900cdb..75a64924516 100644
--- a/lispref/display.texi
+++ b/lispref/display.texi
@@ -2922,9 +2922,12 @@ otherwise appear.  Since the arrow is usually short, and the line
 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?