Document eager evaluation of `bool::then_some` argument

1 files changed, 6 insertions, 0 deletions

diff --git a/library/core/src/bool.rs b/library/core/src/bool.rs
index f7a8aa0d921..267d787483d 100644
--- a/library/core/src/bool.rs
+++ b/library/core/src/bool.rs
@@ -6,6 +6,12 @@ impl bool {
     /// Returns `Some(t)` if the `bool` is [`true`](../std/keyword.true.html),
     /// or `None` otherwise.
     ///
+    /// Arguments passed to `then_some` are eagerly evaluated; if you are 
+    /// passing the result of a function call, it is recommended to use 
+    /// [`then`], which is lazily evaluated.
+    /// 
+    /// [`then`]: bool::then
+    /// 
     /// # Examples
     ///
     /// ```