On Fri, Oct 25, 2019 at 3:43 PM Eli Zaretskii <eliz@gnu.org> wrote:

> So you are saying that nothing in those comments is relevant for the
> implementation of non-obsolete functions?  IOW, no reasonable amount
> of changes in the comments will ever yield anything useful for the
> code we now consider the mainstream?  If so, then yes, removing those
> comments is TRT.

Yes, I think so. The only relevant info in that big "implementation note"
fragment is a duplicate of the comment at the beginning of the file. The
rest are just details about how to find the window, or talk about window
and frame coordinates. Neither of those is relevant with the
`window-in-direction' implementation.