Function: split-window-vertically

split-window-vertically is a function alias and interactive for split-window-below, defined in window.el.gz.

Signature

(split-window-vertically &optional SIZE WINDOW-TO-SPLIT)

Documentation

Split WINDOW-TO-SPLIT into two windows, one above the other.

WINDOW-TO-SPLIT defaults to the selected window if omitted or nil. The newly created window will be below WINDOW-TO-SPLIT and will show the same buffer as WINDOW-TO-SPLIT, if it is a live window, else the buffer shown in the WINDOW-TO-SPLIT's frame's selected window. Return the new window.

If optional argument SIZE is omitted or nil, both windows get the same height, or close to it. If SIZE is positive, the upper
(selected) window gets SIZE lines. If SIZE is negative, the
lower (new) window gets -SIZE lines. Interactively, SIZE is the prefix numeric argument.

If the variable split-window-keep-point is non-nil, both windows get the same value of point as the WINDOW-TO-SPLIT. Otherwise, the window starts are chosen so as to minimize the amount of redisplay; this is convenient on slow terminals.

Probably introduced at or before Emacs version 15.

Key Bindings

Aliases

split-window-vertically