diff --git a/include/wlr/types/wlr_pointer_constraints_v1.h b/include/wlr/types/wlr_pointer_constraints_v1.h
index a1fa88633..f97413e22 100644
--- a/include/wlr/types/wlr_pointer_constraints_v1.h
+++ b/include/wlr/types/wlr_pointer_constraints_v1.h
@@ -55,8 +55,7 @@ struct wlr_pointer_constraint_v1 {
 
 	struct {
 		/**
-		 * Called when a pointer constraint's region is updated,
-		 * post-surface-commit.
+		 * Emitted when a pointer constraint's region is updated.
 		 */
 		struct wl_signal set_region;
 		struct wl_signal destroy;
@@ -81,13 +80,7 @@ struct wlr_pointer_constraints_v1 {
 
 	struct {
 		struct wl_signal destroy;
-
-		/**
-		 * Called when a new pointer constraint is created.
-		 *
-		 * The data pointer is a struct wlr_pointer_constraint_v1.
-		 */
-		struct wl_signal new_constraint;
+		struct wl_signal new_constraint; // struct wlr_pointer_constraint_v1
 	} events;
 
 	void *data;