summaryrefslogtreecommitdiff
path: root/doc/api/deprecations.md
diff options
context:
space:
mode:
authorRich Trott <rtrott@gmail.com>2020-08-20 17:11:53 -0700
committerBeth Griggs <Bethany.Griggs@uk.ibm.com>2020-08-24 12:19:59 +0100
commitf2c2f421957f43cbfc249a7598cbe0ef0b4037f0 (patch)
tree06d832ebf304fa12983440fedf0795b2d8dbcc1f /doc/api/deprecations.md
parente90cb49390df90a1370ce4c5fbdd31712860dce8 (diff)
downloadnode-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.md16
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