Document some frame and window changes in NEWS.

1 files 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 <f11> and M-<f10>, 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,