bug#42154: 26.3; [DOC] This wording is too complex: frame's window-system window.

[Eli Zaretskii]

> From: Richard Stallman <rms@gnu.org>
> Cc: 42154@debbugs.gnu.org, eliz@gnu.org, ke.vigouroux@laposte.net
> Date: Sat, 04 Jul 2020 22:35:20 -0400
> 
>   > > Is the below better?
>   > > 
>   > >   If this is 'above', the window-system displays the window that
>   > >   corresponds to the frame above all other window-system's windows
>   > >   that do not have the 'above' property set.
> 
> It is better, but still ambiguous in
> 
>     the window that
>       > >   corresponds to the frame above all other window-system's windows
> 
> the frame above?
> displays the window above?

Concrete suggestions and patches are welcome.

> Also, what does "above" mean here?  y axis?  z axis?

This is explained in the preceding paragraph:

  ‘z-group’
       This parameter specifies a relative position of the frame’s
       window-system window in the stacking (Z-) order of the frame’s
       display.