# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1227676069 0
# Node ID fecb8cbd43ef3dca2248ffb14359e0a10e668627
# Parent  7e3829f220064f1ece8d42d4ae9dff241517baf7
(Split Window): Document integer values of
truncate-partial-width-windows.

diff -r 7e3829f22006 -r fecb8cbd43ef doc/emacs/windows.texi
--- a/doc/emacs/windows.texi	Wed Nov 26 05:07:40 2008 +0000
+++ b/doc/emacs/windows.texi	Wed Nov 26 05:07:49 2008 +0000
@@ -107,12 +107,20 @@
 your click.
 
 @vindex truncate-partial-width-windows
-  When a window is less than the full width, text lines too long to
-fit are frequent.  Continuing all those lines might be confusing, so
-if the variable @code{truncate-partial-width-windows} is
-non-@code{nil}, that forces truncation in all windows less than the
-full width of the screen, independent of the buffer being displayed
-and its value for @code{truncate-lines}.  @xref{Line Truncation}.
+  When a window occupies less than the full width of the frame, it may
+become too narrow for most of the text lines in its buffer.  If most
+of its lines are continued, the buffer may become difficult to read.
+Therefore, Emacs automatically truncates lines if the window width
+becomes narrower than 50 columns.  This truncation occurs regardless
+of the value of the variable @code{truncate-lines} (@pxref{Line
+Truncation}); it is instead controlled by the variable
+@code{truncate-partial-width-windows}.  If the value of
+@code{truncate-partial-width-windows} is a positive integer (the
+default is 50), that specifies the minimum width for a partial-width
+window before automatic line truncation occurs; if the value is
+@code{nil}, automatic line truncation is disabled; and for any other
+non-@code{nil} value, Emacs truncates lines in every partial-width
+window regardless of its width.
 
   Horizontal scrolling is often used in side-by-side windows.
 @xref{Horizontal Scrolling}.