docs(std): add error docs for path canonicalize

library/std/src/path.rs

@@ -3037,6 +3037,14 @@ pub fn symlink_metadata(&self) -> io::Result<fs::Metadata> {
     ///
     /// This is an alias to [`fs::canonicalize`].
     ///
+    /// # Errors
+    ///
+    /// This method will return an error in the following situations, but is not
+    /// limited to just these cases:
+    ///
+    /// * `path` does not exist.
+    /// * A non-final component in path is not a directory.
+    ///
     /// # Examples
     ///
     /// ```no_run