mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-07-24 17:27:39 +02:00
Code Issues Packages Projects Releases Wiki Activity

Clarify handling of subdirs in drag source

Browse Source
This commit is contained in:
Kovid Goyal
2026-05-17 14:51:37 +05:30
parent ec8d23258c
commit e2727d91fb
1 changed files with 4 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/dnd-protocol.rst
View File

@@ -416,11 +416,13 @@ Every directory must be transmitted with ``X=handle``. The payload
is a null separated list of regular files, directories and symlinks in the is a null separated list of regular files, directories and symlinks in the
directory. ``handle`` is an integer other than ``0`` or ``1`` directory. ``handle`` is an integer other than ``0`` or ``1``
that serves as an identifier for the directory. Directories should be traversed that serves as an identifier for the directory. Directories should be traversed
in breadth first order. The children of a directory are reported by in breadth first order. The children of a directory are sent by
adding ``Y=parent-handle:y=num`` to the escape codes above. Here adding ``Y=parent-handle:y=num`` to the escape codes above. Here
``parent-handle`` is the handle of the directory being traversed and ``num`` ``parent-handle`` is the handle of the directory being traversed and ``num``
is the one based index into the list of entries in the directory. Thus, the is the one based index into the list of entries in the directory. Thus, the
set of keys ``x, y, Y`` uniquely determine an entry. set of keys ``x, y, Y`` uniquely determine an entry. Clients **must** send all
children of directories, recursively, terminals **must not** make requests
for children of directories, only for the entries from the ``text/uri-list``.
If any error occurs in the client while reading the data, it can inform If any error occurs in the client while reading the data, it can inform
the terminal using:: the terminal using::