From 6031a36208dd174f05f094898d8ad35e5366106f Mon Sep 17 00:00:00 2001 From: Ben Burdette Date: Wed, 25 May 2022 10:38:13 -0600 Subject: [PATCH] add --debugger to rl-next list --- doc/manual/src/release-notes/rl-next.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) 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 Change to another trace in the stack + :c Go until end of program, exception, or builtins.break(). + :s Go one step + ```