diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index 7fecaa8..229633d 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -839,8 +839,9 @@
       <entry name="maximized" value="1" summary="the surface is maximized">
 	<description summary="the surface is maximized">
 	  The surface is maximized. The window geometry specified in the configure
-	  event must be obeyed by the client, or the xdg_wm_base.invalid_surface_state
-	  error is raised.
+	  event must be obeyed by the client, or the compositor might not
+	  display the toplevel faithfully (e.g. show a warning, crop or scale
+	  the contents, display an overlay, etc).
 
 	  The client should draw without shadow or other
 	  decoration outside of the window geometry.