emacs-29 ca0da3b83df: ; Clarify description of display on the margins

[Eli Zaretskii]

branch: emacs-29
commit ca0da3b83dfc4a366978c9cd17db7a212a83f6d3
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; 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)
---
 doc/lispref/display.texi | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

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