From bfecd13e9b14a1ad5dac47e696fec61a8ca06aaf Mon Sep 17 00:00:00 2001 From: Robert Hensing Date: Wed, 14 May 2025 23:43:18 +0200 Subject: [PATCH] doc/rl-next; add pretty-json --- doc/manual/rl-next/pretty-json.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 doc/manual/rl-next/pretty-json.md diff --git a/doc/manual/rl-next/pretty-json.md b/doc/manual/rl-next/pretty-json.md new file mode 100644 index 000000000..3007ccfeb --- /dev/null +++ b/doc/manual/rl-next/pretty-json.md @@ -0,0 +1,10 @@ +--- +synopsis: "Prettified JSON output on the terminal" +issues: 12555 +prs: [12652] +--- + +Scripts are mostly unaffected because for those, stdout will be a file or a pipe, not a terminal, and for those, the old single-line behavior applies. + +`--json --pretty` can be passed to enable it even if the output is not a terminal. +If your script creates a pseudoterminal for Nix's stdout, you can pass `--no-pretty` to disable the new behavior.