diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
index 6dd1538e4a1d3e8a1ed20a4729236b25601a07bc..fbb4727b50ed72c26c2bb14e4d4292f28d67ef68 100644
--- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
+++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
@@ -997,10 +997,10 @@
 	popup will be immediately dismissed. If the parent is a popup that did
 	not take an explicit grab, an error will be raised.
 
-	Clients will receive events for all their surfaces during this grab
-	(which is an "owner-events" grab in X11 parlance). This is done so that
-	users can navigate through submenus and other "nested" popup windows
-	without having to dismiss the topmost popup.
+	During a popup grab, the client owning the grab will receive pointer
+	and touch events for all their surfaces as normal (similar to an
+	"owner-events" grab in X11 parlance), while the top most grabbing popup
+	will always have keyboard focus.
       </description>
 
       <arg name="seat" type="object" interface="wl_seat"