From aee3b8510b738cdf8f0fc494f687da86d0b3f8d9 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Thu, 20 Aug 2020 17:18:38 -0700 Subject: [PATCH] doc: simplify "make use of" to "use" PR-URL: https://github.com/nodejs/node/pull/34861 Reviewed-By: James M Snell Reviewed-By: Trivikram Kamat --- doc/api/addons.md | 4 ++-- doc/api/n-api.md | 10 +++++----- doc/api/tls.md | 2 +- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/api/addons.md b/doc/api/addons.md index e470ee40bc615f..bfe527cac992e9 100644 --- a/doc/api/addons.md +++ b/doc/api/addons.md @@ -421,7 +421,7 @@ and load it instead. ## Native abstractions for Node.js -Each of the examples illustrated in this document make direct use of the +Each of the examples illustrated in this document directly use the Node.js and V8 APIs for implementing addons. The V8 API can, and has, changed dramatically from one V8 release to the next (and one major Node.js release to the next). With each change, addons may need to be updated and recompiled in @@ -495,7 +495,7 @@ The functions available and how to use them are documented in ## Addon examples Following are some example addons intended to help developers get started. The -examples make use of the V8 APIs. Refer to the online [V8 reference][v8-docs] +examples use the V8 APIs. Refer to the online [V8 reference][v8-docs] for help with the various V8 calls, and V8's [Embedder's Guide][] for an explanation of several concepts used such as handles, scopes, function templates, etc. diff --git a/doc/api/n-api.md b/doc/api/n-api.md index 4419c82fbbb910..599b9bb887914e 100644 --- a/doc/api/n-api.md +++ b/doc/api/n-api.md @@ -111,7 +111,7 @@ versions: ``` Thus, for an addon to remain ABI-compatible across Node.js major versions, it -must make use exclusively of N-API by restricting itself to using +must use N-API exclusively by restricting itself to using ```c #include @@ -370,7 +370,7 @@ From the perspective of a native addon this means that the bindings it provides may be called multiple times, from multiple contexts, and even concurrently from multiple threads. -Native addons may need to allocate global state of which they make use during +Native addons may need to allocate global state which they use during their entire life cycle such that the state must be unique to each instance of the addon. @@ -5504,7 +5504,7 @@ return status of `napi_closing` in response to a call to should be the last API call made in conjunction with a given `napi_threadsafe_function`, because after the call completes, there is no guarantee that the `napi_threadsafe_function` is still allocated. For the same -reason, do not make use of a thread-safe function +reason, do not use a thread-safe function after receiving a return value of `napi_closing` in response to a call to `napi_call_threadsafe_function`. Data associated with the `napi_threadsafe_function` can be freed in its `napi_finalize` callback which @@ -5527,8 +5527,8 @@ reference count reaches zero. In particular, `napi_call_threadsafe_function()` will return `napi_closing`, thus informing the threads that it is no longer possible to make asynchronous calls to the thread-safe function. This can be used as a criterion for terminating the thread. **Upon receiving a return value -of `napi_closing` from `napi_call_threadsafe_function()` a thread must make no -further use of the thread-safe function because it is no longer guaranteed to +of `napi_closing` from `napi_call_threadsafe_function()` a thread must not use +the thread-safe function anymore because it is no longer guaranteed to be allocated.** ### Deciding whether to keep the process running diff --git a/doc/api/tls.md b/doc/api/tls.md index 58b0f77db59428..39638e658f6217 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -1718,7 +1718,7 @@ The `tls.createSecureContext()` method creates a `SecureContext` object. It is usable as an argument to several `tls` APIs, such as [`tls.createServer()`][] and [`server.addContext()`][], but has no public methods. -A key is *required* for ciphers that make use of certificates. Either `key` or +A key is *required* for ciphers that use certificates. Either `key` or `pfx` can be used to provide it. If the `ca` option is not given, then Node.js will default to using