From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 30 Nov 2024 10:44:01 +0000 (+0200)
Subject: ; Improve documentation of ':box' face attribute
X-Git-Tag: archive/raspbian/1%30.1+1-3+rpi1^2~2^2~20^2~237
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=afb34a3b2393decb50e250ed8caa559b64020379;p=emacs.git

; Improve documentation of ':box' face attribute

* doc/lispref/display.texi (Face Attributes): Describe a subtlety
of displaying ':box'.  (Bug#74536)
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 11faf1dc9a0..5ecca832b68 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2803,7 +2803,11 @@ being pressed.  If it is @code{pressed-button}, the box looks like a
 If you use the @code{:box} face attribute on strings displayed instead
 of buffer text via the @code{display} text property, special
 considerations might apply if the surrounding buffer text also has the
-@code{:box} face attribute.  @xref{Replacing Specs}.
+@code{:box} face attribute.  @xref{Replacing Specs}.  Also note that the
+vertical lines of the box are only drawn when @code{:box} attribute
+changes from @code{nil} to non-@code{nil} or vice versa; two consecutive
+face properties with a non-@code{nil} @code{:box} attribute will be
+displayed without the vertical line between them.
 
 @item :inverse-video
 Whether or not characters should be displayed in inverse video.  The