# HG changeset patch
# User Eli Zaretskii <eliz@gnu.org>
# Date 1013539891 0
# Node ID 59e700c2760c5c8fd7f72e8c6ede524d8d33ea83
# Parent  71c7c34c4f6b7ed5b184f14ba1f305eff26ef8db
(Faces): Document the mode-line-inactive face.
(Optional Mode Line): Document the mode-line-in-non-selected-windows
variable.

diff -r 71c7c34c4f6b -r 59e700c2760c man/display.texi
--- a/man/display.texi	Tue Feb 12 18:18:08 2002 +0000
+++ b/man/display.texi	Tue Feb 12 18:51:31 2002 +0000
@@ -100,9 +100,14 @@
 @item default
 This face is used for ordinary text that doesn't specify any other face.
 @item mode-line
-This face is used for mode lines.  By default, it's drawn with shadows
-for a ``raised'' effect on window systems, and drawn as the inverse of
-the default face on non-windowed terminals.  @xref{Display Custom}.
+This face is used for the mode line of the currently selected window.
+By default, it's drawn with shadows for a ``raised'' effect on window
+systems, and drawn as the inverse of the default face on non-windowed
+terminals.  @xref{Display Custom}.
+@item mode-line-inactive
+Like @code{mode-line}, but used for mode lines of the windows other
+than the selected one (if @code{mode-line-in-non-selected-windows} is
+non-@code{nil}).
 @item header-line
 Similar to @code{mode-line} for a window's header line.  Most modes
 don't use the header line, but the Info mode does.
@@ -784,6 +789,19 @@
 Emacs.mode-line.AttributeBox: off
 @end example
 
+@cindex non-selected windows, mode line appearance
+@vindex mode-line-in-non-selected-windows
+  By default, the mode line of non-selected windows is displayed in a
+different face, called @code{mode-line-inactive}.  You can control
+this behavior by customizing the value of the variable
+@code{mode-line-in-non-selected-windows}.  If its value is
+non-@code{nil}, non-selected windows are displayed in the
+@code{mode-line-inactive} face.  If the value is @code{t}, the
+selected window is displayed in the @code{mode-line} face even when
+you type at the minibuffer prompt.  If the value is @code{nil}, all
+mode lines are displayed in the @code{mode-line} face, even when the
+window is not selected.  The default is @code{t}.
+
 @node Text Display
 @section How Text Is Displayed
 @cindex characters (in text)