Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit f2c2f42

Browse filesBrowse files
TrottBethGriggs
authored andcommitted
doc: improve wording in deprecations.md
* utilize -> use * may -> can/might as appropriate PR-URL: #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>
1 parent e90cb49 commit f2c2f42
Copy full SHA for f2c2f42

File tree

Expand file treeCollapse file tree

1 file changed

+8
-8
lines changed
Open diff view settings
Filter options
Expand file treeCollapse file tree

1 file changed

+8
-8
lines changed
Open diff view settings
Collapse file

‎doc/api/deprecations.md‎

Copy file name to clipboardExpand all lines: doc/api/deprecations.md
+8-8Lines changed: 8 additions & 8 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@
33
<!--introduced_in=v7.7.0-->
44
<!-- type=misc -->
55

6-
Node.js may deprecate APIs for any of the following reasons:
6+
Node.js APIs might be deprecated for any of the following reasons:
77

88
* Use of the API is unsafe.
99
* An improved alternative API is available.
1010
* Breaking changes to the API are expected in a future major release.
1111

12-
Node.js utilizes three kinds of Deprecations:
12+
Node.js uses three kinds of Deprecations:
1313

1414
* Documentation-only
1515
* Runtime
@@ -34,7 +34,7 @@ from Node.js.
3434

3535
## Revoking deprecations
3636

37-
Occasionally, the deprecation of an API may be reversed. In such situations,
37+
Occasionally, the deprecation of an API might be reversed. In such situations,
3838
this document will be updated with information relevant to the decision.
3939
However, the deprecation identifier will not be modified.
4040

@@ -1651,7 +1651,7 @@ Type: End-of-Life
16511651
Using a property named `inspect` on an object to specify a custom inspection
16521652
function for [`util.inspect()`][] is deprecated. Use [`util.inspect.custom`][]
16531653
instead. For backward compatibility with Node.js prior to version 6.4.0, both
1654-
may be specified.
1654+
can be specified.
16551655

16561656
<a id="DEP0080"></a>
16571657
### DEP0080: `path._makeLong()`
@@ -1752,7 +1752,7 @@ The `v8/*` modules do not have any exports, and if not imported in a specific
17521752
order would in fact throw errors. As such there are virtually no legitimate use
17531753
cases for importing them through `require()`.
17541754

1755-
On the other hand, `node-inspect` may be installed locally through a package
1755+
On the other hand, `node-inspect` can be installed locally through a package
17561756
manager, as it is published on the npm registry under the same name. No source
17571757
code modification is necessary if that is done.
17581758

@@ -2053,7 +2053,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
20532053

20542054
When assigning a non-string property to [`process.env`][], the assigned value is
20552055
implicitly converted to a string. This behavior is deprecated if the assigned
2056-
value is not a string, boolean, or number. In the future, such assignment may
2056+
value is not a string, boolean, or number. In the future, such assignment might
20572057
result in a thrown error. Please convert the property to a string before
20582058
assigning it to `process.env`.
20592059

@@ -2249,7 +2249,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
22492249
In recent versions of Node.js, there is no difference between
22502250
[`crypto.randomBytes()`][] and `crypto.pseudoRandomBytes()`. The latter is
22512251
deprecated along with the undocumented aliases `crypto.prng()` and
2252-
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and may be removed in a
2252+
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and might be removed in a
22532253
future release.
22542254

22552255
<a id="DEP0116"></a>
@@ -2600,7 +2600,7 @@ changes:
26002600
Type: Runtime
26012601

26022602
Allowing a [`fs.FileHandle`][] object to be closed on garbage collection is
2603-
deprecated. In the future, doing so may result in a thrown error that will
2603+
deprecated. In the future, doing so might result in a thrown error that will
26042604
terminate the process.
26052605

26062606
Please ensure that all `fs.FileHandle` objects are explicitly closed using

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.