Document which open commands will follow symlinks

library/std/src/fs.rs

@@ -548,6 +548,8 @@ impl File {
     /// consider [`std::fs::read()`][self::read] or
     /// [`std::fs::read_to_string()`][self::read_to_string] instead.
     ///
+    /// This call follows symlinks.
+    ///
     /// # Errors
     ///
     /// This function will return an error if `path` does not already exist.
@@ -580,6 +582,8 @@ impl File {
     /// consider [`std::fs::read()`][self::read] or
     /// [`std::fs::read_to_string()`][self::read_to_string] instead.
     ///
+    /// This call follows symlinks.
+    ///
     /// # Errors
     ///
     /// This function will return an error if `path` does not already exist,
@@ -622,6 +626,8 @@ impl File {
     /// See also [`std::fs::write()`][self::write] for a simple function to
     /// create a file with some given data.
     ///
+    /// This call follows symlinks.
+    ///
     /// # Examples
     ///
     /// ```no_run
@@ -653,6 +659,8 @@ impl File {
     /// See also [`std::fs::write()`][self::write] for a simple function to
     /// create a file with some given data.
     ///
+    /// This call follows symlinks.
+    ///
     /// # Examples
     ///
     /// ```no_run
@@ -696,6 +704,8 @@ impl File {
     /// [`AlreadyExists`]: crate::io::ErrorKind::AlreadyExists
     /// [TOCTOU]: self#time-of-check-to-time-of-use-toctou
     ///
+    /// This call does not follows symlinks.
+    ///
     /// # Examples
     ///
     /// ```no_run