From e7fea17be8dcfa05faa3f37ce99b036a0b59c234 Mon Sep 17 00:00:00 2001 From: Nick Diego Yamane Date: Thu, 3 Oct 2024 07:13:38 -0400 Subject: [PATCH] xdg-toplevel-drag: clarify offset is relative to geometry The current description is not clear about it, though the only available implementation works like that, so make it explicit in the protocol description. Signed-off-by: Nick Diego Yamane --- staging/xdg-toplevel-drag/xdg-toplevel-drag-v1.xml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/staging/xdg-toplevel-drag/xdg-toplevel-drag-v1.xml b/staging/xdg-toplevel-drag/xdg-toplevel-drag-v1.xml index 2fe9645..e14497d 100644 --- a/staging/xdg-toplevel-drag/xdg-toplevel-drag-v1.xml +++ b/staging/xdg-toplevel-drag/xdg-toplevel-drag-v1.xml @@ -118,9 +118,10 @@ Request that the window will be moved with the cursor during the drag operation. The offset is a hint to the compositor how the toplevel should be positioned relative to the cursor hotspot in surface local - coordinates. For example it might only be used when an unmapped window - is attached. The attached window does not participate in the selection - of the drag target. + coordinates and relative to the geometry of the toplevel being attached. + See xdg_surface.set_window_geometry. For example it might only + be used when an unmapped window is attached. The attached window + does not participate in the selection of the drag target. If the toplevel is unmapped while it is attached, it is automatically detached from the drag. In this case this request has to be called again