From 480cbfd4effc3a2e45c20cd74dffa814ec9805c5 Mon Sep 17 00:00:00 2001
From: FredApps <153173854+FredApps@users.noreply.github.com>
Date: Thu, 5 Nov 2026 05:18:38 +0100
Subject: [PATCH] Textures::thumb: document the stale thumbnail returned over
 budget

---
 crates/ui-egui/src/textures.rs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/crates/ui-egui/src/textures.rs b/crates/ui-egui/src/textures.rs
index d0f764066..e6e051457 100644
--- a/crates/ui-egui/src/textures.rs
+++ b/crates/ui-egui/src/textures.rs
@@ -361,8 +361,9 @@ impl Textures {
         self.thumbs.clear();
     }
 
-    /// A thumbnail texture; renders at most `budget` new thumbnails per frame (returns None when
-    /// it is over budget, so the caller draws a placeholder and asks for another frame).
+    /// A thumbnail texture; renders at most `budget` new thumbnails per frame. Over budget it
+    /// returns the slide's previous thumbnail if there is one (and asks for another frame), else
+    /// None, so the caller draws a placeholder.
     /// When `grayscale` is true, the thumbnail renders in black-and-white (matching Grayscale view).
     pub fn thumb(
         &mut self,