From b6ebe1bd9e4f6692c390326bca0ef06c24255719 Mon Sep 17 00:00:00 2001 From: Chris Gregory Date: Mon, 1 Apr 2019 22:34:57 -0400 Subject: Document using `sync_all` --- src/libstd/fs.rs | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) (limited to 'src/libstd/fs.rs') 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 @@ use crate::time::SystemTime; /// 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 /// -- cgit 1.4.1-3-g733a5