From f51520eb7910712436d48a106fd236704ea50472 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Tue, 23 Jan 2024 08:22:57 +0530 Subject: [PATCH] Clarify behavior of image id==!0 and placement id == 0 See https://github.com/kovidgoyal/kitty/discussions/7043 --- docs/graphics-protocol.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/graphics-protocol.rst b/docs/graphics-protocol.rst index 01a4cfe87..7ccef7413 100644 --- a/docs/graphics-protocol.rst +++ b/docs/graphics-protocol.rst @@ -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:: _Gi=,p=;OK\