From 9730142a7fa9f8d8ebbb5ad9dcb76960ea6f0825 Mon Sep 17 00:00:00 2001 From: dcz Date: Tue, 8 Jul 2025 09:05:05 +0000 Subject: [PATCH] xx-input-method: Clarify when state is reset Signed-off-by: Dorota Czaplejewicz --- experimental/xx-input-method/xx-input-method-v2.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/experimental/xx-input-method/xx-input-method-v2.xml b/experimental/xx-input-method/xx-input-method-v2.xml index b721beb..7660884 100644 --- a/experimental/xx-input-method/xx-input-method-v2.xml +++ b/experimental/xx-input-method/xx-input-method-v2.xml @@ -80,7 +80,7 @@ This event serves the purpose of providing the compositor with an active input method. - This event resets all state associated with previous enable, disable, + This event resets all state associated with previous surrounding_text, text_change_cause, and content_type events, as well as the state associated with set_preedit_string, commit_string, and delete_surrounding_text requests, and destroys any existing input_popup_surface objects. @@ -103,6 +103,11 @@ This event marks the xx_input_method_v1 object as inactive. compositor must destroy all existing xx_input_popup_surface_v2 objects. + This event resets all state associated with previous + surrounding_text, text_change_cause, and content_type events, as well + as the state associated with set_preedit_string, commit_string, and + delete_surrounding_text requests. + State set with this event is double-buffered. It will get applied on the next xx_input_method_v1.done event, and stay valid until changed. @@ -173,6 +178,7 @@ Values set with this event are double-buffered. They will get applied on the next xx_input_method_v1.done event. + They get reset to initial on the next committed deactivate event. The initial value for hint is none, and the initial value for purpose is normal. @@ -246,6 +252,7 @@ Values set with this request are double-buffered. They must be applied on the next xx_input_method_v1.commit request. + They must be reset to initial on the next committed disable event. The initial value of text is an empty string. The initial value of cursor_begin, and cursor_end are both 0.