aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/rl-next/debugger-on-trace.md
diff options
context:
space:
mode:
authoreldritch horrors <pennae@lix.systems>2024-03-08 09:30:33 +0100
committereldritch horrors <pennae@lix.systems>2024-03-09 10:17:26 -0700
commitf2e11ddce1ef76d9f653e0c32659d46ff7d6cafa (patch)
treec766fd8bfdb45624aff3c9ee316d72e0fc076a9e /doc/manual/rl-next/debugger-on-trace.md
parent030c8aa833e019df6caa5c686dc989442c3d7638 (diff)
Merge pull request #9914 from 9999years/debugger-on-trace
Enter debugger on `builtins.trace` with an option (cherry picked from commit 774e7ca5847ebc392eac2a124a8f12b24da4f65a) Change-Id: If01e2110b3a128e639b05143227e365227d149f1
Diffstat (limited to 'doc/manual/rl-next/debugger-on-trace.md')
-rw-r--r--doc/manual/rl-next/debugger-on-trace.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/manual/rl-next/debugger-on-trace.md b/doc/manual/rl-next/debugger-on-trace.md
new file mode 100644
index 000000000..721928550
--- /dev/null
+++ b/doc/manual/rl-next/debugger-on-trace.md
@@ -0,0 +1,9 @@
+---
+synopsis: Enter the `--debugger` when `builtins.trace` is called if `debugger-on-trace` is set
+prs: 9914
+---
+
+If the `debugger-on-trace` option is set and `--debugger` is given,
+`builtins.trace` calls will behave similarly to `builtins.break` and will enter
+the debug REPL. This is useful for determining where warnings are being emitted
+from.