diff --git a/egui/src/ui.rs b/egui/src/ui.rs
index 7dc436b7..1b0f6439 100644
--- a/egui/src/ui.rs
+++ b/egui/src/ui.rs
@@ -1397,6 +1397,10 @@ impl Ui {
         )
     }
 
+    /// The new layout will take up all available space.
+    ///
+    /// Consider using [`Self::allocate_ui_with_layout`] instead,
+    /// or the helpers [`Self::horizontal]`, [`Self::vertical`], etc.
     pub fn with_layout<R>(
         &mut self,
         layout: Layout,