diff --git a/doc/api/fs.md b/doc/api/fs.md index fc27ea30d1f5f1..3bef99cafc0a15 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -184,7 +184,7 @@ changes: - v15.14.0 - v14.18.0 pr-url: https://github.com/nodejs/node/pull/37490 - description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`. + description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`. - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/31030 description: The `data` parameter won't coerce unsupported input to @@ -690,7 +690,7 @@ changes: - v15.14.0 - v14.18.0 pr-url: https://github.com/nodejs/node/pull/37490 - description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`. + description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`. - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/31030 description: The `data` parameter won't coerce unsupported input to @@ -1472,7 +1472,7 @@ The `atime` and `mtime` arguments follow these rules: * Values can be either numbers representing Unix epoch time, `Date`s, or a numeric string like `'123456789.0'`. -* If the value can not be converted to a number, or is `NaN`, `Infinity` or +* If the value can not be converted to a number, or is `NaN`, `Infinity`, or `-Infinity`, an `Error` will be thrown. ### `fsPromises.watch(filename[, options])` @@ -1536,7 +1536,7 @@ changes: - v15.14.0 - v14.18.0 pr-url: https://github.com/nodejs/node/pull/37490 - description: The `data` argument supports `AsyncIterable`, `Iterable` and `Stream`. + description: The `data` argument supports `AsyncIterable`, `Iterable`, and `Stream`. - version: - v15.2.0 - v14.17.0 @@ -1971,17 +1971,17 @@ specifies the permissions for others. For example, the octal value `0o765` means: -* The owner may read, write and execute the file. +* The owner may read, write, and execute the file. * The group may read and write the file. * Others may read and execute the file. When using raw numbers where file modes are expected, any value larger than `0o777` may result in platform-specific behaviors that are not supported to work -consistently. Therefore constants like `S_ISVTX`, `S_ISGID` or `S_ISUID` are not -exposed in `fs.constants`. +consistently. Therefore constants like `S_ISVTX`, `S_ISGID`, or `S_ISUID` are +not exposed in `fs.constants`. Caveats: on Windows only the write permission can be changed, and the -distinction among the permissions of group, owner or others is not +distinction among the permissions of group, owner, or others is not implemented. ### `fs.chown(path, uid, gid, callback)` @@ -2354,7 +2354,7 @@ By default, the stream will emit a `'close'` event after it has been destroyed. Set the `emitClose` option to `false` 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()` +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, overrides for at least one of `write` and `writev` are required. If no `fd` option is supplied, an override @@ -2759,7 +2759,7 @@ changes: it will emit a deprecation warning with id DEP0013. - version: v4.1.0 pr-url: https://github.com/nodejs/node/pull/2387 - description: Numeric strings, `NaN` and `Infinity` are now allowed + description: Numeric strings, `NaN`, and `Infinity` are now allowed time specifiers. --> @@ -3256,7 +3256,7 @@ changes: - v12.17.0 pr-url: https://github.com/nodejs/node/pull/31402 description: Options object can be passed in - to make Buffer, offset, length and position optional. + to make buffer, offset, length, and position optional. --> * `fd` {integer} @@ -3611,7 +3611,7 @@ changes: * `err` {Error} * `resolvedPath` {string|Buffer} -Asynchronously computes the canonical pathname by resolving `.`, `..` and +Asynchronously computes the canonical pathname by resolving `.`, `..`, and symbolic links. A canonical pathname is not necessarily unique. Hard links and bind mounts can @@ -4157,7 +4157,7 @@ changes: it will emit a deprecation warning with id DEP0013. - version: v4.1.0 pr-url: https://github.com/nodejs/node/pull/2387 - description: Numeric strings, `NaN` and `Infinity` are now allowed + description: Numeric strings, `NaN`, and `Infinity` are now allowed time specifiers. --> @@ -4173,7 +4173,7 @@ The `atime` and `mtime` arguments follow these rules: * Values can be either numbers representing Unix epoch time in seconds, `Date`s, or a numeric string like `'123456789.0'`. -* If the value can not be converted to a number, or is `NaN`, `Infinity` or +* If the value can not be converted to a number, or is `NaN`, `Infinity`, or `-Infinity`, an `Error` will be thrown. ### `fs.watch(filename[, options][, listener])` @@ -5069,7 +5069,7 @@ added: v0.4.2 changes: - version: v4.1.0 pr-url: https://github.com/nodejs/node/pull/2387 - description: Numeric strings, `NaN` and `Infinity` are now allowed + description: Numeric strings, `NaN`, and `Infinity` are now allowed time specifiers. --> @@ -5431,7 +5431,7 @@ changes: - v12.17.0 pr-url: https://github.com/nodejs/node/pull/32460 description: Options object can be passed in - to make offset, length and position optional. + to make offset, length, and position optional. --> * `fd` {integer} @@ -5736,7 +5736,7 @@ changes: protocol. - version: v4.1.0 pr-url: https://github.com/nodejs/node/pull/2387 - description: Numeric strings, `NaN` and `Infinity` are now allowed + description: Numeric strings, `NaN`, and `Infinity` are now allowed time specifiers. --> @@ -7010,7 +7010,7 @@ The following constants are meant for use with `fs.open()`. On Windows, only `O_APPEND`, `O_CREAT`, `O_EXCL`, `O_RDONLY`, `O_RDWR`, -`O_TRUNC`, `O_WRONLY` and `UV_FS_O_FILEMAP` are available. +`O_TRUNC`, `O_WRONLY`, and `UV_FS_O_FILEMAP` are available. ##### File type constants