diff --git a/library/std/src/io/error.rs b/library/std/src/io/error.rs
index 4e1d7c2ac65..8bd11911fb1 100644
--- a/library/std/src/io/error.rs
+++ b/library/std/src/io/error.rs
@@ -852,15 +852,15 @@ impl Error {
         }
     }
 
-    /// Attempt to downcast the inner error to `E` if any.
+    /// Attempt to downcast the custom boxed error to `E`.
     ///
-    /// If this [`Error`] was constructed via [`new`] then this function will
-    /// attempt to perform downgrade on it, otherwise it will return [`Err`].
+    /// If this [`Error`] when this contains a custom boxed error,
+    /// then it would attempt downcasting on the boxed error,
+    /// otherwise it will return [`Err`].
     ///
-    /// If the downcast succeeds, it will return [`Ok`], otherwise it will also
-    /// return [`Err`].
+    /// If the custom boxed error has the same type as `E`, it will return [`Ok`],
+    /// otherwise it will also return [`Err`].
     ///
-    /// [`new`]: Error::new
     ///
     /// # Examples
     ///