From 0c00b203e61bffbadbc499cbf68af6f89a5a3e29 Mon Sep 17 00:00:00 2001 From: Junegunn Choi Date: Mon, 16 Jun 2025 00:39:11 +0900 Subject: Implement asynchronous transform actions (#4419) Close #4418 Example: fzf --bind 'focus:bg-transform-header(sleep 2; date; echo {})' --- man/man1/fzf.1 | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'man') 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 -- cgit v1.2.3