bug#4334: 23.1.50; truncate-partial-width-windows documentation problem

[Eli Zaretskii]

> From: "Xah Lee" <xah@xahlee.org>
> Date: Thu, 3 Sep 2009 09:27:44 -0700
> Cc: 
> 
> The doc reads this:
> 
> > Non-nil means truncate lines in windows with less than the frame width.
> 
> this seems to be that this var only has effect when its val is less than 
> frame width. So i set it to 30.

No, this means the variable only affects windows whose width is less
than the full frame width.  For example, windows you get after "C-x 3".

> > For an integer value, truncate lines in each window with less than the
> > full frame width, provided the window width is less than that integer;
> > otherwise, respect the value of `truncate-lines'.
> 
> I don't see any effect.

I do see the expected effect.

Try this:

  emacs -Q
  C-x 3

You should now see the initial blurb of the *scratch* buffer in both
of the 2 windows, and in both of them each line that is longer than
the window width will be truncated, i.e. its extra characters not
shown and a small right arrow appears in the right fringe indicating
that there are more characters in the line than displayed.

Now type this:

  M-x set-variable RET truncate-partial-width-windows RET 30 RET

You should now see that each long line is continued on the next visual
line, and the fringe shows that by displaying a curved arrow.

Now drag the vertical separator between the two windows to the right,
or use "C-x }" in the left window to make it wider.  At some point,
when the right window's width becomes less than the value of the
variable (30), the right window will again truncate its lines, whereas
the left one will still show continuation lines.

If all this works for you, then please suggest how to improve the doc
string.