From: Eli Zaretskii <eliz@gnu.org>
Date: Mon, 30 Sep 2019 07:49:50 +0000 (+0300)
Subject: Improve description of face merging
X-Git-Tag: emacs-27.0.90~1355
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1e19ee781bf6aae4da32845acc6603d07a2d9c3c;p=emacs.git

Improve description of face merging

* doc/lispref/display.texi (Displaying Faces): More accurate
description of merging face attributes of "underlying text".
(Bug#1222)
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index fd6820897f3..64b24f712ae 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2949,11 +2949,12 @@ For a header line, Emacs applies the @code{header-line} face.
 If the text comes from an overlay string via @code{before-string} or
 @code{after-string} properties (@pxref{Overlay Properties}), or from a
 display string (@pxref{Other Display Specs}), and the string doesn't
-contain a @code{face} or @code{mouse-face} property, but the buffer
-text affected by the overlay/display property does define a face,
-Emacs applies the face attributes of the ``underlying'' buffer text.
-Note that this is so even if the overlay or display string is
-displayed in the display margins (@pxref{Display Margins}).
+contain a @code{face} or @code{mouse-face} property, or these
+properties leave some face attributes undefined, but the buffer text
+affected by the overlay/display property does define a face or those
+attributes, Emacs applies the face attributes of the ``underlying''
+buffer text.  Note that this is so even if the overlay or display
+string is displayed in the display margins (@pxref{Display Margins}).
 
 @item
 If any given attribute has not been specified during the preceding