From d2e1f725db05feee42d19f73728fb724db8ff209 Mon Sep 17 00:00:00 2001
From: theotherphil <phil.j.ellison@gmail.com>
Date: Thu, 19 Jun 2025 20:33:49 +0100
Subject: [PATCH] deny(missing_docs) for bevy_window (#19655)

# Objective

Write some more boilerplate-y docs, to get one crate closer to closing
https://github.com/bevyengine/bevy/issues/3492.
---
 crates/bevy_window/src/event.rs | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/crates/bevy_window/src/event.rs b/crates/bevy_window/src/event.rs
index 5a320439d7..81360ef9c4 100644
--- a/crates/bevy_window/src/event.rs
+++ b/crates/bevy_window/src/event.rs
@@ -502,38 +502,66 @@ impl AppLifecycle {
     all(feature = "serialize", feature = "bevy_reflect"),
     reflect(Serialize, Deserialize)
 )]
-#[expect(missing_docs, reason = "Not all docs are written yet, see #3492.")]
 pub enum WindowEvent {
+    /// An application lifecycle event.
     AppLifecycle(AppLifecycle),
+    /// The user's cursor has entered a window.
     CursorEntered(CursorEntered),
+    ///The user's cursor has left a window.
     CursorLeft(CursorLeft),
+    /// The user's cursor has moved inside a window.
     CursorMoved(CursorMoved),
+    /// A file drag and drop event.
     FileDragAndDrop(FileDragAndDrop),
+    /// An Input Method Editor event.
     Ime(Ime),
+    /// A redraw of all of the application's windows has been requested.
     RequestRedraw(RequestRedraw),
+    /// The window's OS-reported scale factor has changed.
     WindowBackendScaleFactorChanged(WindowBackendScaleFactorChanged),
+    /// The OS has requested that a window be closed.
     WindowCloseRequested(WindowCloseRequested),
+    /// A new window has been created.
     WindowCreated(WindowCreated),
+    /// A window has been destroyed by the underlying windowing system.
     WindowDestroyed(WindowDestroyed),
+    /// A window has received or lost focus.
     WindowFocused(WindowFocused),
+    /// A window has been moved.
     WindowMoved(WindowMoved),
+    /// A window has started or stopped being occluded.
     WindowOccluded(WindowOccluded),
+    /// A window's logical size has changed.
     WindowResized(WindowResized),
+    /// A window's scale factor has changed.
     WindowScaleFactorChanged(WindowScaleFactorChanged),
+    /// Sent for windows that are using the system theme when the system theme changes.
     WindowThemeChanged(WindowThemeChanged),
 
+    /// The state of a mouse button has changed.
     MouseButtonInput(MouseButtonInput),
+    /// The physical position of a pointing device has changed.
     MouseMotion(MouseMotion),
+    /// The mouse wheel has moved.
     MouseWheel(MouseWheel),
 
+    /// A two finger pinch gesture.
     PinchGesture(PinchGesture),
+    /// A two finger rotation gesture.
     RotationGesture(RotationGesture),
+    /// A double tap gesture.
     DoubleTapGesture(DoubleTapGesture),
+    /// A pan gesture.
     PanGesture(PanGesture),
 
+    /// A touch input state change.
     TouchInput(TouchInput),
 
+    /// A keyboard input.
     KeyboardInput(KeyboardInput),
+    /// Sent when focus has been lost for all Bevy windows.
+    ///
+    /// Used to clear pressed key state.
     KeyboardFocusLost(KeyboardFocusLost),
 }