From: Glenn Morris Date: Sat, 22 Feb 2014 21:49:10 +0000 (-0800) Subject: Misc small frame/window doc X-Git-Tag: emacs-24.3.90~173^2^2~11 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ca58fa737d4c91d132c127e4190a08dd75837190;p=emacs.git Misc small frame/window doc * src/frame.c (frame-alpha-lower-limit, frame-resize-pixelwise): * src/window.c (window-resize-pixelwise): Doc fixes. * etc/NEWS: Related edits. This including unmarking some items marked as ---, where it it not clear to me that no doc updates are needed. --- diff --git a/etc/NEWS b/etc/NEWS index cffe6c8b437..e1235e0fc47 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -193,26 +193,22 @@ bound to and M-, respectively. *** New hooks `focus-in-hook', `focus-out-hook'. These are normal hooks run when an Emacs frame gains or loses input focus. ---- -*** 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 change frame sizes in units of pixels, rather than +text rows or columns. When maximizing a frame or making it fullscreen, +remaining extra pixels are no longer given to the minibuffer, the rightmost +fringe, or other unusable space, but are distributed among the text +areas of the frame's windows. If the new option `frame-resize-pixelwise' +is non-nil, all frame size changes happen pixelwise and set the +corresponding size hints for the window manager. + +*** Emacs can now change window sizes in units of pixels. +Mouse-dragging a mode line or window divider now changes the size of +adjacent windows pixelwise. If the new option `window-resize-pixelwise' +is non-nil, functions like `balance-windows-area' and `fit-window-to-buffer' +resize windows pixelwise. Most functions for changing or accessing +window sizes now have an additional argument that allows changes to apply, +or values to be returned, 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 diff --git a/src/ChangeLog b/src/ChangeLog index 9c5d5a1b865..86605b97764 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -1,5 +1,8 @@ 2014-02-22 Glenn Morris + * frame.c (frame-alpha-lower-limit, frame-resize-pixelwise): + * window.c (window-resize-pixelwise): Doc fixes. + * process.c (Finternal_default_process_filter) (Finternal_default_process_sentinel): Doc tweaks. diff --git a/src/frame.c b/src/frame.c index 703c67a3b1e..2d01c6fecaa 100644 --- a/src/frame.c +++ b/src/frame.c @@ -4597,8 +4597,7 @@ is a reasonable practice. See also the variable `x-resource-name'. */); DEFVAR_LISP ("frame-alpha-lower-limit", Vframe_alpha_lower_limit, doc: /* The lower limit of the frame opacity (alpha transparency). The value should range from 0 (invisible) to 100 (completely opaque). -You can also use a floating number between 0.0 and 1.0. -The default is 20. */); +You can also use a floating number between 0.0 and 1.0. */); Vframe_alpha_lower_limit = make_number (20); #endif @@ -4736,8 +4735,8 @@ is non-nil, no rounding occurs, hence frame sizes can increase/decrease by one pixel. With some window managers you have to set this to non-nil in order to -fully maximize frames. The default of this option is nil. To resize -your initial frame pixelwise, set this option in your init file. */); +fully maximize frames. To resize your initial frame pixelwise, +set this option to a non-nil value in your init file. */); frame_resize_pixelwise = 0; staticpro (&Vframe_list); diff --git a/src/window.c b/src/window.c index 0f62838d672..0ec1aa96324 100644 --- a/src/window.c +++ b/src/window.c @@ -7309,11 +7309,10 @@ respectively are not installed by `window-state-put'. */); Vwindow_persistent_parameters = list1 (Fcons (Qclone_of, Qt)); DEFVAR_BOOL ("window-resize-pixelwise", window_resize_pixelwise, - doc: /* Non-nil means resizing windows works pixelwise. -Functions currently affected by this option are `split-window', -`maximize-window', `minimize-window', `fit-window-to-buffer' and -`fit-frame-to-buffer' and all functions symmetrically resizing a -parent window. + doc: /* Non-nil means resize windows pixelwise. +This currently affects the functions: `split-window', `maximize-window', +`minimize-window', `fit-window-to-buffer' and `fit-frame-to-buffer', and +all functions that symmetrically resize a parent window. Note that when a frame's pixel size is not a multiple of the frame's character size, at least one window may get resized