summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorJunegunn Choi <junegunn.c@gmail.com>2025-06-16 00:39:11 +0900
committerGitHub <noreply@github.com>2025-06-16 00:39:11 +0900
commit0c00b203e61bffbadbc499cbf68af6f89a5a3e29 (patch)
treeeffd2636b35640cede4f2e8e362f18ee91836a5b /man
parent3b68dcdd81394f1ac9f743e1f74ff754f95eef9e (diff)
downloadfzf-0c00b203e61bffbadbc499cbf68af6f89a5a3e29.tar.gz
Implement asynchronous transform actions (#4419)
Close #4418 Example: fzf --bind 'focus:bg-transform-header(sleep 2; date; echo {})'
Diffstat (limited to 'man')
-rw-r--r--man/man1/fzf.111
1 files changed, 11 insertions, 0 deletions
diff --git a/man/man1/fzf.1 b/man/man1/fzf.1
index 834df205..a64b5e0d 100644
--- a/man/man1/fzf.1
+++ b/man/man1/fzf.1
@@ -1805,6 +1805,9 @@ A key or an event can be bound to one or more of the following actions.
\fBup\fR \fIctrl\-k ctrl\-p up\fR
\fByank\fR \fIctrl\-y\fR
+Each \fBtransform*\fR action has a corresponding \fBbg\-transform*\fR
+variant that runs the command in the background.
+
.SS ACTION COMPOSITION
Multiple actions can be chained using \fB+\fR separator.
@@ -1929,6 +1932,14 @@ e.g.
echo "change\-header:Invalid selection"'
\fR
+.SS TRANSFORM IN THE BACKGROUND
+
+Transform actions are synchronous, meaning fzf becomes unresponsive while the
+command runs. To avoid this, each \fBtransform*\fR action has a corresponding
+\fBbg\-transform*\fR variant that runs in the background. Unless you need to
+chain multiple transform actions where later ones depend on earlier results,
+prefer using the \fBbg\fR variant.
+
.SS PREVIEW BINDING
With \fBpreview(...)\fR action, you can specify multiple different preview