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

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

View File

@@ -121,6 +121,8 @@ Detailed list of changes
- 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]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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
any device/socket/etc. special files. Only regular files are allowed.
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
^^^^^^^^^^^^^^
@@ -483,6 +483,14 @@ second one will replace the first. This can be used to resize or move
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
Support for specifying placement ids (see :doc:`kittens/query_terminal` to query kitty version)