reword new_surface docs

include/wlr/types/wlr_xdg_shell.h

@@ -17,9 +17,8 @@ struct wlr_xdg_shell {
 		/**
 		 * The `new_surface` event signals that a client has requested to
 		 * create a new shell surface. At this point, the surface is ready to
-		 * be configured but not ready to be managed by the compositor by
+		 * be configured but is not mapped or ready receive input events. The
-		 * adding it to a list of views. The surface will be ready to be
+		 * surface will be ready to be managed on the `map` event.
-		 * managed on the `map` event.
 		 */
 		struct wl_signal new_surface;
 	} events;

include/wlr/types/wlr_xdg_shell_v6.h

@@ -18,9 +18,8 @@ struct wlr_xdg_shell_v6 {
 		/**
 		 * The `new_surface` event signals that a client has requested to
 		 * create a new shell surface. At this point, the surface is ready to
-		 * be configured but not ready to be managed by the compositor by
+		 * be configured but is not mapped or ready receive input events. The
-		 * adding it to a list of views. The surface will be ready to be
+		 * surface will be ready to be managed on the `map` event.
-		 * managed on the `map` event.
 		 */
 		struct wl_signal new_surface;
 	} events;