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

From: Eli Zaretskii <[email-masked]>
Date: Sun, 05 Jul 2020 17:33:02 +0300

> From: Richard Stallman <[email-masked]>
> Cc: [email-masked], [email-masked], [email-masked]
> 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.