diff options
author | Rich Trott <rtrott@gmail.com> | 2020-08-20 17:11:53 -0700 |
---|---|---|
committer | Beth Griggs <Bethany.Griggs@uk.ibm.com> | 2020-08-24 12:19:59 +0100 |
commit | f2c2f421957f43cbfc249a7598cbe0ef0b4037f0 (patch) | |
tree | 06d832ebf304fa12983440fedf0795b2d8dbcc1f /doc/api/deprecations.md | |
parent | e90cb49390df90a1370ce4c5fbdd31712860dce8 (diff) | |
download | node-new-f2c2f421957f43cbfc249a7598cbe0ef0b4037f0.tar.gz |
doc: improve wording in deprecations.md
* utilize -> use
* may -> can/might as appropriate
PR-URL: https://github.com/nodejs/node/pull/34860
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Michaƫl Zasso <targos@protonmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Diffstat (limited to 'doc/api/deprecations.md')
-rw-r--r-- | doc/api/deprecations.md | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 687fa4b848..24632e364c 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -3,13 +3,13 @@ <!--introduced_in=v7.7.0--> <!-- type=misc --> -Node.js may deprecate APIs for any of the following reasons: +Node.js APIs might be deprecated for any of the following reasons: * Use of the API is unsafe. * An improved alternative API is available. * Breaking changes to the API are expected in a future major release. -Node.js utilizes three kinds of Deprecations: +Node.js uses three kinds of Deprecations: * Documentation-only * Runtime @@ -34,7 +34,7 @@ from Node.js. ## Revoking deprecations -Occasionally, the deprecation of an API may be reversed. In such situations, +Occasionally, the deprecation of an API might be reversed. In such situations, this document will be updated with information relevant to the decision. However, the deprecation identifier will not be modified. @@ -1651,7 +1651,7 @@ Type: End-of-Life Using a property named `inspect` on an object to specify a custom inspection function for [`util.inspect()`][] is deprecated. Use [`util.inspect.custom`][] instead. For backward compatibility with Node.js prior to version 6.4.0, both -may be specified. +can be specified. <a id="DEP0080"></a> ### DEP0080: `path._makeLong()` @@ -1752,7 +1752,7 @@ The `v8/*` modules do not have any exports, and if not imported in a specific order would in fact throw errors. As such there are virtually no legitimate use cases for importing them through `require()`. -On the other hand, `node-inspect` may be installed locally through a package +On the other hand, `node-inspect` can be installed locally through a package manager, as it is published on the npm registry under the same name. No source code modification is necessary if that is done. @@ -2053,7 +2053,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][]) When assigning a non-string property to [`process.env`][], the assigned value is implicitly converted to a string. This behavior is deprecated if the assigned -value is not a string, boolean, or number. In the future, such assignment may +value is not a string, boolean, or number. In the future, such assignment might result in a thrown error. Please convert the property to a string before assigning it to `process.env`. @@ -2249,7 +2249,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][]) In recent versions of Node.js, there is no difference between [`crypto.randomBytes()`][] and `crypto.pseudoRandomBytes()`. The latter is deprecated along with the undocumented aliases `crypto.prng()` and -`crypto.rng()` in favor of [`crypto.randomBytes()`][] and may be removed in a +`crypto.rng()` in favor of [`crypto.randomBytes()`][] and might be removed in a future release. <a id="DEP0116"></a> @@ -2600,7 +2600,7 @@ changes: Type: Runtime Allowing a [`fs.FileHandle`][] object to be closed on garbage collection is -deprecated. In the future, doing so may result in a thrown error that will +deprecated. In the future, doing so might result in a thrown error that will terminate the process. Please ensure that all `fs.FileHandle` objects are explicitly closed using |