Variable: recenter-positions

recenter-positions is a customizable variable defined in window.el.gz.

Value

(middle top bottom)

Documentation

Cycling order for recenter-top-bottom.

A list of elements with possible values top, middle, bottom, integer or float numbers that define the cycling order for the command recenter-top-bottom.

Top and bottom destinations are scroll-margin lines from the true window top and bottom. Middle redraws the frame and centers point vertically within the window. Integer number moves current line to the specified absolute window-line. Float number between 0.0 and 1.0 means the percentage of the screen space from the top. The default cycling order is middle -> top -> bottom.

This variable was added, or its default value changed, in Emacs 23.2.

View in manual

Probably introduced at or before Emacs version 23.2.

Source Code

;; Defined in /usr/src/emacs/lisp/window.el.gz
(defcustom recenter-positions '(middle top bottom)
  "Cycling order for `recenter-top-bottom'.
A list of elements with possible values `top', `middle', `bottom',
integer or float numbers that define the cycling order for
the command `recenter-top-bottom'.

Top and bottom destinations are `scroll-margin' lines from the true
window top and bottom.  Middle redraws the frame and centers point
vertically within the window.  Integer number moves current line to
the specified absolute window-line.  Float number between 0.0 and 1.0
means the percentage of the screen space from the top.  The default
cycling order is middle -> top -> bottom."
  :type '(repeat (choice
		  (const :tag "Top" top)
		  (const :tag "Middle" middle)
		  (const :tag "Bottom" bottom)
		  (integer :tag "Line number")
		  (float :tag "Percentage")))
  :version "23.2"
  :group 'windows)