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 fd6820897f391c5f6c6f65bca4a470f499927879..64b24f712ae9ef1de8546ee1f6a22c7342865212 100644 (file)
--- 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