@c This is part of the Emacs manual.
-@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997, 2000, 2001, 2002
+@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997, 2000, 2001, 2002, 2005
@c Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Display, Search, Registers, Top
@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.
+@item vertical-border
+This face is used for the vertical divider between windows on
+character terminals. By default this face inherits from the
+@code{mode-line-inactive} face.
@item minibuffer-prompt
This face is used for the prompt strings displayed in the minibuffer.
@item highlight
This face is used for highlighting portions of text, in various modes.
For example, mouse-sensitive text is highlighted using this face.
+@item mode-line-highlight
+Like @code{highlight}, but used for portions of text on mode lines.
@item isearch
This face is used for highlighting Isearch matches.
@item lazy-highlight
Whitespace}.
@item variable-pitch
The basic variable-pitch face.
+@item shadow
+The basic face for making the text less noticeable than the surrounding
+ordinary text. Usually this is achieved by using shades of grey in
+contrast with either black or white default foreground color.
@end table
@cindex @code{region} face
for more information about Transient Mark mode and activation and
deactivation of the mark.
- One easy way to use faces is to turn on Font Lock mode. This minor
-mode, which is always local to a particular buffer, arranges to
-choose faces according to the syntax of the text you are editing. It
-can recognize comments and strings in most languages; in several
-languages, it can also recognize and properly highlight various other
-important constructs. @xref{Font Lock}, for more information about
-Font Lock mode and syntactic highlighting.
+ One easy way to use faces is to turn on Font Lock mode. @xref{Font
+Lock}, for more information about Font Lock mode and syntactic
+highlighting.
You can print out the buffer with the highlighting that appears
on your screen using the command @code{ps-print-buffer-with-faces}.
@findex font-lock-mode
@findex turn-on-font-lock
- The command @kbd{M-x font-lock-mode} turns Font Lock mode on or off
-according to the argument, and toggles the mode when it has no argument.
-The function @code{turn-on-font-lock} unconditionally enables Font Lock
-mode. This is useful in mode-hook functions. For example, to enable
-Font Lock mode whenever you edit a C file, you can do this:
+ The command @kbd{M-x font-lock-mode} turns Font Lock mode on with
+positive argument, off with negative or zero argument, and toggles the
+mode when it has no argument. The function @code{turn-on-font-lock}
+unconditionally enables Font Lock mode. This is useful in mode-hook
+functions. For example, to enable Font Lock mode whenever you edit a
+C file, you can do this:
@example
(add-hook 'c-mode-hook 'turn-on-font-lock)
@findex global-font-lock-mode
@vindex global-font-lock-mode
To turn on Font Lock mode automatically in all modes which support
-it, customize the variable @code{global-font-lock-mode} or use the
-function @code{global-font-lock-mode} in your @file{.emacs} file, like
-this:
+it, customize the variable @code{global-font-lock-mode} using the
+Customize interface (@pxref{Easy Customization}) or use the function
+@code{global-font-lock-mode} in your @file{.emacs} file, like this:
@example
(global-font-lock-mode 1)
portion of a buffer. As you scroll through the buffer, each portion
that becomes visible is fontified as soon as it is displayed. The
parts of the buffer that are not displayed are fontified
-``stealthily'', in the background, i.e.@: when Emacs is idle. You can
+``stealthily,'' in the background, i.e.@: when Emacs is idle. You can
control this background fontification, also called @dfn{Just-In-Time}
(or @dfn{JIT}) Lock, by customizing variables in the customization
group @samp{jit-lock}. @xref{Specific Customization}.
meaning ``there's more text on this line which is scrolled
horizontally out of view;'' clicking the mouse on one of the arrows
scrolls the display horizontally in the direction of the arrow. The
-fringes also indicate other things such as empty lines, or where a
+fringes can also indicate other things, such as empty lines, or where a
program you are debugging is executing (@pxref{Debuggers}).
@findex set-fringe-style
delete-trailing-whitespace @key{RET}}. (This command does not remove
the form-feed characters.)
-@vindex indicate-unused-lines
+@vindex indicate-empty-lines
@vindex default-indicate-empty-lines
@cindex unused lines
@cindex fringes, and unused line indication
this image in the fringe.
To enable this feature, set the buffer-local variable
-@code{indicate-unused-lines} to a non-@code{nil} value. The default
+@code{indicate-empty-lines} to a non-@code{nil} value. The default
value of this variable is controlled by the variable
-@code{default-indicate-unused-lines}; by setting that variable, you
+@code{default-indicate-empty-lines}; by setting that variable, you
can enable or disable this feature for all new buffers. (This feature
currently doesn't work on character terminals.)
of columns (you specify how many columns). You can use this to get an
overview of a part of a program.
- To hide lines, type @kbd{C-x $} (@code{set-selective-display}) with a
-numeric argument @var{n}. Then lines with at least @var{n} columns of
-indentation disappear from the screen. The only indication of their
-presence is that three dots (@samp{@dots{}}) appear at the end of each
-visible line that is followed by one or more hidden ones.
+ To hide lines in the current buffer, type @kbd{C-x $}
+(@code{set-selective-display}) with a numeric argument @var{n}. Then
+lines with at least @var{n} columns of indentation disappear from the
+screen. The only indication of their presence is that three dots
+(@samp{@dots{}}) appear at the end of each visible line that is
+followed by one or more hidden ones.
The commands @kbd{C-n} and @kbd{C-p} move across the hidden lines as
if they were not there.
them), otherwise as escape sequences. @xref{Single-Byte Character
Support}.
+@vindex nobreak-char-display
+@cindex nobreak space, display
+@cindex nobreak hyphen, display
+ Some character sets define ``no-break'' versions of the space and
+hyphen characters, which are used where a line should not be broken.
+Emacs normally displays these characters with special faces
+(respectively, @code{nobreak-space} and @code{escape-glyph}) to
+distinguish them from ordinary spaces and hyphens. You can turn off
+this feature by setting the variable @code{nobreak-char-display} to
+@code{nil}. If you set the variable to any other value, that means to
+prefix these characters with an escape character.
+
@node Cursor Display
@section Displaying the Cursor
The @var{indicator} must be one of @code{top}, @code{bottom},
@code{up}, @code{down}, or @code{t} which specifies the default
position for the indicators not present in the alist.
-The @var{position} is one of @code{left}, @code{right}, or @code{ni}
+The @var{position} is one of @code{left}, @code{right}, or @code{nil}
which specifies not to show this indicator.
For example, @code{((top . left) (t . right))} places the top angle