diff --git a/src/libstd/thread/mod.rs b/src/libstd/thread/mod.rs
index 13965478aeea..3cd9cf7727c2 100644
--- a/src/libstd/thread/mod.rs
+++ b/src/libstd/thread/mod.rs
@@ -131,7 +131,7 @@
 //!
 //! * Build the thread with [`Builder`] and pass the desired stack size to [`Builder::stack_size`].
 //! * Set the `RUST_MIN_STACK` environment variable to an integer representing the desired stack
-//!   size (in bytes).
+//!   size (in bytes). Note that setting [`Builder::stack_size`] will override this.
 //!
 //! Note that the stack size of the main thread is *not* determined by Rust.
 //!