From 4d2bd4e0e98bbc9d506b83f6357787ad037ab12e Mon Sep 17 00:00:00 2001
From: Tristan F <LeoDog896@hotmail.com>
Date: Thu, 10 Aug 2023 14:59:09 -0400
Subject: [PATCH] docs: mention permute with replacement

---
 src/lib.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/lib.rs b/src/lib.rs
index 3d5f05c4f..c8422f531 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1676,6 +1676,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;
     ///