diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index 23bd8f6498b4a..17f890375f843 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -1445,7 +1445,10 @@ impl DirEntry {
     /// Returns the metadata for the file that this entry points at.
     ///
     /// This function will not traverse symlinks if this entry points at a
-    /// symlink.
+    /// symlink. To traverse symlinks use [`fs::metadata`] or [`fs::File::metadata`].
+    ///
+    /// [`fs::metadata`]: fn.metadata.html
+    /// [`fs::File::metadata`]: struct.File.html#method.metadata
     ///
     /// # Platform-specific behavior
     ///