diff options
| author | Jonas Ådahl <jadahl@gmail.com> | 2023-07-02 10:34:30 +0200 |
|---|---|---|
| committer | Simon Ser <contact@emersion.fr> | 2023-12-27 18:43:47 +0000 |
| commit | 46f201bd7b328ab5ac531231c030ca5c4090b1da (patch) | |
| tree | 4b9b6f73a3c21eecebe805f439305c35090e0831 /stable | |
| parent | 9d83649b4947b0e4932cd78c2d3f062b0228052a (diff) | |
xdg-shell: Clarify what a toplevel by default includes
xdg-shell assumes that the client provides all parts of a toplevel
window, i.e. things like titlebar, drop shadow. There are already things
here and there implies it, but it could be helpful to spell it out.
This doesn't change any semantics - it's still valid, from the
perspective of the protocol, to create a toplevel without any
decorations, and it always has been, it just means that the semantical
intention is for them to be exactly so.
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
Diffstat (limited to 'stable')
| -rw-r--r-- | stable/xdg-shell/xdg-shell.xml | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index 777eaa7..dca033e 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -625,6 +625,10 @@ id, and well as trigger user interactive operations such as interactive resize and move. + A xdg_toplevel by default is responsible for providing the full intended + visual representation of the toplevel, which depending on the window + state, may mean things like a title bar, window controls and drop shadow. + Unmapping an xdg_toplevel means that the surface cannot be shown by the compositor until it is explicitly mapped again. All active operations (e.g., move, resize) are canceled and all |