generalize warning

rust-lang · Oct 13, 2020 · a6d98d8 · a6d98d8
1 parent 72a5cbb
commit a6d98d8
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 8 deletions.
diff --git a/library/std/src/f32.rs b/library/std/src/f32.rs
@@ -206,11 +206,10 @@ impl f32 {
     /// Fused multiply-add. Computes `(self * a) + b` with only one rounding
     /// error, yielding a more accurate result than an unfused multiply-add.
     ///
-    /// Using `mul_add` *can* be more performant than an unfused multiply-add if
+    /// Using `mul_add` *may* be more performant than an unfused multiply-add if
     /// the target architecture has a dedicated `fma` CPU instruction. However,
-    /// this is not always true, and care must be taken not to overload the
-    /// architecture's available FMA units when using many FMA instructions
-    /// in a row, which can cause a stall and performance degradation.
+    /// this is not always true, and will be heavily dependant on designing
+    /// algorithms with specific target hardware in mind.
     ///
     /// # Examples
     ///

diff --git a/library/std/src/f64.rs b/library/std/src/f64.rs
@@ -206,11 +206,10 @@ impl f64 {
     /// Fused multiply-add. Computes `(self * a) + b` with only one rounding
     /// error, yielding a more accurate result than an unfused multiply-add.
     ///
-    /// Using `mul_add` *can* be more performant than an unfused multiply-add if
+    /// Using `mul_add` *may* be more performant than an unfused multiply-add if
     /// the target architecture has a dedicated `fma` CPU instruction. However,
-    /// this is not always true, and care must be taken not to overload the
-    /// architecture's available FMA units when using many FMA instructions
-    /// in a row, which can cause a stall and performance degradation.
+    /// this is not always true, and will be heavily dependant on designing
+    /// algorithms with specific target hardware in mind.
     ///
     /// # Examples
     ///