diff --git a/doc/api/fs.md b/doc/api/fs.md index 5070d99611889e..03bb798e016672 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -1720,9 +1720,9 @@ By default, the stream will not emit a `'close'` event after it has been destroyed. This is the opposite of the default for other `Readable` streams. Set the `emitClose` option to `true` to change this behavior. -By providing the `fs` option it is possible to override the corresponding `fs` -implementations for `open`, `read` and `close`. When providing the `fs` option, -you must override `open`, `close` and `read`. +By providing the `fs` option, it is possible to override the corresponding `fs` +implementations for `open`, `read`, and `close`. When providing the `fs` option, +overrides for `open`, `read`, and `close` are required. ```js const fs = require('fs'); @@ -1816,8 +1816,8 @@ Set the `emitClose` option to `true` to change this behavior. By providing the `fs` option it is possible to override the corresponding `fs` implementations for `open`, `write`, `writev` and `close`. Overriding `write()` without `writev()` can reduce performance as some optimizations (`_writev()`) -will be disabled. When providing the `fs` option, you must override `open`, -`close` and at least one of `write` and `writev`. +will be disabled. When providing the `fs` option, overrides for `open`, +`close`, and at least one of `write` and `writev` are required. Like [`ReadStream`][], if `fd` is specified, [`WriteStream`][] will ignore the `path` argument and will use the specified file descriptor. This means that no @@ -4244,8 +4244,8 @@ in that they provide an object oriented API for working with files. If a `FileHandle` is not closed using the `filehandle.close()` method, it might automatically close the file descriptor and will emit a process warning, thereby helping to prevent memory leaks. -Please do not rely on this behavior in your code because it is unreliable and -your file may not be closed. Instead, always explicitly close `FileHandle`s. +Please do not rely on this behavior because it is unreliable and +the file may not be closed. Instead, always explicitly close `FileHandle`s. Node.js may change this behavior in the future. Instances of the `FileHandle` object are created internally by the