diff --git a/src/libcollections/str.rs b/src/libcollections/str.rs
index 124fe3fab56e9..5f1ace19f6d74 100644
--- a/src/libcollections/str.rs
+++ b/src/libcollections/str.rs
@@ -867,6 +867,10 @@ impl str {
     /// ```rust,ignore
     /// assert_eq!(d, &["a", "b", "c"]);
     /// ```
+    ///
+    /// Use [`.split_whitespace()`][split_whitespace] for this behavior.
+    ///
+    /// [split_whitespace]: #method.split_whitespace
     #[stable(feature = "rust1", since = "1.0.0")]
     pub fn split<'a, P: Pattern<'a>>(&'a self, pat: P) -> Split<'a, P> {
         core_str::StrExt::split(self, pat)