display.texi 50.9 KB
Newer Older
1
@c This is part of the Emacs manual.
2
@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997, 2000, 2001, 2002, 2005
3
@c   Free Software Foundation, Inc.
Dave Love's avatar
#  
Dave Love committed
4 5 6 7 8 9 10 11 12 13
@c See file emacs.texi for copying conditions.
@node Display, Search, Registers, Top
@chapter Controlling the Display

  Since only part of a large buffer fits in the window, Emacs tries to
show a part that is likely to be interesting.  Display-control commands
allow you to specify which part of the text you want to see, and how to
display it.

@menu
14
* Faces::	           How to change the display style using faces.
15
* Standard Faces::         Emacs' predefined faces.
16 17 18
* Font Lock::              Minor mode for syntactic highlighting using faces.
* Highlight Changes::      Using colors to show where you changed the buffer.
* Highlight Interactively:: Tell Emacs what text to highlight.
Dave Love's avatar
#  
Dave Love committed
19 20
* Scrolling::	           Moving text up and down in a window.
* Horizontal Scrolling::   Moving text left and right in a window.
21 22
* Fringes::                Enabling or disabling window fringes.
* Useless Whitespace::     Showing possibly-spurious trailing whitespace.
Dave Love's avatar
#  
Dave Love committed
23 24 25 26
* Follow Mode::            Follow mode lets two windows scroll as one.
* Selective Display::      Hiding lines with lots of indentation.
* Optional Mode Line::     Optional mode line display features.
* Text Display::           How text characters are normally displayed.
27
* Cursor Display::         Features for displaying the cursor.
Richard M. Stallman's avatar
Richard M. Stallman committed
28
* Display Custom::         Information on variables for customizing display.
Dave Love's avatar
#  
Dave Love committed
29 30
@end menu

31 32 33 34
@node Faces
@section Using Multiple Typefaces
@cindex faces

Richard M. Stallman's avatar
Richard M. Stallman committed
35 36 37 38 39 40
  You can specify various styles for displaying text using
@dfn{faces}.  Each face can specify various @dfn{face attributes},
such as the font family, the height, weight and slant of the
characters, the foreground and background color, and underlining or
overlining.  A face does not have to specify all of these attributes;
often it inherits most of them from another face.
41 42 43 44 45 46

  On a window system, all the Emacs face attributes are meaningful.
On a character terminal, only some of them work.  Some character
terminals support inverse video, bold, and underline attributes; some
support colors.  Character terminals generally do not support changing
the height and width or the font family.
47

48 49 50 51 52 53
  The easiest 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}.  @xref{PostScript}.

54 55 56 57 58 59 60
  Features which rely on text in multiple faces (such as Font Lock mode)
will also work on non-windowed terminals that can display more than one
face, whether by colors or underlining and emboldening.  This includes
the console on GNU/Linux, an @code{xterm} which supports colors, the
MS-DOS display (@pxref{MS-DOS}), and the MS-Windows version invoked with
the @option{-nw} option.  Emacs determines automatically whether the
terminal has this capability.
61

62 63 64 65
  You control the appearance of a part of the text in the buffer by
specifying the face or faces to use for it.  The style of display used
for any given character is determined by combining the attributes of
all the applicable faces specified for that character.  Any attribute
Richard M. Stallman's avatar
Richard M. Stallman committed
66
that isn't specified by these faces is taken from the @code{default} face,
67
whose attributes reflect the default settings of the frame itself.
68 69

  Enriched mode, the mode for editing formatted text, includes several
70 71 72 73
commands and menus for specifying faces for text in the buffer.
@xref{Format Faces}, for how to specify the font for text in the
buffer.  @xref{Format Colors}, for how to specify the foreground and
background color.
74 75 76 77

@cindex face colors, setting
@findex set-face-foreground
@findex set-face-background
78 79
  To alter the appearance of a face, use the customization buffer.
@xref{Face Customization}.  You can also use X resources to specify
80
attributes of particular faces (@pxref{Resources}).  Alternatively,
81 82 83 84
you can change the foreground and background colors of a specific face
with @kbd{M-x set-face-foreground} and @kbd{M-x set-face-background}.
These commands prompt in the minibuffer for a face name and a color
name, with completion, and then set that face to use the specified
85 86 87 88 89
color.  Changing the colors of the @code{default} face also changes
the foreground and background colors on all frames, both existing and
those to be created in the future.  (You can also set foreground and
background colors for the current frame only; see @ref{Frame
Parameters}.)
90

91 92 93 94 95 96 97 98
  Emacs can correctly display variable-width fonts, but Emacs commands
that calculate width and indentation do not know how to calculate
variable widths.  This can sometimes lead to incorrect results when
you use variable-width fonts.  In particular, indentation commands can
give inconsistent results, so we recommend you avoid variable-width
fonts for editing program source code.  Filling will sometimes make
lines too long or too short.  We plan to address these issues in
future Emacs versions.
99

100 101 102
@node Standard Faces
@section Standard Faces

103
@findex list-faces-display
104 105 106 107 108
  To see what faces are currently defined, and what they look like,
type @kbd{M-x list-faces-display}.  It's possible for a given face to
look different in different frames; this command shows the appearance
in the frame in which you type it.  Here are the standard faces
for specifying text appearance:
109 110 111 112

@table @code
@item default
This face is used for ordinary text that doesn't specify any other face.
113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
@item bold
This face uses a bold variant of the default font, if it has one.
@item italic
This face uses an italic variant of the default font, if it has one.
@item bold-italic
This face uses a bold italic variant of the default font, if it has one.
@item underline
This face underlines text.
@item fixed-pitch
The basic fixed-pitch face.
@item variable-pitch
The basic variable-pitch face.
@end table

  Here's an incomplete list of faces used to highlight parts of the
text temporarily for specific purposes.  (Many other modes define
their own faces for this purpose.)

@table @code
@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
This face is used for lazy highlighting of Isearch and Query Replace
matches other than the current one.
@item region
This face is used for displaying a selected region (when Transient Mark
mode is enabled---see below).
@item secondary-selection
This face is used for displaying a secondary X selection (@pxref{Secondary
Selection}).
@item trailing-whitespace
The face for highlighting trailing whitespace when
@code{show-trailing-whitespace} is non-@code{nil}; see @ref{Useless
Whitespace}.
@item nobreak-space
The face for displaying the character ``nobreak space''.
@item escape-glyph
The face for highlighting the @samp{\} or @samp{^} that indicates
a control character.  It's also used when @samp{\} indicates a
nobreak space or nobreak (soft) hyphen.
@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
  When Transient Mark mode is enabled, the text of the region is
