1. Home
  2. Computing & Technology
  3. Linux

Scrolling
Emacs Documentation

By , About.com Guide

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.

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.

  • C-l
    Clear screen and redisplay, scrolling the selected window to center point vertically within it (recenter).
  • C-v
    Scroll forward (a windowful or a specified number of lines) (scroll-up).
  • <NEXT>
  • <PAGEDOWN>
    Likewise, scroll forward.
  • M-v
    Scroll backward (scroll-down).
  • <PRIOR>
  • <PAGEUP>
    Likewise, scroll backward.
  • arg C-l
    Scroll so point is on line arg (recenter).
  • C-M-l
    Scroll heuristically to bring useful information onto the screen (reposition-window).

The most basic scrolling command is C-l (recenter) with no argument. It clears the entire screen and redisplays all windows. In addition, it scrolls the selected window so that point is halfway down from the top of the window.

To read the buffer a windowful at a time, use C-v (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.

M-v (scroll-down) with no argument scrolls backward in a similar way, also with overlap. The number of lines of overlap across a C-v or M-v is controlled by the variable next-screen-context-lines; by default, it is 2. The function keys <NEXT> and <PRIOR>, or <PAGEDOWN> and <PAGEUP>, are equivalent to C-v and M-v.

The commands C-v and M-v with a numeric argument scroll the text in the selected window up or down a few lines. 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. M-v with numeric argument scrolls the text downward, bringing that many new lines into view at the top of the window. C-v with a negative argument is like 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 scroll-up because it moves the text upward on the screen. The keys <PAGEDOWN> and <PAGEUP> derive their names and customary meanings from a different convention that developed elsewhere; hence the strange result that

* Emacs Manual Index

Explore Linux
About.com Special Features

The Best Web Trends of the Decade

A look back at the best innovations, ideas and technologies over the last 10 years, More >

Family Tech Center

Stay connected and entertained with reviews on tips on the latest HDTVs, cellphones and more. More >

  1. Home
  2. Computing & Technology
  3. Linux
  4. Linux Software
  5. Editors
  6. Emacs
  7. Emacs Documentation - Scrolling

©2009 About.com, a part of The New York Times Company.

All rights reserved.