Improve documentation for File::options to give a more likely example

`File::options().read(true).open(...)` is equivalent to just
`File::open`. Change the example to set the `append` flag instead, and
then change the filename to something more likely to be written in
append mode.
This commit is contained in:
Josh Triplett 2022-01-09 14:08:08 -08:00 committed by Mark Rousskov
parent 89b9f7b284
commit c91ad5d0f2
1 changed files with 5 additions and 4 deletions

View File

@ -356,9 +356,10 @@ impl File {
/// open or create a file with specific options if `open()` or `create()` /// open or create a file with specific options if `open()` or `create()`
/// are not appropriate. /// are not appropriate.
/// ///
/// It is equivalent to `OpenOptions::new()` but allows you to write more /// It is equivalent to `OpenOptions::new()`, but allows you to write more
/// readable code. Instead of `OpenOptions::new().read(true).open("foo.txt")` /// readable code. Instead of
/// you can write `File::options().read(true).open("foo.txt")`. This /// `OpenOptions::new().append(true).open("example.log")`,
/// you can write `File::options().append(true).open("example.log")`. This
/// also avoids the need to import `OpenOptions`. /// also avoids the need to import `OpenOptions`.
/// ///
/// See the [`OpenOptions::new`] function for more details. /// See the [`OpenOptions::new`] function for more details.
@ -369,7 +370,7 @@ impl File {
/// use std::fs::File; /// use std::fs::File;
/// ///
/// fn main() -> std::io::Result<()> { /// fn main() -> std::io::Result<()> {
/// let mut f = File::options().read(true).open("foo.txt")?; /// let mut f = File::options().append(true).open("example.log")?;
/// Ok(()) /// Ok(())
/// } /// }
/// ``` /// ```