From 469e0c7befe9875c4c61e738a278f1fb6e98ccd2 Mon Sep 17 00:00:00 2001
From: foxxyz <foxxyz@gmail.com>
Date: Sat, 26 Jun 2021 16:03:02 -0700
Subject: [PATCH 1/3] doc: replace outdated `util.promisify` timer examples
 with references

---
 doc/api/timers.md | 44 ++++++++++----------------------------------
 1 file changed, 10 insertions(+), 34 deletions(-)

diff --git a/doc/api/timers.md b/doc/api/timers.md
index 89f9ad312e33c4..15abbba16c2f9b 100644
--- a/doc/api/timers.md
+++ b/doc/api/timers.md
@@ -170,25 +170,7 @@ next event loop iteration.
 If `callback` is not a function, a [`TypeError`][] will be thrown.
 
 This method has a custom variant for promises that is available using
-[`util.promisify()`][]:
-
-```js
-const util = require('util');
-const setImmediatePromise = util.promisify(setImmediate);
-
-setImmediatePromise('foobar').then((value) => {
-  // value === 'foobar' (passing values is optional)
-  // This is executed after all I/O callbacks.
-});
-
-// Or with async function
-async function timerExample() {
-  console.log('Before I/O callbacks');
-  await setImmediatePromise();
-  console.log('After I/O callbacks');
-}
-timerExample();
-```
+[`timersPromises.setImmediate()`][].
 
 ### `setInterval(callback[, delay[, ...args]])`
 <!-- YAML
@@ -208,6 +190,9 @@ set to `1`. Non-integer delays are truncated to an integer.
 
 If `callback` is not a function, a [`TypeError`][] will be thrown.
 
+This method has an async iterator variant that is available using
+[`timersPromises.setInterval()`][].
+
 ### `setTimeout(callback[, delay[, ...args]])`
 <!-- YAML
 added: v0.0.1
@@ -232,17 +217,7 @@ will be set to `1`. Non-integer delays are truncated to an integer.
 If `callback` is not a function, a [`TypeError`][] will be thrown.
 
 This method has a custom variant for promises that is available using
-[`util.promisify()`][]:
-
-```js
-const util = require('util');
-const setTimeoutPromise = util.promisify(setTimeout);
-
-setTimeoutPromise(40, 'foobar').then((value) => {
-  // value === 'foobar' (passing values is optional)
-  // This is executed after about 40 milliseconds.
-});
-```
+[`timersPromises.setTimeout()`][].
 
 ## Cancelling timers
 
@@ -257,8 +232,7 @@ returned Promises will be rejected with an `'AbortError'`.
 For `setImmediate()`:
 
 ```js
-const util = require('util');
-const setImmediatePromise = util.promisify(setImmediate);
+const { setImmediate: setImmediatePromise } = require('timers/promises');
 
 const ac = new AbortController();
 const signal = ac.signal;
@@ -276,8 +250,7 @@ ac.abort();
 For `setTimeout()`:
 
 ```js
-const util = require('util');
-const setTimeoutPromise = util.promisify(setTimeout);
+const { setTimeout: setTimeoutPromise } = require('timers/promises');
 
 const ac = new AbortController();
 const signal = ac.signal;
@@ -478,6 +451,9 @@ const interval = 100;
 [`setImmediate()`]: #timers_setimmediate_callback_args
 [`setInterval()`]: #timers_setinterval_callback_delay_args
 [`setTimeout()`]: #timers_settimeout_callback_delay_args
+[`timersPromises.setImmediate()`]: timers.md#timerspromisessetimmediatevalue-options
+[`timersPromises.setInterval()`]: timers.md#timerspromisessetintervaldelay-value-options
+[`timersPromises.setTimeout()`]: timers.md#timerspromisessettimeoutdelay-value-options
 [`util.promisify()`]: util.md#util_util_promisify_original
 [`worker_threads`]: worker_threads.md
 [primitive]: #timers_timeout_symbol_toprimitive

From 2cbdc726d81db91384434c9d6db48960e8303601 Mon Sep 17 00:00:00 2001
From: foxxyz <foxxyz@gmail.com>
Date: Sat, 26 Jun 2021 17:05:59 -0700
Subject: [PATCH 2/3] doc: consistent verbiage for references to
 timers/promises

---
 doc/api/timers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/timers.md b/doc/api/timers.md
index 15abbba16c2f9b..9d0532ebf701f2 100644
--- a/doc/api/timers.md
+++ b/doc/api/timers.md
@@ -190,7 +190,7 @@ set to `1`. Non-integer delays are truncated to an integer.
 
 If `callback` is not a function, a [`TypeError`][] will be thrown.
 
-This method has an async iterator variant that is available using
+This method has a custom variant for promises that is available using
 [`timersPromises.setInterval()`][].
 
 ### `setTimeout(callback[, delay[, ...args]])`

From 49ba88290f220092a3a7604b56aaf9ae3f76b6c9 Mon Sep 17 00:00:00 2001
From: foxxyz <foxxyz@gmail.com>
Date: Sun, 27 Jun 2021 00:56:59 -0700
Subject: [PATCH 3/3] doc: fix anchor link prefixes, truncate redundant link
 targets

---
 doc/api/timers.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/doc/api/timers.md b/doc/api/timers.md
index 9d0532ebf701f2..cfbc8f1ead4b71 100644
--- a/doc/api/timers.md
+++ b/doc/api/timers.md
@@ -451,9 +451,8 @@ const interval = 100;
 [`setImmediate()`]: #timers_setimmediate_callback_args
 [`setInterval()`]: #timers_setinterval_callback_delay_args
 [`setTimeout()`]: #timers_settimeout_callback_delay_args
-[`timersPromises.setImmediate()`]: timers.md#timerspromisessetimmediatevalue-options
-[`timersPromises.setInterval()`]: timers.md#timerspromisessetintervaldelay-value-options
-[`timersPromises.setTimeout()`]: timers.md#timerspromisessettimeoutdelay-value-options
-[`util.promisify()`]: util.md#util_util_promisify_original
+[`timersPromises.setImmediate()`]: #timers_timerspromises_setimmediate_value_options
+[`timersPromises.setInterval()`]: #timers_timerspromises_setinterval_delay_value_options
+[`timersPromises.setTimeout()`]: #timers_timerspromises_settimeout_delay_value_options
 [`worker_threads`]: worker_threads.md
 [primitive]: #timers_timeout_symbol_toprimitive