From f18b1a70434755b92a8f0a59e8aa0302309e8b3a Mon Sep 17 00:00:00 2001
From: Ivan Molodetskikh <yalterz@gmail.com>
Date: Wed, 5 Feb 2025 08:38:38 +0300
Subject: mapped: Document RequestSizeOnce

---
 src/window/mapped.rs | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'src')

diff --git a/src/window/mapped.rs b/src/window/mapped.rs
index 83a6360d..7b542574 100644
--- a/src/window/mapped.rs
+++ b/src/window/mapped.rs
@@ -84,6 +84,7 @@ pub struct Mapped {
     /// Snapshot right before an animated commit.
     animation_snapshot: Option<LayoutElementRenderSnapshot>,
 
+    /// State for the logic to request a size once (for floating windows).
     request_size_once: Option<RequestSizeOnce>,
 
     /// Transaction that the next configure should take part in, if any.
@@ -148,10 +149,14 @@ impl InteractiveResize {
     }
 }
 
+/// Request-size-once logic state.
 #[derive(Debug, Clone, Copy)]
 enum RequestSizeOnce {
+    /// Waiting for configure to be sent with the requested size.
     WaitingForConfigure,
+    /// Waiting for the window to commit in response to the configure.
     WaitingForCommit(Serial),
+    /// When configuring, use the current window size.
     UseWindowSize,
 }
 
-- 
cgit