From 2708f58da1d7758f604a08fad36de00a149c0200 Mon Sep 17 00:00:00 2001 From: Kirill Chibisov Date: Wed, 24 Dec 2025 00:41:12 +0900 Subject: [PATCH] text-input: clarify pre-edit cursor's start/end purpose The word `highlight` rather accurate, could be confused with selection by folks not familiar with IME matters, so clarify what it's for and that it's not a selection. Closes: https://gitlab.freedesktop.org/wayland/wayland-protocols/-/issues/304 Signed-off-by: Kirill Chibisov --- experimental/xx-text-input/xx-text-input-v3.xml | 5 ++++- unstable/text-input/text-input-unstable-v3.xml | 5 ++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/experimental/xx-text-input/xx-text-input-v3.xml b/experimental/xx-text-input/xx-text-input-v3.xml index 7add990..d782e5c 100644 --- a/experimental/xx-text-input/xx-text-input-v3.xml +++ b/experimental/xx-text-input/xx-text-input-v3.xml @@ -354,7 +354,10 @@ be hidden when both are equal to -1. They could be represented by the client as a line if both values are - the same, or as a text highlight otherwise. + the same, or as a text highlight otherwise. The purpose of such + representation is to clearly indicate the region that is being + edited inside the pre-edit and shouldn't be confused with text + selection. Values set with this event are double-buffered. They must be applied and reset to initial on the next xx_text_input_v3.done event. diff --git a/unstable/text-input/text-input-unstable-v3.xml b/unstable/text-input/text-input-unstable-v3.xml index c1c1b22..a1af34c 100644 --- a/unstable/text-input/text-input-unstable-v3.xml +++ b/unstable/text-input/text-input-unstable-v3.xml @@ -352,7 +352,10 @@ be hidden when both are equal to -1. They could be represented by the client as a line if both values are - the same, or as a text highlight otherwise. + the same, or as a text highlight otherwise. The purpose of such + representation is to clearly indicate the region that is being + edited inside the pre-edit and shouldn't be confused with text + selection. Values set with this event are double-buffered. They must be applied and reset to initial on the next zwp_text_input_v3.done event.