about summary refs log tree commit diff
path: root/src/libstd
diff options
context:
space:
mode:
authorAlexis Hunt <lexer@google.com>2018-02-17 08:47:03 -0500
committerAlexis Hunt <lexer@google.com>2018-02-17 08:47:03 -0500
commitec905975b85d504abdd428be668346d008bc7a69 (patch)
tree33037b3bfeda54126474f815a8943b696ef28705 /src/libstd
parente9c75a889f972ca88b9c41d0ddb4b0cf487c5ebe (diff)
downloadrust-ec905975b85d504abdd428be668346d008bc7a69.tar.gz
rust-ec905975b85d504abdd428be668346d008bc7a69.zip
Wording fixes from review for File.
Diffstat (limited to 'src/libstd')
-rw-r--r--src/libstd/fs.rs10
1 files changed, 5 insertions, 5 deletions
diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index 1798bf4760b..292a78278ab 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -82,12 +82,12 @@ use time::SystemTime;
 /// ```
 ///
 /// Note that, although read and write methods require a `&mut File`, because
-/// of the interfaces for [`Read`] and [`Write`], it is still possible to
-/// modify a file through a `&File`, either through methods that take `&File`
-/// or by retrieving a raw OS filehandle and modifying the file that way.
+/// of the interfaces for [`Read`] and [`Write`], the holder of a `&File` can
+/// still modify the file, either through methods that take `&File` or by
+/// retrieving the underlying OS object and modifying the file that way.
 /// Additionally, many operating systems allow concurrent modification of files
-/// by different processes. Care should be taken not to assume that holding a
-/// `&File` means that the file will not change.
+/// by different processes. Avoid assuming that holding a `&File` means that the
+/// file will not change.
 ///
 /// [`Seek`]: ../io/trait.Seek.html
 /// [`String`]: ../string/struct.String.html