From: Eli Zaretskii <eliz@gnu.org>
Date: Mon, 5 Dec 2022 19:45:01 +0000 (+0200)
Subject: ; Clarify description of display on the margins
X-Git-Tag: emacs-29.0.90~1348
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ca0da3b83dfc4a366978c9cd17db7a212a83f6d3;p=emacs.git

; Clarify description of display on the margins

* doc/lispref/display.texi (Display Margins): More accurate
explanation of how to show text in the display margin without
concealing buffer text.  (Bug#59841)
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 9d929950a7e..340aa400cfa 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -5467,8 +5467,9 @@ or an image descriptor.
 
   To display something in the margin @emph{in association with}
 certain buffer text, without altering or preventing the display of
-that text, put a @code{before-string} property on the text and put the
-margin display specification on the contents of the before-string.
+that text, put on that text an overlay with a @code{before-string}
+property, and put the margin display specification on the contents of
+the before-string.
 
   Note that if the string to be displayed in the margin doesn't
 specify a face, its face is determined using the same rules and