From b7aa5ad686cb7f5a2c1e7b0a67d32b92d412c877 Mon Sep 17 00:00:00 2001 From: Martin Rudalics Date: Sat, 22 Feb 2014 18:57:57 +0100 Subject: [PATCH] Document some frame and window changes in NEWS. --- etc/NEWS | 88 ++++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 79 insertions(+), 9 deletions(-) diff --git a/etc/NEWS b/etc/NEWS index 84ac2a558e4..59875727cac 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -194,15 +194,67 @@ bound to and M-, respectively. These are normal hooks run when an Emacs frame gains or loses input focus. --- -*** Emacs can now draw dividers between adjacent windows. -To put dividers between side-by-side/vertically stacked windows -customize the frame parameter `right-divider-width'/`bottom-divider-width' -to some positive integer. You can drag dividers with the mouse -(they show a corresponding cursor when the mouse hovers over them). -You can change the appearance of dividers by customizing the faces -`window-divider', `window-divider-first-pixel', and -`window-divider-last-pixel'. The last two are useful to provide a 3D -effect, or to better distinguish dividers from surrounding display objects. +*** Emacs can now change frame sizes pixelwise. +When maximizing a frame or making it fullscreen, remaining extra pixels +are no more given to the minibuffer, the rightmost fringe, or other +unusable space, but are distributed among the text areas of the frame's +windows. The new option `frame-resize-pixelwise', when non-nil, makes +all frame size changes happen pixelwise and sets the corresponding size +hints for the window manager. + +--- +*** Emacs can now change window sizes pixelwise. +Mouse-dragging a modeline or window divider now changes the size of +adjacent windows pixelwise. The new option `window-resize-pixelwise', +when non-nil, automatically makes functions like `balance-windows-area' +or `fit-window-to-buffer' resize windows pixelwise. Most functions for +resizing or accessing sizes of windows now have an additional argument +which allows to apply changes or return values in pixels instead of +lines/columns. + +--- +*** Emacs can now draw dividers between adjacent windows. To put +dividers between side-by-side/vertically stacked windows customize the +frame parameters `right-divider-width' and `bottom-divider-width' to +some positive integer. You can drag dividers with the mouse (they show +a corresponding cursor when the mouse hovers over them). You can change +the appearance of dividers by customizing the faces `window-divider', +`window-divider-first-pixel', and `window-divider-last-pixel'. The last +two are useful to provide a 3D effect, or to better distinguish dividers +from surrounding display objects. + +--- +*** New functions are provided to return the pixel sizes of window +components, namely `window-scroll-bar-width', `window-mode-line-height' +`window-header-line-height', `window-right-divider-width' and +`window-bottom-divider-width'. + +--- +*** The new function `window-text-pixel-size' returns the size of the +text of a window's buffer in pixels. This allows functions like +`fit-frame-to-buffer' and `fit-window-to-buffer' to accurately fit a +window to its buffer as it will be displayed. + +--- +*** `fit-window-to-buffer' can now resize windows horizontally. +This behavior is controlled by the new option +`fit-window-to-buffer-horizontally'. + +--- +*** `fit-frame-to-buffer' can now fit frames in both directions. +This behavior is controlled by the option `fit-frame-to-buffer' which +tells in which direction(s) the frame shall be fit. The new options +`fit-frame-to-buffer-margins' and `fit-frame-to-buffer-sizes' allow to +control the size of the frame and its position on screen. + +--- +*** Temp Buffer Resize Mode can now adjust height and width of windows +and frames. `temp-buffer-resize-mode' is now able to adjust the height +and the width of a window displaying a temporary buffer. The new option +`temp-buffer-max-width' allows to control the width of temporary buffer +windows. Moreover, if the new option `fit-frame-to-buffer' is non-nil +and the buffer appears in the root window of a frame, Temp Buffer Resize +Mode will try to adjust width and/or height of the frame. --- *** `split-window' is now a non-interactive function, not a command. @@ -210,12 +262,30 @@ As a command, it was a special case of `C-x 2' (`split-window-below'), and as such superfluous. After being reimplemented in Lisp, its interactive form was mistakenly retained. +--- +*** The functions `window-size' and `window-total-size' now have an +optional argument to return a rounded size value. + +--- +*** `window-state-put' now allows to put a window state into internal +windows too. + +++ *** New option `scroll-bar-adjust-thumb-portion'. Available only on X, this option allows to control over-scrolling using the scroll bar (i.e. dragging the thumb down even when the end of the buffer is visible). +--- +*** New basic action function `display-buffer-in-previous-window' has +`display-buffer' display a buffer in a window previously showing that +buffer. + +--- +*** New basic action function `display-buffer-at-bottom' has +`display-buffer' choose or make a window at the bottom of the selected +frame. + ** Lisp evaluation changes +++ *** `eval-defun' on an already defined defcustom calls the :set function, -- 2.39.2