diff --git a/src/libstd/keyword_docs.rs b/src/libstd/keyword_docs.rs
index 7d678ee3879a..ab8a55660cb0 100644
--- a/src/libstd/keyword_docs.rs
+++ b/src/libstd/keyword_docs.rs
@@ -72,8 +72,9 @@ mod as_keyword { }
 /// println!("Bye.");
 ///```
 ///
-/// When associated with `loop`, but not with any other kind of loop expression,
-/// `break` can return a value.  When no value is specified, `break;` returns `()`.
+/// When associated with `loop`, a break expression may be used to return a value from that loop.
+/// This is only valid with `loop` and not with any other type of loop.
+/// If no value is specified, `break;` returns `()`.
 /// Every `break` within a loop must return the same type.
 ///
 /// ```rust