diff --git a/src/lib.rs b/src/lib.rs
index 3d5f05c4f..968fb528a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1675,6 +1675,9 @@ pub trait Itertools: Iterator {
     ///
     /// If `k` is greater than the length of the input iterator, the resultant
     /// iterator adaptor will be empty.
+    /// 
+    /// If you are looking for permutations with replacements,
+    /// use `repeat_n(iter, k).multi_cartesian_product()` instead.
     ///
     /// ```
     /// use itertools::Itertools;