From: Chris Gregory <czipperz@gmail.com>
Date: Tue, 2 Apr 2019 02:34:57 +0000 (-0400)
Subject: Document using `sync_all`
X-Git-Url: https://git.lizzy.rs/?a=commitdiff_plain;h=b6ebe1bd9e4f6692c390326bca0ef06c24255719;p=rust.git

Document using `sync_all`
---

diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index 06d8ee99b64..99dd0d8eeeb 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -21,10 +21,9 @@
 /// it was opened with. Files also implement [`Seek`] to alter the logical cursor
 /// that the file contains internally.
 ///
-/// Files are automatically closed when they go out of scope.  All errors are
-/// ignored due to complications with correctly handling them.  For instance, an
-/// error in closing a file could mean that closing failed, or that the file had
-/// an error before closing that was only unearthed by closing the file.
+/// Files are automatically closed when they go out of scope.  Errors detected
+/// on closing are ignored by the implementation of `Drop`.  Use the method
+/// `sync_all` if these errors must be manually handled.
 ///
 /// # Examples
 ///