Next: , Up: Frames

7.1 Splitting Frames

To split the current frame horizontally use C-t s. To split the current frame vertically use C-t S. If you have enough windows, you'll notice that the new frame will find a window for itself. You can now use the normal navigation commands to switch windows in the frame. Note, however, that if you switch by name or number to a window that is already in another frame, you'll switch to that frame.

Before too long, you'll probably want to switch to another frame. Use C-t tab to cycle through the frames. If you want to remove a frame use C-t R. ratpoison automatically adjusts the size of the other frames to take up the free space. Unfortunately ratpoison may not always fill it in the way you might like it to.

Finally, when you've had enough of the splitting and you just want good ol' full screen ratpoison press C-t Q to remove all splits and leave you with the current window full screen.

— Command: remove

Kill the current frame. This is a no-op if there is only one frame.

— Command: only

Kill all frames but the current one.

— Command: split n
— Command: vsplit n

Split the current frame vertically in two. The last accessed window not occupying a frame will be the second window.

n is either a fraction of the form x/y or a number. If it is a fraction then the current frame is resized to that fraction of its original size and the new frame takes up the remaining space. For instance, split 1/4 will split the current frame to a quarter of its original size and the new frame will then be 3/4 of the size of the original frame.

If it is a pixel, the original frame is resized to that many pixels. If n has a minus sign before it, then the new frame will shrink by that many pixels.

— Command: hsplit n

Split the current frame horizontally in two. The last accessed window not occupying a frame will be the second window.

n is either a fraction of the form x/y or a number. If it is a fraction then the current frame is resized to that fraction of its original size and the new frame takes up the remaining space. For instance, split 1/4 will split the current frame to a quarter of its original size and the new frame will then be 3/4 of the size of the original frame.

If it is a pixel, the original frame is resized to that many pixels. If n has a minus sign before it, then the new frame will shrink by that many pixels.