summaryrefslogtreecommitdiffstats
path: root/man/man1/fzf.1
diff options
context:
space:
mode:
authorJunegunn Choi <junegunn.c@gmail.com>2024-04-27 18:36:37 +0900
committerGitHub <noreply@github.com>2024-04-27 18:36:37 +0900
commita4391aeedd4fec1865d2d646711f58d04058531b (patch)
tree73a6862010c323f380a3105f929b41a39c7a3753 /man/man1/fzf.1
parentb86a967ee217f4c820249701218a17eaad2737ae (diff)
Add --with-shell for shelling out with different command and flags (#3746)
Close #3732
Diffstat (limited to 'man/man1/fzf.1')
-rw-r--r--man/man1/fzf.114
1 files changed, 12 insertions, 2 deletions
diff --git a/man/man1/fzf.1 b/man/man1/fzf.1
index 458c6a5f..742fba5a 100644
--- a/man/man1/fzf.1
+++ b/man/man1/fzf.1
@@ -818,6 +818,16 @@ the finder only after the input stream is complete.
e.g. \fBfzf --multi | fzf --sync\fR
.RE
.TP
+.B "--with-shell=STR"
+Shell command and flags to start child processes with. On *nix Systems, the
+default value is \fB$SHELL -c\fR if \fB$SHELL\fR is set, otherwise \fBsh -c\fR.
+On Windows, the default value is \fBcmd /v:on/s/c\fR when \fB$SHELL\fR is not
+set.
+
+.RS
+e.g. \fBgem list | fzf --with-shell 'ruby -e' --preview 'pp Gem::Specification.find_by_name({1})'\fR
+.RE
+.TP
.B "--listen[=[ADDR:]PORT]" "--listen-unsafe[=[ADDR:]PORT]"
Start HTTP server and listen on the given address. It allows external processes
to send actions to perform via POST method.
@@ -932,6 +942,8 @@ you need to protect against DNS rebinding and privilege escalation attacks.
.br
.BR 2 " Error"
.br
+.BR 127 " Invalid shell command for \fBbecome\fR action"
+.br
.BR 130 " Interrupted with \fBCTRL-C\fR or \fBESC\fR"
.SH FIELD INDEX EXPRESSION
@@ -1441,8 +1453,6 @@ call.
\fBfzf --bind "enter:become(vim {})"\fR
-\fBbecome(...)\fR is not supported on Windows.
-
.SS RELOAD INPUT
\fBreload(...)\fR action is used to dynamically update the input list