diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 041e5f0..f52677f 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -1560,7 +1560,13 @@
     <!-- Version 3 additions -->
 
     <request name="release" type="destructor" since="3">
-      <description summary="release the pointer object"/>
+      <description summary="release the pointer object">
+        Using this request client can tell the server that it is not going to
+	use the pointer object anymore.
+
+	This request destroys the pointer proxy object, so user must not call
+	wl_pointer_destroy() after using this request.
+      </description>
     </request>
 
   </interface>