From c61399a0cc6947131f8f8a181bcbdca9d14747c4 Mon Sep 17 00:00:00 2001 From: Xaver Hugl Date: Thu, 17 Jul 2025 18:18:17 +0200 Subject: [PATCH] xdg-shell: warn about putting UI outside of window geometry There should only be decoration outside of it, no functional UI elements. This is especially important on some compositors that clip windows to their window geometry in some situations (like when it's in a tile). Signed-off-by: Xaver Hugl --- stable/xdg-shell/xdg-shell.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index fb7b8b4..39ecf8a 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -514,7 +514,10 @@ The window geometry of a surface is its "visible bounds" from the user's perspective. Client-side decorations often have invisible portions like drop-shadows which should be ignored for the - purposes of aligning, placing and constraining windows. + purposes of aligning, placing and constraining windows. Note that + in some situations, compositors may clip rendering to the window + geometry, so the client should avoid putting functional elements + outside of it. The window geometry is double-buffered state, see wl_surface.commit.