martin rudalics <rudalics@gmx.at> writes:

>>    Select another window in cyclic ordering of windows.
>
> Hardly anyone knows what the cyclic ordering of windows is.

It's fine, it's used in the 'other-window' docstring, so people shoud
atleast have the some idea.  And if we assuem people don't read
docstrings, then they probably won't read this one, rather just try it,
and they will probably have pretty good idea of what it does then

> It was.

Good, the fall of Cons-tantinople has been finalised.  Bad joke.

> I think it's premature.  An average Emacs user has no idea of the
> internal structure of a frame's windows.
>

Ok, I removed it.

I have now fixed up the docstrings as well.  From a coding perspective,
is there anything we need to do now?

Also my email has changed, but it's still me (let me know if I go to
your spam).