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

> The last sentence should be the 2nd, because you mention WINDOW in the
> first sentence of the doc string.

Ok.

> Are these comments really no longer relevant?

They are relevant for the obsolete code, but they are misleading because
they describe an implementation that's no longer used.

I don't think we want to spend time fixing these functions, or any bugs in
them, and we don't want to encourage *more* unbundled packages or user code
using these functions. It's better to strip the comment, put a notice, and
let it be until we feel it's safe to just remove it all.