aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLunaphied <lunaphied@lunaphied.me>2024-03-21 21:48:34 -0600
committerLunaphied <lunaphied@lunaphied.me>2024-03-24 21:17:51 -0600
commit185ecf1f45e6bf2198fe9ca3bb7ad175f412a014 (patch)
treebdbd1ebea92d41a106cd8bafd3d6f82005e6c0a7 /doc
parenta7161b6c0f6f9640acc065f0bd18579babacb0cf (diff)
Improve new CLI UX by supporting short `-E` flag for `--expr`
Change-Id: I55881c846da8416a92a14deedfa5bbbf09a122fb
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/rl-next/short-expr-flag.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/manual/rl-next/short-expr-flag.md b/doc/manual/rl-next/short-expr-flag.md
new file mode 100644
index 000000000..a02c944bd
--- /dev/null
+++ b/doc/manual/rl-next/short-expr-flag.md
@@ -0,0 +1,14 @@
+---
+synopsis: reintroduce shortened `-E` form for `--expr` to new CLI
+# prs: cl 605
+---
+
+In the past, it was possible to supply a shorter `-E` flag instead of fully
+specifying `--expr` every time you wished to provide an expression that would
+be evaluated to produce the given command's input. This was retained for the
+`--file` flag when the new CLI utilities were written with `-f`, but `-E` was
+dropped.
+
+We now restore the `-E` short form for better UX. This is most useful for
+`nix eval` but most any command that takes an Installable argument should benefit
+from it as well.