From: Richard M. Stallman <rms@gnu.org>
Date: Mon, 24 Dec 2001 16:29:42 +0000 (+0000)
Subject: Explain using a before-string to put something in the margin.
X-Git-Tag: ttn-vms-21-2-B4~17507
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=78263139246753c3b49a8dbf7a8ed18cf342e808;p=emacs.git

Explain using a before-string to put something in the margin.
---

diff --git a/lispref/display.texi b/lispref/display.texi
index 13cea17b514..afdbc347d61 100644
--- a/lispref/display.texi
+++ b/lispref/display.texi
@@ -2356,6 +2356,14 @@ display specification of the form @code{(margin right-margin)} or
 use that display specification along with the display specification for
 the image.
 
+  If you put such a display specification directly on text in the
+buffer, the specified margin display appears @emph{instead of} that
+buffer text itself.  To put something in the margin @emph{in
+association with} certain buffer text without preventing or altering
+the display of that text, put a @code{before-string} property on the
+text and put the display specification on the contents of the
+before-string.
+
   Before the display margins can display anything, you must give
 them a nonzero width.  The usual way to do that is to set these
 variables: