[Emacs-diffs] trunk r116530: Misc small frame/window doc

[Glenn Morris]

------------------------------------------------------------
revno: 116530
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2014-02-22 13:49:10 -0800
message:
  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.
modified:
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/frame.c                    frame.c-20091113204419-o5vbwnq5f7feedwu-243
  src/window.c                   window.c-20091113204419-o5vbwnq5f7feedwu-231

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-02-22 21:20:49 +0000
+++ b/etc/NEWS  2014-02-22 21:49:10 +0000
@@ -193,26 +193,22 @@
 *** 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

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2014-02-22 21:08:22 +0000
+++ b/src/ChangeLog     2014-02-22 21:49:10 +0000
@@ -1,5 +1,8 @@
 2014-02-22  Glenn Morris  <address@hidden>
 
+       * 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.
 

=== modified file 'src/frame.c'
--- a/src/frame.c       2014-01-11 10:01:01 +0000
+++ b/src/frame.c       2014-02-22 21:49:10 +0000
@@ -4597,8 +4597,7 @@
   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 @@
 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);

=== modified file 'src/window.c'
--- a/src/window.c      2014-02-21 08:02:05 +0000
+++ b/src/window.c      2014-02-22 21:49:10 +0000
@@ -7309,11 +7309,10 @@
   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