aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBen Burdette <bburdette@protonmail.com>2022-05-25 10:38:13 -0600
committerBen Burdette <bburdette@protonmail.com>2022-05-25 10:38:13 -0600
commit6031a36208dd174f05f094898d8ad35e5366106f (patch)
tree166713d946940156122494f05af91db2f162fff1 /doc
parentb4c24a29c62259a068c8270be62cf5a412e1e35c (diff)
add --debugger to rl-next list
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/src/release-notes/rl-next.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/manual/src/release-notes/rl-next.md b/doc/manual/src/release-notes/rl-next.md
index efd893662..a808e145a 100644
--- a/doc/manual/src/release-notes/rl-next.md
+++ b/doc/manual/src/release-notes/rl-next.md
@@ -24,3 +24,16 @@
Selecting derivation outputs using the attribute selection syntax
(e.g. `nixpkgs#glibc.dev`) no longer works.
+
+* Running nix with the new `--debugger` flag will cause it to start a repl session if
+ there is an exception thrown during eval, or if `builtins.break` is called. From
+ there one can inspect symbol values and evaluate nix expressions. In debug mode
+ the following new repl commands are available:
+ ```
+ :env Show env stack
+ :bt Show trace stack
+ :st Show current trace
+ :st <idx> Change to another trace in the stack
+ :c Go until end of program, exception, or builtins.break().
+ :s Go one step
+ ```