Function: rotate-windows-back

rotate-windows-back is an autoloaded, interactive and byte-compiled function defined in window-x.el.gz.

Signature

(rotate-windows-back &optional WINDOW)

Documentation

Rotate child windows of WINDOW backwards in cyclic ordering.

WINDOW must be a parent window and defaults to the main window of the selected frame. Interactively, with a prefix argument, rotate backwards the child windows of the selected window's parent.

Signal an error if WINDOW is not a parent window or descendants of WINDOW are of fixed size or atomic. Also signal an error if transpose-dedicated-windows is nil and a descendant window is dedicated.

Rotating windows backwards leaves the way a frame layout has been produced via splitting, deleting and resizing windows unaltered. It only "moves" windows within that layout such that the space formerly occupied by any window is now occupied by the window following it in the cycling ordering.

If you want to rotate the entire layout of windows backwards, consider using the function window-layout-rotate-anticlockwise instead. If you want to rotate a layout backwards twice in a row, consider running window-layout-flip-leftright and window-layout-flip-topdown instead.

View in manual

Probably introduced at or before Emacs version 31.1.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/window-x.el.gz
;;;###autoload
(defun rotate-windows-back (&optional window)
  "Rotate child windows of WINDOW backwards in cyclic ordering.
WINDOW must be a parent window and defaults to the main window of the
selected frame.  Interactively, with a prefix argument, rotate backwards
the child windows of the selected window's parent.

Signal an error if WINDOW is not a parent window or descendants of
WINDOW are of fixed size or atomic.  Also signal an error if
`transpose-dedicated-windows' is nil and a descendant window is
dedicated.

Rotating windows backwards leaves the way a frame layout has been
produced via splitting, deleting and resizing windows unaltered.  It
only \"moves\" windows within that layout such that the space formerly
occupied by any window is now occupied by the window following it in
the cycling ordering.

If you want to rotate the entire layout of windows backwards, consider
using the function `window-layout-rotate-anticlockwise' instead.  If you
want to rotate a layout backwards twice in a row, consider running
`window-layout-flip-leftright' and `window-layout-flip-topdown'
instead."
  (interactive (list (window--rotate-interactive-arg)))
  (rotate-windows window t))