mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-06-08 22:28:24 +02:00
Code Issues Packages Projects Releases Wiki Activity

Graphics protocol: Add a note clarifying image update behavior on re-transmission

Browse Source 
See #8701
This commit is contained in:
Kovid Goyal
2025-06-03 07:41:21 +05:30
parent fe391bf2ac
commit a023a0db09
2 changed files with 11 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/changelog.rst
View File

@@ -121,6 +121,8 @@ Detailed list of changes
- Fix a crash when using linear easing curves for animations (:iss:`8692`) - Fix a crash when using linear easing curves for animations (:iss:`8692`)
- Graphics protocol: Add a note clarifying image update behavior on re-transmission (:iss:`8701`)
0.42.1 [2025-05-17] 0.42.1 [2025-05-17]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

10
docs/graphics-protocol.rst
View File

@@ -339,7 +339,7 @@ similar to reporting any other kind of I/O error. Since the file paths come
from potentially untrusted sources, terminal emulators **must** refuse to read from potentially untrusted sources, terminal emulators **must** refuse to read
any device/socket/etc. special files. Only regular files are allowed. any device/socket/etc. special files. Only regular files are allowed.
Additionally, terminal emulators may refuse to read files in *sensitive* Additionally, terminal emulators may refuse to read files in *sensitive*
parts of the filesystem, such as :file:`/proc`, :file:`/sys`, :file:`/dev/`, etc. parts of the filesystem, such as :file:`/proc`, :file:`/sys`, :file:`/dev`, etc.
Local client Local client
^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^
@@ -483,6 +483,14 @@ second one will replace the first. This can be used to resize or move
placements around the screen, without flicker. placements around the screen, without flicker.
.. note::
When re-transmitting image data for a specific id, the existing image and
all its placements must be deleted. The new data replaces the old image data
but is not actually displayed until a placement for it is created. This is
to avoid divergent behavior in the case when unrelated programs happen to re-use
image ids in the same session.
.. versionadded:: 0.19.3 .. versionadded:: 0.19.3
Support for specifying placement ids (see :doc:`kittens/query_terminal` to query kitty version) Support for specifying placement ids (see :doc:`kittens/query_terminal` to query kitty version)