diff --git a/src/libstd/primitive_docs.rs b/src/libstd/primitive_docs.rs
index a9aa2dc267190..c729fab373f1c 100644
--- a/src/libstd/primitive_docs.rs
+++ b/src/libstd/primitive_docs.rs
@@ -12,7 +12,8 @@
 //
 /// The boolean type.
 ///
-/// The `bool` represents a value, which could only be either `true` or `false`.
+/// The `bool` represents a value, which could only be either `true` or `false`. If you cast
+/// a `bool` into an integer, `true` will be 1 and `false` will be.
 ///
 /// # Basic usage
 ///