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 cffe6c8b437551c06f60fb57bbe22ac0c364d363..e1235e0fc47515bb7e684674ad49d0cc8954b42c 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -193,26 +193,22 @@ bound to <f11> and M-<f10>, 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 9c5d5a1b865c31483729ea8694b29defaf9691e0..86605b9776491d18e53ec7acb62e460288278309 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,5 +1,8 @@
 2014-02-22  Glenn Morris  <rgm@gnu.org>
 
+       * 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 703c67a3b1e18bf786b8d081df12d61fffaa26cc..2d01c6fecaa3ef394ae61183361cbc408bb3d937 100644 (file)
--- 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 0f62838d672e2b42e7a71157643b8a80c1651ac7..0ec1aa963240e0b70bafc45fd9ccdda4b62a329f 100644 (file)
--- 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