Clarify behavior of image id==!0 and placement id == 0

See https://github.com/kovidgoyal/kitty/discussions/7043
This commit is contained in:
Kovid Goyal 2024-01-23 08:22:57 +05:30
parent 828f4f312a
commit f51520eb79
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C

View file

@ -460,7 +460,10 @@ When you specify a placement id, it will be added to the acknowledgement code
above. Every placement is uniquely identified by the pair of the ``image id``
and the ``placement id``. If you specify a placement id for an image that does
not have an id (i.e. has id=0), it will be ignored. In particular this means
there can exist multiple images with ``image id=0, placement id=0``.
there can exist multiple images with ``image id=0, placement id=0``. Not
specifying a placement id or using ``p=0`` for multiple put commands (``a=p``)
with the same non-zero image id results in multiple placements the image.
An example response::
<ESC>_Gi=<image id>,p=<placement id>;OK<ESC>\