changeset 43260:59e700c2760c

(Faces): Document the mode-line-inactive face. (Optional Mode Line): Document the mode-line-in-non-selected-windows variable.
author Eli Zaretskii <eliz@gnu.org>
date Tue, 12 Feb 2002 18:51:31 +0000
parents 71c7c34c4f6b
children d91a628dadfe
files man/display.texi
diffstat 1 files changed, 21 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- 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)