highlighted when the mark is active.  This uses the face named
@code{region}; you can control the style of highlighting by changing the
style of this face (@pxref{Face Customization}).  @xref{Transient Mark},
for more information about Transient Mark mode and activation and
deactivation of the mark.

  These faces control the appearance of parts of the Emacs frame.
They exist as faces to provide a consistent way to customize the
appearance of these parts of the frame.

@table @code
177
@item mode-line
178 179 180
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
181
terminals.
182 183 184
@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
Richard M. Stallman's avatar
Richard M. Stallman committed
185 186
non-@code{nil}).  This face inherits from @code{mode-line}, so changes
in that face affect mode lines in all windows.
187 188 189
@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.
190
@item vertical-border
191 192 193
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.
194 195
@item minibuffer-prompt
This face is used for the prompt strings displayed in the minibuffer.
196 197 198 199
@item fringe
@cindex fringe
The face for the fringes to the left and right of windows on graphic
displays.  (The fringes are the narrow portions of the Emacs frame
200
between the text area and the window's right and left borders.)
201
@xref{Fringes}.
202 203
@item scroll-bar
This face determines the visual appearance of the scroll bar.
204
@xref{Scroll Bars}.
205 206 207 208 209 210 211 212
@item border
This face determines the color of the frame border.
@item cursor
This face determines the color of the cursor.
@item mouse
This face determines the color of the mouse pointer.
@item tool-bar
This is the basic tool-bar face.  No text appears in the tool bar, but the
213
colors of this face affect the appearance of tool bar icons.  @xref{Tool Bars}.
214
@item tooltip
215
This face is used for tooltips.  @xref{Tooltips}.
216 217 218
@item menu
This face determines the colors and font of Emacs's menus.  Setting the
font of LessTif/Motif menus is currently not supported; attempts to set
219
the font are ignored in this case.  @xref{Menu Bars}.
220 221 222 223 224 225 226 227
@end table

@node Font Lock
@section Font Lock mode
@cindex Font Lock mode
@cindex mode, Font Lock
@cindex syntax highlighting and coloring

228
  Font Lock mode is a minor mode, always local to a particular buffer,
Richard M. Stallman's avatar
Richard M. Stallman committed
229
which highlights (or ``fontifies'') the buffer contents according to
230 231 232 233 234 235
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---for
example, names of functions being defined or reserved keywords.
Some special modes, such as Occur mode and Info mode, have completely
specialized ways of assigning fonts for Font Lock mode.
236 237 238

@findex font-lock-mode
@findex turn-on-font-lock
Luc Teirlinck's avatar
Luc Teirlinck committed
239 240 241 242 243 244
  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:
245 246 247 248 249 250 251 252

@example
(add-hook 'c-mode-hook 'turn-on-font-lock)
@end example

@findex global-font-lock-mode
@vindex global-font-lock-mode
  To turn on Font Lock mode automatically in all modes which support
Luc Teirlinck's avatar
Luc Teirlinck committed
253 254 255
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:
256 257 258 259 260

@example
(global-font-lock-mode 1)
@end example

Richard M. Stallman's avatar
Richard M. Stallman committed
261 262 263 264
@noindent
You can also specify this using the menu bar Options menu, specifying
first Syntax Highlighting and then Save Options.

265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307
  Font Lock mode uses several specifically named faces to do its job,
including @code{font-lock-string-face}, @code{font-lock-comment-face},
and others.  The easiest way to find them all is to use completion
on the face name in @code{set-face-foreground}.

  To change the colors or the fonts used by Font Lock mode to fontify
different parts of text, just change these faces.  There are
two ways to do it:

@itemize @bullet
@item
Invoke @kbd{M-x set-face-foreground} or @kbd{M-x set-face-background}
to change the colors of a particular face used by Font Lock.
@xref{Faces}.  The command @kbd{M-x list-faces-display} displays all
the faces currently known to Emacs, including those used by Font Lock.

@item
Customize the faces interactively with @kbd{M-x customize-face}, as
described in @ref{Face Customization}.
@end itemize

@vindex font-lock-maximum-decoration
  The variable @code{font-lock-maximum-decoration} specifies the
preferred level of fontification, for modes that provide multiple
levels.  Level 1 is the least amount of fontification; some modes
support levels as high as 3.  The normal default is ``as high as
possible.''  You can specify an integer, which applies to all modes, or
you can specify different numbers for particular major modes; for
example, to use level 1 for C/C++ modes, and the default level
otherwise, use this:

@example
(setq font-lock-maximum-decoration
      '((c-mode . 1) (c++-mode . 1)))
@end example

@vindex font-lock-maximum-size
  Fontification can be too slow for large buffers, so you can suppress
it.  The variable @code{font-lock-maximum-size} specifies a buffer size,
beyond which buffer fontification is suppressed.

@c @w is used below to prevent a bad page-break.
@vindex font-lock-beginning-of-syntax-function
308 309 310
@cindex incorrect fontification
@cindex parenthesis in column zero and fontification
@cindex brace in column zero and fontification
311 312
  Comment and string fontification (or ``syntactic'' fontification)
relies on analysis of the syntactic structure of the buffer text.  For
Richard M. Stallman's avatar
Richard M. Stallman committed
313
the sake of speed, some modes, including C mode and Lisp mode,
314 315
rely on a special convention: an open-parenthesis or open-brace in the
leftmost column always defines the @w{beginning} of a defun, and is
316
thus always outside any string or comment.  (@xref{Left Margin
Richard M. Stallman's avatar
Richard M. Stallman committed
317
Paren}.)  If you don't follow this convention, Font Lock mode can
318 319
misfontify the text that follows an open-parenthesis or open-brace in
the leftmost column that is inside a string or comment.
320

321
@cindex slow display during scrolling
322 323 324 325 326 327 328 329
  The variable @code{font-lock-beginning-of-syntax-function} (always
buffer-local) specifies how Font Lock mode can find a position
guaranteed to be outside any comment or string.  In modes which use the
leftmost column parenthesis convention, the default value of the variable
is @code{beginning-of-defun}---that tells Font Lock mode to use the
convention.  If you set this variable to @code{nil}, Font Lock no longer
relies on the convention.  This avoids incorrect results, but the price
is that, in some cases, fontification for a changed text must rescan
330 331 332
buffer text from the beginning of the buffer.  This can considerably
slow down redisplay while scrolling, particularly if you are close to
the end of a large buffer.
333 334 335 336 337 338 339 340 341 342 343 344 345 346

@findex font-lock-add-keywords
  Font Lock highlighting patterns already exist for many modes, but you
may want to fontify additional patterns.  You can use the function
@code{font-lock-add-keywords}, to add your own highlighting patterns for
a particular mode.  For example, to highlight @samp{FIXME:} words in C
comments, use this:

@example
(font-lock-add-keywords
 'c-mode
 '(("\\<\\(FIXME\\):" 1 font-lock-warning-face t)))
@end example

347 348
@findex font-lock-remove-keywords
  To remove keywords from the font-lock highlighting patterns, use the
349
function @code{font-lock-remove-keywords}.  @xref{Search-based
350 351
Fontification,,, elisp, The Emacs Lisp Reference Manual}, for
documentation of the format of this list.
352

353 354 355 356 357 358 359
@cindex just-in-time (JIT) font-lock
@cindex background syntax highlighting
  Fontifying large buffers can take a long time.  To avoid large
delays when a file is visited, Emacs fontifies only the visible
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
360
``stealthily,'' in the background, i.e.@: when Emacs is idle.  You can
361 362 363
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}.
364

365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404
@node Highlight Changes
@section Highlight Changes Mode

@findex highlight-changes-mode
  Use @kbd{M-x highlight-changes-mode} to enable a minor mode
that uses faces (colors, typically) to indicate which parts of
the buffer were changed most recently.

@node Highlight Interactively
@section Interactive Highlighting by Matching
@cindex highlighting by matching
@cindex interactive highlighting

  It is sometimes useful to highlight the strings that match a certain
regular expression.  For example, you might wish to see all the
references to a certain variable in a program source file, or highlight
certain parts in a voluminous output of some program, or make certain
cliches stand out in an article.

@findex hi-lock-mode
  Use the @kbd{M-x hi-lock-mode} command to turn on a minor mode that
allows you to specify regular expressions of the text to be
highlighted.  Hi-lock mode works like Font Lock (@pxref{Font Lock}),
except that it lets you specify explicitly what parts of text to
highlight.  You control Hi-lock mode with these commands:

@table @kbd
@item C-x w h @var{regexp} @key{RET} @var{face} @key{RET}
@kindex C-x w h
@findex highlight-regexp
Highlight text that matches
@var{regexp} using face @var{face} (@code{highlight-regexp}).
By using this command more than once, you can highlight various
parts of the text in different ways.

@item C-x w r @var{regexp} @key{RET}
@kindex C-x w r
@findex unhighlight-regexp
Unhighlight @var{regexp} (@code{unhighlight-regexp}).  You must enter
one of the regular expressions currently specified for highlighting.
405
(You can use completion, or choose from a menu, to enter one of them
406 407 408 409 410 411 412
conveniently.)

@item C-x w l @var{regexp} @key{RET} @var{face} @key{RET}
@kindex C-x w l
@findex highlight-lines-matching-regexp
@cindex lines, highlighting
@cindex highlighting lines of text
413
Highlight entire lines containing a match for @var{regexp}, using face
414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439
@var{face} (@code{highlight-lines-matching-regexp}).

@item C-x w b
@kindex C-x w b
@findex hi-lock-write-interactive-patterns
Insert all the current highlighting regexp/face pairs into the buffer
at point, with comment delimiters to prevent them from changing your
program.  This key binding runs the
@code{hi-lock-write-interactive-patterns} command.

These patterns will be read the next time you visit the file while
Hi-lock mode is enabled, or whenever you use the @kbd{M-x
hi-lock-find-patterns} command.

@item C-x w i
@kindex C-x w i
@findex hi-lock-find-patterns
@vindex hi-lock-exclude-modes
Re-read regexp/face pairs in the current buffer
(@code{hi-lock-write-interactive-patterns}).  The list of pairs is
found no matter where in the buffer it may be.

This command does nothing if the major mode is a member of the list
@code{hi-lock-exclude-modes}.
@end table

Dave Love's avatar
#  
Dave Love committed
440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463
@node Scrolling
@section Scrolling

  If a buffer contains text that is too large to fit entirely within a
window that is displaying the buffer, Emacs shows a contiguous portion of
the text.  The portion shown always contains point.

@cindex scrolling
  @dfn{Scrolling} means moving text up or down in the window so that
different parts of the text are visible.  Scrolling forward means that text
moves up, and new text appears at the bottom.  Scrolling backward moves
text down and new text appears at the top.

  Scrolling happens automatically if you move point past the bottom or top
of the window.  You can also explicitly request scrolling with the commands
in this section.

@table @kbd
@item C-l
Clear screen and redisplay, scrolling the selected window to center
point vertically within it (@code{recenter}).
@item C-v
Scroll forward (a windowful or a specified number of lines) (@code{scroll-up}).
@item @key{NEXT}
464
@itemx @key{PAGEDOWN}
Dave Love's avatar
#  
Dave Love committed
465 466 467 468
Likewise, scroll forward.
@item M-v
Scroll backward (@code{scroll-down}).
@item @key{PRIOR}
469
@itemx @key{PAGEUP}
Dave Love's avatar
#  
Dave Love committed
470 471 472 473 474 475 476 477 478 479 480
Likewise, scroll backward.
@item @var{arg} C-l
Scroll so point is on line @var{arg} (@code{recenter}).
@item C-M-l
Scroll heuristically to bring useful information onto the screen
(@code{reposition-window}).
@end table

@kindex C-l
@findex recenter
  The most basic scrolling command is @kbd{C-l} (@code{recenter}) with
Richard M. Stallman's avatar
Richard M. Stallman committed
481 482 483 484
no argument.  It scrolls the selected window so that point is halfway
down from the top of the window.  On a text terminal, it also clears
the screen and redisplays all windows.  That is useful in case the
screen is garbled (@pxref{Screen Garbled}).
Dave Love's avatar
#  
Dave Love committed
485 486 487 488 489

@kindex C-v
@kindex M-v
@kindex NEXT
@kindex PRIOR
490 491
@kindex PAGEDOWN
@kindex PAGEUP
Dave Love's avatar
#  
Dave Love committed
492 493 494
@findex scroll-up
@findex scroll-down
@vindex next-screen-context-lines
495 496 497 498 499 500 501 502
  To read the buffer a windowful at a time, use @kbd{C-v}
(@code{scroll-up}) with no argument.  This scrolls forward by nearly
the whole window height.  The effect is to take the two lines at the
bottom of the window and put them at the top, followed by nearly a
whole windowful of lines that were not previously visible.  If point
was in the text that scrolled off the top, it ends up at the new top
of the window.

Richard M. Stallman's avatar
Richard M. Stallman committed
503 504 505
  @kbd{M-v} (@code{scroll-down}) with no argument scrolls backward in
a similar way, also with overlap.  The number of lines of overlap
across a @kbd{C-v} or @kbd{M-v} is controlled by the variable
506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525
@code{next-screen-context-lines}; by default, it is 2.  The function
keys @key{NEXT} and @key{PRIOR}, or @key{PAGEDOWN} and @key{PAGEUP},
are equivalent to @kbd{C-v} and @kbd{M-v}.

  The commands @kbd{C-v} and @kbd{M-v} with a numeric argument scroll
the text in the selected window up or down a few lines.  @kbd{C-v}
with an argument moves the text and point up, together, that many
lines; it brings the same number of new lines into view at the bottom
of the window.  @kbd{M-v} with numeric argument scrolls the text
downward, bringing that many new lines into view at the top of the
window.  @kbd{C-v} with a negative argument is like @kbd{M-v} and vice
versa.

  The names of scroll commands are based on the direction that the
text moves in the window.  Thus, the command to scroll forward is
called @code{scroll-up} because it moves the text upward on the
screen.  The keys @key{PAGEDOWN} and @key{PAGEUP} derive their names
and customary meanings from a different convention that developed
elsewhere; hence the strange result that @key{PAGEDOWN} runs
@code{scroll-up}.
Dave Love's avatar
#  
Dave Love committed
526 527 528 529

@vindex scroll-preserve-screen-position
  Some users like the full-screen scroll commands to keep point at the
same screen line.  To enable this behavior, set the variable
530 531 532 533 534 535 536 537
@code{scroll-preserve-screen-position} to a non-@code{nil} value.  In
this mode, when scrolling shifts point off the screen, or into the
scrolling margins, Emacs moves point to keep the same vertical
position within the window.  This mode is convenient for browsing
through a file by scrolling by screenfuls; if you come back to the
screen where you started, point goes back to the line where it
started.  However, this mode is inconvenient when you move to the next
screen in order to move point to the text there.
Dave Love's avatar
#  
Dave Love committed
538 539 540 541 542 543 544 545 546

  Another way to do scrolling is with @kbd{C-l} with a numeric argument.
@kbd{C-l} does not clear the screen when given an argument; it only scrolls
the selected window.  With a positive argument @var{n}, it repositions text
to put point @var{n} lines down from the top.  An argument of zero puts
point on the very top line.  Point does not move with respect to the text;
rather, the text and point move rigidly on the screen.  @kbd{C-l} with a
negative argument puts point that many lines from the bottom of the window.
For example, @kbd{C-u - 1 C-l} puts point on the bottom line, and @kbd{C-u
547 548
- 5 C-l} puts it five lines from the bottom.  @kbd{C-u C-l} scrolls to put
point at the center (vertically) of the selected window.
Dave Love's avatar
#  
Dave Love committed
549 550 551 552 553 554 555 556 557

@kindex C-M-l
@findex reposition-window
  The @kbd{C-M-l} command (@code{reposition-window}) scrolls the current
window heuristically in a way designed to get useful information onto
the screen.  For example, in a Lisp file, this command tries to get the
entire current defun onto the screen if possible.

@vindex scroll-conservatively
558 559 560 561 562 563 564
  Scrolling happens automatically when point moves out of the visible
portion of the text.  Normally, automatic scrolling centers point
vertically within the window.  However, if you set
@code{scroll-conservatively} to a small number @var{n}, then if you
move point just a little off the screen---less than @var{n}
lines---then Emacs scrolls the text just far enough to bring point
back on screen.  By default, @code{scroll-conservatively} is 0.
Dave Love's avatar
#  
Dave Love committed
565

566 567
@cindex aggressive scrolling
@vindex scroll-up-aggressively
568
@vindex scroll-down-aggressively
569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586
  When the window does scroll by a longer distance, you can control
how aggressively it scrolls, by setting the variables
@code{scroll-up-aggressively} and @code{scroll-down-aggressively}.
The value of @code{scroll-up-aggressively} should be either
@code{nil}, or a fraction @var{f} between 0 and 1.  A fraction
specifies where on the screen to put point when scrolling upward.
More precisely, when a window scrolls up because point is above the
window start, the new start position is chosen to put point @var{f}
part of the window height from the top.  The larger @var{f}, the more
aggressive the scrolling.

  @code{nil}, which is the default, scrolls to put point at the center.
So it is equivalent to .5.

  Likewise, @code{scroll-down-aggressively} is used for scrolling
down.  The value, @var{f}, specifies how far point should be placed
from the bottom of the window; thus, as with
@code{scroll-up-aggressively}, a larger value is more aggressive.
587

Dave Love's avatar
#  
Dave Love committed
588 589 590 591 592 593 594 595 596 597 598 599
@vindex scroll-margin
  The variable @code{scroll-margin} restricts how close point can come
to the top or bottom of a window.  Its value is a number of screen
lines; if point comes within that many lines of the top or bottom of the
window, Emacs recenters the window.  By default, @code{scroll-margin} is
0.

@node Horizontal Scrolling
@section Horizontal Scrolling
@cindex horizontal scrolling

  @dfn{Horizontal scrolling} means shifting all the lines sideways
600
within a window---so that some of the text near the left margin is not
Richard M. Stallman's avatar
Richard M. Stallman committed
601 602 603 604 605 606
displayed at all.  When the text in a window is scrolled horizontally,
text lines are truncated rather than continued (@pxref{Display
Custom}).  Whenever a window shows truncated lines, Emacs
automatically updates its horizontal scrolling whenever point moves
off the left or right edge of the screen.  You can also use these
commands to do explicit horizontal scrolling.
Dave Love's avatar
#  
Dave Love committed
607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631

@table @kbd
@item C-x <
Scroll text in current window to the left (@code{scroll-left}).
@item C-x >
Scroll to the right (@code{scroll-right}).
@end table

@kindex C-x <
@kindex C-x >
@findex scroll-left
@findex scroll-right
  The command @kbd{C-x <} (@code{scroll-left}) scrolls the selected
window to the left by @var{n} columns with argument @var{n}.  This moves
part of the beginning of each line off the left edge of the window.
With no argument, it scrolls by almost the full width of the window (two
columns less, to be precise).

  @kbd{C-x >} (@code{scroll-right}) scrolls similarly to the right.  The
window cannot be scrolled any farther to the right once it is displayed
normally (with each line starting at the window's left margin);
attempting to do so has no effect.  This means that you don't have to
calculate the argument precisely for @w{@kbd{C-x >}}; any sufficiently large
argument will restore the normal display.

Richard M. Stallman's avatar
Richard M. Stallman committed
632 633 634 635
  If you use those commands to scroll a window horizontally, that sets
a lower bound for automatic horizontal scrolling.  Automatic scrolling
will continue to scroll the window, but never farther to the right
than the amount you previously set by @code{scroll-left}.
Dave Love's avatar
#  
Dave Love committed
636

637 638 639 640 641 642 643 644 645 646 647 648
@vindex hscroll-margin
  The value of the variable @code{hscroll-margin} controls how close
to the window's edges point is allowed to get before the window will
be automatically scrolled.  It is measured in columns.  If the value
is 5, then moving point within 5 columns of the edge causes horizontal
scrolling away from that edge.

@vindex hscroll-step
  The variable @code{hscroll-step} determines how many columns to
scroll the window when point gets too close to the edge.  If it's
zero, horizontal scrolling centers point horizontally within the
window.  If it's a positive integer, it specifies the number of
Richard M. Stallman's avatar
Richard M. Stallman committed
649 650
columns to scroll by.  If it's a floating-point number, it specifies
the fraction of the window's width to scroll by.  The default is zero.
651

652
@vindex auto-hscroll-mode
653
  To disable automatic horizontal scrolling, set the variable
654
@code{auto-hscroll-mode} to @code{nil}.
Gerd Moellmann's avatar
Gerd Moellmann committed
655

656 657 658 659 660 661 662 663 664 665 666 667 668 669 670
@node Fringes
@section Window Fringes
@cindex fringes

  On a graphical display, each Emacs window normally has narrow
@dfn{fringes} on the left and right edges.  The fringes display
indications about the text in the window.

  The most common use of the fringes is to indicate a continuation
line, when one line of text is split into multiple lines on the
screen.  The left fringe shows a curving arrow for each screen line
except the first, indicating that ``this is not the real beginning.''
The right fringe shows a curving arrow for each screen line except the
last, indicating that ``this is not the real end.''

671
  The fringes indicate line truncation with short horizontal arrows
672
meaning ``there's more text on this line which is scrolled
673 674
horizontally out of view;'' clicking the mouse on one of the arrows
scrolls the display horizontally in the direction of the arrow.   The
Luc Teirlinck's avatar
Luc Teirlinck committed
675
fringes can also indicate other things, such as empty lines, or where a
676
program you are debugging is executing (@pxref{Debuggers}).
677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712

@findex set-fringe-style
@findex fringe-mode
  You can enable and disable the fringes for all frames using
@kbd{M-x fringe-mode}.  To enable and disable the fringes
for the selected frame, use @kbd{M-x set-fringe-style}.

@node Useless Whitespace
@section Useless Whitespace

@cindex trailing whitespace
@cindex whitespace, trailing
@vindex show-trailing-whitespace
  It is easy to leave unnecessary spaces at the end of a line, or
empty lines at the end of a file, without realizing it.  In most
cases, this @dfn{trailing whitespace} has no effect, but there are
special circumstances where it matters.

  You can make trailing whitespace at the end of a line visible on the
screen by setting the buffer-local variable
@code{show-trailing-whitespace} to @code{t}.  Then Emacs displays
trailing whitespace in the face @code{trailing-whitespace}.

  This feature does not apply when point is at the end of the line
containing the whitespace.  Strictly speaking, that is ``trailing
whitespace'' nonetheless, but displaying it specially in that case
looks ugly while you are typing in new text.  In this special case,
the location of point is enough to show you that the spaces are
present.

@findex delete-trailing-whitespace
  To delete all trailing whitespace within the current buffer's
accessible portion (@pxref{Narrowing}), type @kbd{M-x
delete-trailing-whitespace @key{RET}}.  (This command does not remove
the form-feed characters.)

713
@vindex indicate-empty-lines
714
@vindex default-indicate-empty-lines
715 716 717 718 719 720 721 722 723
@cindex unused lines
@cindex fringes, and unused line indication
  Emacs can indicate unused lines at the end of the window with a
small image in the left fringe (@pxref{Fringes}).  The image appears
for window lines that do not correspond to any buffer text.  Blank
lines at the end of the buffer then stand out because they do not have
this image in the fringe.

  To enable this feature, set the buffer-local variable
724
@code{indicate-empty-lines} to a non-@code{nil} value.  The default
725
value of this variable is controlled by the variable
726
@code{default-indicate-empty-lines}; by setting that variable, you
727 728
can enable or disable this feature for all new buffers.  (This feature
currently doesn't work on character terminals.)
729

Dave Love's avatar
#  
Dave Love committed
730 731 732 733
@node Follow Mode
@section Follow Mode
@cindex Follow mode
@cindex mode, Follow
734 735 736
@findex follow-mode
@cindex windows, synchronizing
@cindex synchronizing windows
Dave Love's avatar
#  
Dave Love committed
737

Richard M. Stallman's avatar
Richard M. Stallman committed
738 739 740 741 742 743
  @dfn{Follow mode} is a minor mode that makes two windows, both
showing the same buffer, scroll as a single tall ``virtual window.''
To use Follow mode, go to a frame with just one window, split it into
two side-by-side windows using @kbd{C-x 3}, and then type @kbd{M-x
follow-mode}.  From then on, you can edit the buffer in either of the
two windows, or scroll either one; the other window follows it.
Dave Love's avatar
#  
Dave Love committed
744

Richard M. Stallman's avatar
Richard M. Stallman committed
745 746 747 748 749
  In Follow mode, if you move point outside the portion visible in one
window and into the portion visible in the other window, that selects
the other window---again, treating the two as if they were parts of
one large window.

Dave Love's avatar
#  
Dave Love committed
750 751 752 753
  To turn off Follow mode, type @kbd{M-x follow-mode} a second time.

@node Selective Display
@section Selective Display
754
@cindex selective display
Dave Love's avatar
#  
Dave Love committed
755 756 757 758 759 760 761
@findex set-selective-display
@kindex C-x $

  Emacs has the ability to hide lines indented more than a certain number
of columns (you specify how many columns).  You can use this to get an
overview of a part of a program.

Luc Teirlinck's avatar
Luc Teirlinck committed
762 763 764 765 766 767
  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.
Dave Love's avatar
#  
Dave Love committed
768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786

  The commands @kbd{C-n} and @kbd{C-p} move across the hidden lines as
if they were not there.

  The hidden lines are still present in the buffer, and most editing
commands see them as usual, so you may find point in the middle of the
hidden text.  When this happens, the cursor appears at the end of the
previous line, after the three dots.  If point is at the end of the
visible line, before the newline that ends it, the cursor appears before
the three dots.

  To make all lines visible again, type @kbd{C-x $} with no argument.

@vindex selective-display-ellipses
  If you set the variable @code{selective-display-ellipses} to
@code{nil}, the three dots do not appear at the end of a line that
precedes hidden lines.  Then there is no visible indication of the
hidden lines.  This variable becomes local automatically when set.

Richard M. Stallman's avatar
Richard M. Stallman committed
787 788 789
  See also @ref{Outline Mode} for another way to hide part of
the text in a buffer.

Dave Love's avatar
#  
Dave Love committed
790 791 792
@node Optional Mode Line
@section Optional Mode Line Features

793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814
@cindex buffer size display
@cindex display of buffer size
@findex size-indication-mode
  The buffer percentage @var{pos} indicates the percentage of the
buffer above the top of the window.  You can additionally display the
size of the buffer by typing @kbd{M-x size-indication-mode} to turn on
Size Indication mode.  The size will be displayed immediately
following the buffer percentage like this:

@example
@var{POS} of @var{SIZE}
@end example

@noindent
Here @var{SIZE} is the human readable representation of the number of
characters in the buffer, which means that @samp{k} for 10^3, @samp{M}
for 10^6, @samp{G} for 10^9, etc., are used to abbreviate.

@cindex narrowing, and buffer size display
  If you have narrowed the buffer (@pxref{Narrowing}), the size of the
accessible part of the buffer is shown.

815 816
@cindex line number display
@cindex display of line number
Dave Love's avatar
#  
Dave Love committed
817 818 819 820
@findex line-number-mode
  The current line number of point appears in the mode line when Line
Number mode is enabled.  Use the command @kbd{M-x line-number-mode} to
turn this mode on and off; normally it is on.  The line number appears
821
after the buffer percentage @var{pos}, with the letter @samp{L} to
Dave Love's avatar
#  
Dave Love committed
822 823 824
indicate what it is.  @xref{Minor Modes}, for more information about
minor modes and about how to use this command.

825 826 827 828
@cindex narrowing, and line number display
  If you have narrowed the buffer (@pxref{Narrowing}), the displayed
line number is relative to the accessible portion of the buffer.

Dave Love's avatar
#  
Dave Love committed
829 830 831 832
@vindex line-number-display-limit
  If the buffer is very large (larger than the value of
@code{line-number-display-limit}), then the line number doesn't appear.
Emacs doesn't compute the line number when the buffer is large, because
833 834 835 836 837 838 839 840 841
that would be too slow.  Set it to @code{nil} to remove the limit.

@vindex line-number-display-limit-width
  Line-number computation can also be slow if the lines in the buffer
are too long.  For this reason, Emacs normally doesn't display line
numbers if the average width, in characters, of lines near point is
larger than the value of the variable
@code{line-number-display-limit-width}.  The default value is 200
characters.
Dave Love's avatar
#  
Dave Love committed
842 843 844 845 846 847 848 849 850 851 852

@cindex Column Number mode
@cindex mode, Column Number
@findex column-number-mode
  You can also display the current column number by turning on Column
Number mode.  It displays the current column number preceded by the
letter @samp{C}.  Type @kbd{M-x column-number-mode} to toggle this mode.

@findex display-time
@cindex time (on mode line)
  Emacs can optionally display the time and system load in all mode
Dave Love's avatar
Dave Love committed
853 854 855 856
lines.  To enable this feature, type @kbd{M-x display-time} or customize
the option @code{display-time-mode}.  The information added to the mode
line usually appears after the buffer name, before the mode names and
their parentheses.  It looks like this:
Dave Love's avatar
#  
Dave Love committed
857 858 859 860 861 862 863 864 865 866 867 868 869 870 871

@example
@var{hh}:@var{mm}pm @var{l.ll}
@end example

@noindent
@vindex display-time-24hr-format
Here @var{hh} and @var{mm} are the hour and minute, followed always by
@samp{am} or @samp{pm}.  @var{l.ll} is the average number of running
processes in the whole system recently.  (Some fields may be missing if
your operating system cannot support them.)  If you prefer time display
in 24-hour format, set the variable @code{display-time-24hr-format}
to @code{t}.

@cindex mail (on mode line)
Dave Love's avatar
Dave Love committed
872 873
@vindex display-time-use-mail-icon
@vindex display-time-mail-face
874 875
@vindex display-time-mail-file
@vindex display-time-mail-directory
Dave Love's avatar
#  
Dave Love committed
876
  The word @samp{Mail} appears after the load level if there is mail
Dave Love's avatar
Dave Love committed
877 878 879 880
for you that you have not read yet.  On a graphical display you can use
an icon instead of @samp{Mail} by customizing
@code{display-time-use-mail-icon}; this may save some space on the mode
line.  You can customize @code{display-time-mail-face} to make the mail
881 882 883 884
indicator prominent.  Use @code{display-time-mail-file} to specify
the mail file to check, or set @code{display-time-mail-directory}
to specify the directory to check for incoming mail (any nonempty regular
file in the directory is considered as ``newly arrived mail'').
Dave Love's avatar
#  
Dave Love committed
885

Richard M. Stallman's avatar
Richard M. Stallman committed
886
@cindex mode line, 3D appearance
887 888
@cindex attributes of mode line, changing
@cindex non-integral number of lines in a window
889 890 891 892 893
  By default, the mode line is drawn on graphics displays with
3D-style highlighting, like that of a button when it is not being
pressed.  If you don't like this effect, you can disable the 3D
highlighting of the mode line, by customizing the attributes of the
@code{mode-line} face in your @file{.emacs} init file, like this:
894 895

@example
896
(set-face-attribute 'mode-line nil :box nil)
897 898 899
@end example

@noindent
900
Alternatively, you can turn off the box attribute in your
901 902 903
@file{.Xdefaults} file:

@example
904
Emacs.mode-line.AttributeBox: off
905 906
@end example

907
@cindex non-selected windows, mode line appearance
Richard M. Stallman's avatar
Richard M. Stallman committed
908
  By default, the mode line of nonselected windows is displayed in a
909
different face, called @code{mode-line-inactive}.  Only the selected
Richard M. Stallman's avatar
Richard M. Stallman committed
910 911 912 913 914 915 916 917
window is displayed in the @code{mode-line} face.  This helps show
which window is selected.  When the minibuffer is selected, since
it has no mode line, the window from which you activated the minibuffer
has its mode line displayed using @code{mode-line}; as a result,
ordinary entry to the minibuffer does not change any mode lines.

@vindex mode-line-in-non-selected-windows
  You can disable use of @code{mode-line-inactive} by setting variable
918 919
@code{mode-line-in-non-selected-windows} to @code{nil}; then all mode
lines are displayed in the @code{mode-line} face.
920

Dave Love's avatar
#  
Dave Love committed
921 922 923 924
@node Text Display
@section How Text Is Displayed
@cindex characters (in text)

925
  @acronym{ASCII} printing characters (octal codes 040 through 0176) in Emacs
926
buffers are displayed with their graphics, as are non-ASCII multibyte
Dave Love's avatar
#  
Dave Love committed
927 928
printing characters (octal codes above 0400).

929
  Some @acronym{ASCII} control characters are displayed in special ways.  The
Dave Love's avatar
#  
Dave Love committed
930 931 932 933
newline character (octal code 012) is displayed by starting a new line.
The tab character (octal code 011) is displayed by moving to the next
tab stop column (normally every 8 columns).

934
  Other @acronym{ASCII} control characters are normally displayed as a caret
Dave Love's avatar
#  
Dave Love committed
935 936 937
(@samp{^}) followed by the non-control version of the character; thus,
control-A is displayed as @samp{^A}.

938
  Non-@acronym{ASCII} characters 0200 through 0237 (octal) are displayed with
Dave Love's avatar
Dave Love committed
939 940 941
octal escape sequences; thus, character code 0230 (octal) is displayed
as @samp{\230}.  The display of character codes 0240 through 0377
(octal) may be either as escape sequences or as graphics.  They do not
942
normally occur in multibyte buffers, but if they do, they are displayed
Dave Love's avatar
Dave Love committed
943 944 945 946
as Latin-1 graphics.  In unibyte mode, if you enable European display
they are displayed using their graphics (assuming your terminal supports
them), otherwise as escape sequences.  @xref{Single-Byte Character
Support}.
Dave Love's avatar
#  
Dave Love committed
947

948 949 950 951 952 953 954 955 956 957 958
@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.
959

Richard M. Stallman's avatar
Richard M. Stallman committed
960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999
@node Cursor Display
@section Displaying the Cursor

@findex blink-cursor-mode
@vindex blink-cursor-alist
@cindex cursor, locating visually
@cindex cursor, blinking
  You can customize the cursor's color, and whether it blinks, using
the @code{cursor} Custom group (@pxref{Easy Customization}).  On
graphical terminals, the command @kbd{M-x blink-cursor-mode} enables
or disables the blinking of the cursor.  (On text terminals, the
terminal itself blinks the cursor, and Emacs has no control over it.)
You can control how the cursor appears when it blinks off by setting
the variable @code{blink-cursor-alist}.

@cindex cursor in non-selected windows
@vindex cursor-in-non-selected-windows
  Normally, the cursor appears in non-selected windows in the ``off''
state, with the same appearance as when the blinking cursor blinks
``off''.  For a box cursor, this is a hollow box; for a bar cursor,
this is a thinner bar.  To turn off cursors in non-selected windows,
customize the variable @code{cursor-in-non-selected-windows} and assign
it a @code{nil} value.

@vindex x-stretch-cursor
@cindex wide block cursor
  On graphical terminals, Emacs can optionally draw the block cursor
as wide as the character under the cursor---for example, if the cursor
is on a tab character, it would cover the full width occupied by that
tab character.  To enable this feature, set the variable
@code{x-stretch-cursor} to a non-@code{nil} value.

@findex hl-line-mode
@findex global-hl-line-mode
@cindex highlight current line
  If you find it hard to see the cursor, you might like HL Line mode,
a minor mode that highlights the line containing point.  Use @kbd{M-x
hl-line-mode} to enable or disable it in the current buffer.  @kbd{M-x
global-hl-line-mode} enables or disables the same mode globally.

1000 1001
@node Display Custom
@section Customization of Display
Dave Love's avatar
#  
Dave Love committed
1002 1003 1004 1005 1006

  This section contains information for customization only.  Beginning
users should skip it.

@vindex mode-line-inverse-video
1007 1008 1009
  The variable @code{mode-line-inverse-video} is an obsolete way of
controlling whether the mode line is displayed in inverse video; the
preferred way of doing this is to change the @code{mode-line} face.
1010 1011 1012 1013
@xref{Mode Line}.  However, if @code{mode-line-inverse-video} has a
value of @code{nil}, then the @code{mode-line} face will be ignored,
and mode-lines will be drawn using the default text face.
@xref{Faces}.
Dave Love's avatar
#  
Dave Love committed
1014 1015 1016 1017 1018 1019 1020 1021 1022

@vindex inverse-video
  If the variable @code{inverse-video} is non-@code{nil}, Emacs attempts
to invert all the lines of the display from what they normally are.

@vindex visible-bell
  If the variable @code{visible-bell} is non-@code{nil}, Emacs attempts
to make the whole screen blink when it would normally make an audible bell
sound.  This variable has no effect if your terminal does not have a way
Richard M. Stallman's avatar
Richard M. Stallman committed
1023
to make the screen blink.
Dave Love's avatar
#  
Dave Love committed
1024 1025

@vindex no-redraw-on-reenter
Richard M. Stallman's avatar
Richard M. Stallman committed
1026 1027 1028 1029 1030 1031 1032 1033 1034 1035
  On a text terminal, when you reenter Emacs after suspending, Emacs
normally clears the screen and redraws the entire display.  On some
terminals with more than one page of memory, it is possible to arrange
the termcap entry so that the @samp{ti} and @samp{te} strings (output
to the terminal when Emacs is entered and exited, respectively) switch
between pages of memory so as to use one page for Emacs and another
page for other output.  Then you might want to set the variable
@code{no-redraw-on-reenter} non-@code{nil}; this tells Emacs to
assume, when resumed, that the screen page it is using still contains
what Emacs last wrote there.
Dave Love's avatar
#  
Dave Love committed
1036 1037 1038 1039 1040 1041 1042

@vindex echo-keystrokes
  The variable @code{echo-keystrokes} controls the echoing of multi-character
keys; its value is the number of seconds of pause required to cause echoing
to start, or zero meaning don't echo at all.  @xref{Echo Area}.

@vindex ctl-arrow
1043
  If the variable @code{ctl-arrow} is @code{nil}, all control characters in
Dave Love's avatar
#  
Dave Love committed
1044 1045 1046 1047 1048 1049 1050
the buffer are displayed with octal escape sequences, except for newline
and tab.  Altering the value of @code{ctl-arrow} makes it local to the
current buffer; until that time, the default value is in effect.  The
default is initially @code{t}.  @xref{Display Tables,, Display Tables,
elisp, The Emacs Lisp Reference Manual}.

@vindex tab-width
Richard M. Stallman's avatar
Richard M. Stallman committed
1051
@vindex default-tab-width
Dave Love's avatar
#  
Dave Love committed
1052 1053 1054 1055 1056 1057 1058
  Normally, a tab character in the buffer is displayed as whitespace which
extends to the next display tab stop position, and display tab stops come
at intervals equal to eight spaces.  The number of spaces per tab is
controlled by the variable @code{tab-width}, which is made local by
changing it, just like @code{ctl-arrow}.  Note that how the tab character
in the buffer is displayed has nothing to do with the definition of
@key{TAB} as a command.  The variable @code{tab-width} must have an
Richard M. Stallman's avatar
Richard M. Stallman committed
1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083
integer value between 1 and 1000, inclusive.  The variable
@code{default-tab-width} controls the default value of this variable
for buffers where you have not set it locally.

@cindex truncation
@cindex line truncation, and fringes
  As an alternative to continuation, Emacs can display long lines by
@dfn{truncation}.  This means that all the characters that do not fit
in the width of the screen or window do not appear at all.  On
graphical terminals, a small straight arrow in the fringe indicates
truncation at either end of the line.  On text terminals, @samp{$}
appears in the first column when there is text truncated to the left,
and in the last column when there is text truncated to the right.

@vindex truncate-lines
@findex toggle-truncate-lines
  Horizontal scrolling automatically causes line truncation
(@pxref{Horizontal Scrolling}).  You can explicitly enable line
truncation for a particular buffer with the command @kbd{M-x
toggle-truncate-lines}.  This works by locally changing the variable
@code{truncate-lines}.  If that variable is non-@code{nil}, long lines
are truncated; if it is @code{nil}, they are continued onto multiple
screen lines.  Setting the variable @code{truncate-lines} in any way
makes it local to the current buffer; until that time, the default
value is in effect.  The default value is normally @code{nil}.
Dave Love's avatar
#  
Dave Love committed
1084 1085 1086 1087 1088 1089 1090 1091 1092

@c @vindex truncate-partial-width-windows  @c Idx entry is in Split Windows.
  If the variable @code{truncate-partial-width-windows} is
non-@code{nil}, it forces truncation rather than continuation in any
window less than the full width of the screen or frame, regardless of
the value of @code{truncate-lines}.  For information about side-by-side
windows, see @ref{Split Window}.  See also @ref{Display,, Display,
elisp, The Emacs Lisp Reference Manual}.

1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109
@vindex overflow-newline-into-fringe
  If the variable @code{overflow-newline-into-fringe} is
non-@code{nil} on a window system, it specifies that lines which are
exactly as wide as the window (not counting the final newline
character) shall not be broken into two lines on the display (with
just the newline on the second line).  Instead, the newline
overflows into the right fringe, and the cursor will be displayed in
the fringe when positioned on that newline.

@vindex indicate-buffer-boundaries
  On a window system, Emacs may indicate the buffer boundaries in the
fringes.  The buffer boundaries, i.e. first and last line in the
buffer, can be marked with angle bitmaps in the left or right fringe.
This can be combined with up and down arrow bitmaps shown at the top
and bottom of the left or right fringe if the window can be scrolled
in either direction.

1110
  The buffer-local variable @code{indicate-buffer-boundaries} controls
1111 1112 1113
how the buffer boundaries and window scrolling is indicated in the
fringes.

1114
  If the value is @code{left} or @code{right}, both angle and arrow
1115
bitmaps are displayed in the left or right fringe, respectively.
1116 1117 1118 1119 1120 1121

  If value is an alist, each element @code{(@var{indicator} .
@var{position})} specifies the position of one of the indicators.
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.
1122
The @var{position} is one of @code{left}, @code{right}, or @code{nil}
1123 1124 1125 1126 1127 1128 1129
which specifies not to show this indicator.

  For example, @code{((top . left) (t . right))} places the top angle
bitmap in left fringe, the bottom angle bitmap in right fringe, and
both arrow bitmaps in right fringe.  To show just the angle bitmaps in
the left fringe, but no arrow bitmaps, use @code{((top .  left)
(bottom . left))}.
1130 1131 1132 1133 1134 1135

@vindex default-indicate-buffer-boundaries
  The value of the variable @code{default-indicate-buffer-boundaries}
is the default value for @code{indicate-buffer-boundaries} in buffers
that do not override it.

Dave Love's avatar
#  
Dave Love committed
1136
@vindex baud-rate
1137 1138 1139 1140 1141
  The variable @code{baud-rate} holds the output speed of the
terminal, as far as Emacs knows.  Setting this variable does not
change the speed of actual data transmission, but the value is used
for calculations.  On terminals, it affects padding, and decisions
about whether to scroll part of the screen or redraw it instead.
1142
It also affects the behavior of incremental search.
1143

1144 1145 1146 1147
  On window-systems, @code{baud-rate} is only used to determine how
frequently to look for pending input during display updating.  A
higher value of @code{baud-rate} means that check for pending input
will be done less frequently.
Dave Love's avatar
#  
Dave Love committed
1148 1149 1150 1151

  You can customize the way any particular character code is displayed
by means of a display table.  @xref{Display Tables,, Display Tables,
elisp, The Emacs Lisp Reference Manual}.
1152

Gerd Moellmann's avatar
Gerd Moellmann committed
1153 1154
@cindex hourglass pointer display
@vindex hourglass-delay
1155 1156 1157 1158
  On a window system, Emacs can optionally display the mouse pointer
in a special shape to say that Emacs is busy.  To turn this feature on
or off, customize the group @code{cursor}.  You can also control the
amount of time Emacs must remain busy before the busy indicator is
Gerd Moellmann's avatar
Gerd Moellmann committed
1159
displayed, by setting the variable @code{hourglass-delay}.
1160

1161 1162 1163 1164 1165 1166
@findex tty-suppress-bold-inverse-default-colors
  On some text-only terminals, bold face and inverse video together
result in text that is hard to read.  Call the function
@code{tty-suppress-bold-inverse-default-colors} with a non-@code{nil}
argument to suppress the effect of bold-face in this case.

Miles Bader's avatar
Miles Bader committed
1167 1168 1169
@ignore
   arch-tag: 2219f910-2ff0-4521-b059-1bd231a536c4
@end ignore