Reword OpenOptions::{create, create_new} doc.

This commit is contained in:
jumbatm
2020-02-19 19:57:32 +10:00
parent 3a8108d8e5
commit c899dc1401
+4 -8
View File
@@ -844,10 +844,7 @@ pub fn truncate(&mut self, truncate: bool) -> &mut OpenOptions {
self
}
/// Sets the option for creating a new file.
///
/// This option indicates whether a new file will be created if the file
/// does not yet already exist.
/// Sets the option to create a new file, or open it if it already exists.
///
/// In order for the file to be created, [`write`] or [`append`] access must
/// be used.
@@ -868,11 +865,10 @@ pub fn create(&mut self, create: bool) -> &mut OpenOptions {
self
}
/// Sets the option to always create a new file.
/// Sets the option to create a new file, failing if it already exists.
///
/// This option indicates whether a new file will be created.
/// No file is allowed to exist at the target location, also no (dangling)
/// symlink.
/// No file is allowed to exist at the target location, also no (dangling) symlink. In this
/// way, if the call succeeds, the file returned is guaranteed to be new.
///
/// This option is useful because it is atomic. Otherwise between checking
/// whether a file exists and creating a new one, the file may have been