From 0dbbedfb5e316dfa23ce61fd23e6ea7e3e91d88b Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Wed, 2 Sep 2026 10:14:32 +0530 Subject: [PATCH] Add a note about text/uri-list lifetime --- docs/dnd-protocol.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/dnd-protocol.rst b/docs/dnd-protocol.rst index aaae43c21..09806c0f7 100644 --- a/docs/dnd-protocol.rst +++ b/docs/dnd-protocol.rst @@ -144,6 +144,14 @@ queued data requests must be discarded by the terminal. The ``operation`` is required and must specify the final action the client took with the data. If unset (aka ``0``) the terminal must assume the drop was canceled. +.. note:: + + On some platforms, such as macOS, there is no :code:`text/uri-list` + MIME type. It gets synthesized from underlying structures such as file + promises. In such cases, the files pointed to by the URLs are only + guaranteed to exist while the drop is active, clients should copy out the + files before closing the drop, to ensure continued access to them. + Dropping from remote machines ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^