diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index c022321f8dc..65e462576da 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -783,7 +783,7 @@ Most windows do not have a header line---only some special modes, such
 Info mode, create one.
 
 The @code{header-line-active} and @code{header-line-inactive} faces (which
-are the ones used on the header lines) inherit from this face.
+are the ones actually used on the header lines) inherit from this face.
 
 @cindex faces for header lines
 @item header-line-active
diff --git a/etc/NEWS b/etc/NEWS
index cb2ba2a78ff..048a90be560 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -163,9 +163,10 @@ obsolete.  Use 'M-x list-packages' to install the 'idlwave' package from
 GNU ELPA instead.
 
 +++
-** New face 'header-line-active'.
-This inherits from the 'header-line' face, but is the face actually used
-on the header lines (along with 'header-line-inactive').
+** New faces 'header-line-active' and 'header-line-inactive'.
+These inherit from the 'header-line' face, but the faces actually used
+on the header lines are now these two: the selected window uses
+'header-line-active', non-selected windows use 'header-line-inactive'.
 
 
 * Editing Changes in Emacs 31.1