From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 23 Oct 2014 16:54:25 +0000 (+0300)
Subject: Document in the user manual variables that allow pixelwise resizing.
X-Git-Tag: emacs-24.4.90~315
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=894b567b1c8e74a615441147b956263484119702;p=emacs.git

Document in the user manual variables that allow pixelwise resizing.

 doc/emacs/frames.texi (Frame Commands): Document and index
 'frame-resize-pixelwise'.
 doc/emacs/windows.texi (Split Window): Document and index
 'window-resize-pixelwise'.
---

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index f383205b15e..232330faf1e 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,11 @@
+2014-10-23  Eli Zaretskii  <eliz@gnu.org>
+
+	* frames.texi (Frame Commands): Document and index
+	'frame-resize-pixelwise'.
+
+	* windows.texi (Split Window): Document and index
+	'window-resize-pixelwise'.
+
 2014-10-20  Glenn Morris  <rgm@gnu.org>
 
 	* ack.texi (Acknowledgments): Remove some obsolete items.
diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index 8c2289b83de..c02619e82c5 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -376,6 +376,9 @@ position (@pxref{Split Window}).
 between two side-by-side mode lines, you can move the vertical
 boundary to the left or right.
 
+  Note that resizing windows is affected by the value of
+@code{window-resize-pixelwise}, see @ref{Split Window}.
+
 @node Creating Frames
 @section Creating Frames
 @cindex creating frames
@@ -469,9 +472,13 @@ hides window manager decorations, giving slightly more screen space to
 Emacs itself.)
 @end table
 
+@vindex frame-resize-pixelwise
   Note that with some window managers you may have to customize the
 variable @code{frame-resize-pixelwise} to a non-@code{nil} value in
-order to make a frame truly ``maximized'' or ``fullscreen''.
+order to make a frame truly ``maximized'' or ``fullscreen''.  This
+variable, when set to a non-@code{nil} value, in general allows
+resizing frames at pixel resolution, rather than in integral multiples
+of lines and columns.
 
   The @kbd{C-x 5 0} (@code{delete-frame}) command deletes the selected
 frame.  However, it will refuse to delete the last frame in an Emacs
diff --git a/doc/emacs/windows.texi b/doc/emacs/windows.texi
index 4a5f24c13fb..4045908d4d5 100644
--- a/doc/emacs/windows.texi
+++ b/doc/emacs/windows.texi
@@ -134,6 +134,18 @@ clicking @kbd{C-Mouse-2} in the scroll bar, which puts a horizontal
 divider where you click (this feature does not work when Emacs uses
 GTK+ scroll bars).
 
+@vindex window-resize-pixelwise
+  By default, when you split a window, Emacs gives each of the
+resulting windows dimensions that are an integral multiple of the
+default font size of the frame.  That might subdivide the screen
+estate unevenly between the resulting windows.  If you set the
+variable @code{window-resize-pixelwise} to a non-@code{nil} value,
+Emacs will give each window the same number of pixels (give or take
+one pixel if the initial dimension was an odd number of pixels).  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 pixelwise even if
+this option is @code{nil}.
+
 @node Other Window
 @section Using Other Windows