Variable: window-adjust-process-window-size-function

window-adjust-process-window-size-function is a customizable variable defined in window.el.gz.

Value

window-adjust-process-window-size-smallest

Documentation

Control how Emacs chooses inferior process window sizes.

Emacs uses this function to tell processes the space they have available for displaying their output. After each window configuration change, Emacs calls the value of window-adjust-process-window-size-function for each process with a buffer being displayed in at least one window. This function is responsible for combining the sizes of the displayed windows and returning a cons (WIDTH . HEIGHT) describing the width and height with which Emacs will call set-process-window-size for that process. If the function returns nil, Emacs does not call set-process-window-size.

This function is called with the process buffer as the current buffer and with two arguments: the process and a list of windows displaying process. Modes can make this variable buffer-local; additionally, the adjust-window-size-function process property overrides the global or buffer-local value of window-adjust-process-window-size-function.

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

View in manual

Probably introduced at or before Emacs version 25.1.

Source Code

;; Defined in /usr/src/emacs/lisp/window.el.gz
;; Automatically inform subprocesses of changes to window size.

(defcustom window-adjust-process-window-size-function
  'window-adjust-process-window-size-smallest
  "Control how Emacs chooses inferior process window sizes.
Emacs uses this function to tell processes the space they have
available for displaying their output.  After each window
configuration change, Emacs calls the value of
`window-adjust-process-window-size-function' for each process
with a buffer being displayed in at least one window.
This function is responsible for combining the sizes of the
displayed windows and returning a cons (WIDTH . HEIGHT)
describing the width and height with which Emacs will call
`set-process-window-size' for that process.  If the function
returns nil, Emacs does not call `set-process-window-size'.

This function is called with the process buffer as the current
buffer and with two arguments: the process and a list of windows
displaying process.  Modes can make this variable buffer-local;
additionally, the `adjust-window-size-function' process property
overrides the global or buffer-local value of
`window-adjust-process-window-size-function'."
  :type '(choice
          (const :tag "Minimum area of any window"
           window-adjust-process-window-size-smallest)
          (const :tag "Maximum area of any window"
           window-adjust-process-window-size-largest)
          (const :tag "Do not adjust process window sizes" ignore)
          function)
  :group 'windows
  :version "25.1")