Skip to content

Commit 605c137

Browse files
authored
test: add tests to ensure that node.1 is kept in sync with cli.md
nodejs/node#58878
1 parent 4d8ef44 commit 605c137

1 file changed

Lines changed: 42 additions & 2 deletions

File tree

patches/node/cli_move_--trace-atomics-wait_to_eol.patch

Lines changed: 42 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,50 @@ Reviewed-By: Benjamin Gruenbaum <[email protected]>
1515
Reviewed-By: Yagiz Nizipli <[email protected]>
1616

1717
diff --git a/doc/api/cli.md b/doc/api/cli.md
18-
index 404e87e6d1237b5ee79cafd8a959c1b6d9d23fe5..7116c543f2f505cf8fc3053ffbc68affa91f6f49 100644
18+
index 404e87e6d1237b5ee79cafd8a959c1b6d9d23fe5..7deda572c940f7b2e8c6813f1826796a13e4db38 100644
1919
--- a/doc/api/cli.md
2020
+++ b/doc/api/cli.md
21-
@@ -3423,7 +3423,6 @@ one is included in the list below.
21+
@@ -2709,39 +2709,6 @@ added: v12.0.0
22+
Set default [`tls.DEFAULT_MIN_VERSION`][] to 'TLSv1.3'. Use to disable support
23+
for TLSv1.2, which is not as secure as TLSv1.3.
24+
25+
-### `--trace-atomics-wait`
26+
-
27+
-<!-- YAML
28+
-added: v14.3.0
29+
-deprecated:
30+
- - v18.8.0
31+
- - v16.18.0
32+
--->
33+
-
34+
-> Stability: 0 - Deprecated
35+
-
36+
-Print short summaries of calls to [`Atomics.wait()`][] to stderr.
37+
-The output could look like this:
38+
-
39+
-```text
40+
-(node:15701) [Thread 0] Atomics.wait(&lt;address> + 0, 1, inf) started
41+
-(node:15701) [Thread 0] Atomics.wait(&lt;address> + 0, 1, inf) did not wait because the values mismatched
42+
-(node:15701) [Thread 0] Atomics.wait(&lt;address> + 0, 0, 10) started
43+
-(node:15701) [Thread 0] Atomics.wait(&lt;address> + 0, 0, 10) timed out
44+
-(node:15701) [Thread 0] Atomics.wait(&lt;address> + 4, 0, inf) started
45+
-(node:15701) [Thread 1] Atomics.wait(&lt;address> + 4, -1, inf) started
46+
-(node:15701) [Thread 0] Atomics.wait(&lt;address> + 4, 0, inf) was woken up by another thread
47+
-(node:15701) [Thread 1] Atomics.wait(&lt;address> + 4, -1, inf) was woken up by another thread
48+
-```
49+
-
50+
-The fields here correspond to:
51+
-
52+
-* The thread id as given by [`worker_threads.threadId`][]
53+
-* The base address of the `SharedArrayBuffer` in question, as well as the
54+
- byte offset corresponding to the index passed to `Atomics.wait()`
55+
-* The expected value that was passed to `Atomics.wait()`
56+
-* The timeout passed to `Atomics.wait`
57+
-
58+
### `--trace-deprecation`
59+
60+
<!-- YAML
61+
@@ -3423,7 +3390,6 @@ one is included in the list below.
2262
* `--tls-min-v1.1`
2363
* `--tls-min-v1.2`
2464
* `--tls-min-v1.3`

0 commit comments

Comments
 (0)