Note caveat about remapping basic faces

* doc/lispref/display.texi (Face Remapping): Note caveat about
basic faces (bug#53636).

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index b749d3d892293b44b9a30fcfd84338a9447d9a85..280ea534555f1a7a1de833fab4e401c11d32d75c 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -3320,6 +3320,13 @@ if you need to remove the remapping later.
 ;; Increase the size of the 'default' face by 50%:
 (face-remap-add-relative 'default :height 1.5)
 @end example
+
+Note that face remapping does not work reliably parent faces of
+@dnf{basic faces}.  (These are the faces that are used in mode lines,
+header lines and the like.)  For instance, @code{mode-line-inactive}
+inherits from @code{mode-line}, but remapping @code{mode-line} won't
+normally have the desired effect on @code{mode-line-inactive}.
+Instead you have to remap @code{mode-line-inactive} directly.
 @end defun
 
 @defun face-remap-remove-relative cookie

diff --git a/etc/NEWS b/etc/NEWS
index cd8cec32d5d0f5441386ac833d6a81768032a292..657088c98dea2c37cdc2036e6db3eb468c9c90a5 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -992,6 +992,12 @@ Emacs buffers, like indentation and the like.  The new ert function
 \f
 * Incompatible Lisp Changes in Emacs 29.1
 
++++
+** Remapping 'mode-line' no longer works as expected.
+'mode-line' is now the parent face of the new 'mode-line-active' face,
+and remapping parent of basic faces does not work reliably.
+Instead of remapping 'mode-line', you have to remap 'mode-line-active'.
+
 ** User option 'mail-source-ignore-errors' is now obsolete.
 The whole mechanism for prompting users to continue in case of
 mail-source errors has been removed, so this option is no longer