From 1035e456c9fb0bd3b34c82f8b3dd5bfc80b4b35f Mon Sep 17 00:00:00 2001
From: Ashley Wulber <ashley@system76.com>
Date: Fri, 22 Sep 2023 15:34:56 -0400
Subject: [PATCH] chore(data-device): document that the offer may need to be
 manually destroyed after leave

---
 src/data_device_manager/data_device.rs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/data_device_manager/data_device.rs b/src/data_device_manager/data_device.rs
index 19bbb3951..0e6e7e76d 100644
--- a/src/data_device_manager/data_device.rs
+++ b/src/data_device_manager/data_device.rs
@@ -34,7 +34,8 @@ pub trait DataDeviceHandler: Sized {
     fn enter(&mut self, conn: &Connection, qh: &QueueHandle<Self>, data_device: &WlDataDevice);
 
     /// The drag and drop pointer has left the surface and the session ends.
-    /// The offer will be destroyed.
+    /// The offer will be destroyed unless it was previously dropped.
+    /// In the case of a dropped offer, the client must destroy it manually after it is finished.
     fn leave(&mut self, conn: &Connection, qh: &QueueHandle<Self>, data_device: &WlDataDevice);
 
     /// Drag and Drop motion.