pos-visible-in-window-p documentation

pos-visible-in-window-p documentation

[Luc Teirlinck]

In revision 1.39 to lispref/windows.texi you changed the description
of `pos-visible-in-window-p' to say:

It returns `nil' if POSITION is scrolled vertically or horizontally
out of view.

Whereas the old documentation said that the function can return t if
POSITION is only out of view because of horizontal scrolling.
Checking it out empirically, it would appear that the _old_
documentation is correct.

The docstring says:

Return nil if that position is scrolled vertically out of view.

I believe that this particular part of revision 1.39 should be
reverted.  But am I missing something?

Sincerely,

Luc.

Re: pos-visible-in-window-p documentation

[Richard Stallman]

    Whereas the old documentation said that the function can return t if
    POSITION is only out of view because of horizontal scrolling.
    Checking it out empirically, it would appear that the _old_
    documentation is correct.

It does look like the change in the manual was a mistake,
so I guess you should change it back.  Thanks for noticing this.

It does puzzle me, though.  I must have thought for some reason
that this had been changed, and since I don't see what the reason
could have been, I don't know whether it had some kind
of validity at some point.