diff --git a/library/std/src/collections/hash/set.rs b/library/std/src/collections/hash/set.rs index 19428fe9a23..6ca4b7fa2d9 100644 --- a/library/std/src/collections/hash/set.rs +++ b/library/std/src/collections/hash/set.rs @@ -588,6 +588,13 @@ where /// Visits the values representing the intersection, /// i.e., the values that are both in `self` and `other`. /// + /// Note: this operation does not guarantee which collection + /// is visited from `self` or `other`. This has consequences + /// for values which may be defined as equal by the `Eq` trait + /// but which are not physically equivalent (eg. they may have + /// fields which differ or do not participate in the definition + /// of equivalence). + /// /// # Examples /// /// ```