diff --git a/unstable/text-input/text-input-unstable-v3.xml b/unstable/text-input/text-input-unstable-v3.xml
index c1c1b22..d3727f5 100644
--- a/unstable/text-input/text-input-unstable-v3.xml
+++ b/unstable/text-input/text-input-unstable-v3.xml
@@ -47,7 +47,7 @@
     interface version number is reset.
   </description>
 
-  <interface name="zwp_text_input_v3" version="1">
+  <interface name="zwp_text_input_v3" version="2">
     <description summary="text input">
       The zwp_text_input_v3 interface represents text input and input methods
       associated with a seat. It provides enter/leave events to follow the
@@ -273,6 +273,18 @@
         the text input does not support describing the cursor area. If the
         empty values get applied, subsequent attempts to change them may have
         no effect.
+
+        As of version 2, the zwp_text_input_v3.commit request does not apply
+        values sent with this request. Instead, it stores them in a separate "committed" area.
+        The committed values, if still valid, get applied on the next
+        wl_surface.commit request on the surface with text-input focus.
+        Both committed and applied values get invalidated on:
+        - the next committed enable or disable request, or
+        - a change of the focused surface of the text-input (leave or enter events).
+
+        This double stage application allows the compositor to position
+        uhe input method popup in the same frame as the contents
+        of the text on the surface are updated.
       </description>
       <arg name="x" type="int"/>
       <arg name="y" type="int"/>
@@ -434,7 +446,7 @@
     </event>
   </interface>
 
-  <interface name="zwp_text_input_manager_v3" version="1">
+  <interface name="zwp_text_input_manager_v3" version="2">
     <description summary="text input manager">
       A factory for text-input objects. This object is a global singleton.
     </description>