From c4df0dd06e69c9fad90e88ae7f6fbb5d8426077e Mon Sep 17 00:00:00 2001
From: Junegunn Choi <junegunn.c@gmail.com>
Date: Tue, 26 Dec 2023 12:20:27 +0900
Subject: [PATCH] Add TRANSFORM ACTIONS section to man page

---
 CHANGELOG.md   |  4 ++--
 man/man1/fzf.1 | 23 +++++++++++++++++++++++
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bb986de..f46d0f0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,12 +7,12 @@ CHANGELOG
   ```sh
   # Disallow selecting an empty line
   echo -e "1. Hello\n2. Goodbye\n\n3. Exit" |
-    fzf --reverse --header 'Select one' \
+    fzf --height '~100%' --reverse --header 'Select one' \
         --bind 'enter:transform:[[ -n {} ]] && echo accept || echo "change-header:Invalid selection"'
 
   # Move cursor past the empty line
   echo -e "1. Hello\n2. Goodbye\n\n3. Exit" |
-    fzf --reverse --header 'Select one' \
+    fzf --height '~100%' --reverse --header 'Select one' \
         --bind 'enter:transform:[[ -n {} ]] && echo accept || echo "change-header:Invalid selection"' \
         --bind 'focus:transform:[[ -n {} ]] && exit; [[ {fzf:action} =~ up$ ]] && echo up || echo down'
   ```
diff --git a/man/man1/fzf.1 b/man/man1/fzf.1
index 20e7e17..fd68a87 100644
--- a/man/man1/fzf.1
+++ b/man/man1/fzf.1
@@ -1221,6 +1221,7 @@ A key or an event can be bound to one or more of the following actions.
     \fBtoggle-track\fR
     \fBtoggle+up\fR                    \fIbtab    (shift-tab)\fR
     \fBtrack\fR                        (track the current item; automatically disabled if focus changes)
+    \fBtransform(...)\fR               (transform states using the output of an external command)
     \fBtransform-border-label(...)\fR  (transform border label using an external command)
     \fBtransform-header(...)\fR        (transform header using an external command)
     \fBtransform-preview-label(...)\fR (transform preview label using an external command)
@@ -1333,6 +1334,28 @@ e.g.
      \fB# You can still filter and select entries from the initial list for 3 seconds
      seq 100 | fzf --bind 'load:reload-sync(sleep 3; seq 1000)+unbind(load)'\fR
 
+.SS TRANSFORM ACTIONS
+
+Actions with \fBtransform-\fR prefix are used to transform the states of fzf
+using the output of an external command. The output of these commands are
+expected to be a single line of text.
+
+e.g.
+    \fBfzf --bind 'focus:transform-header:file --brief {}'\fR
+
+\fBtransform(...)\fR action runs an external command that should print a series
+of actions to be performed. The output should be in the same format as the
+payload of HTTP POST request to the \fB--listen\fR server.
+
+e.g.
+    \fB# Disallow selecting an empty line
+    echo -e "1. Hello\\n2. Goodbye\\n\\n3. Exit" |
+      fzf --height '~100%' --reverse --header 'Select one' \\
+          --bind 'enter:transform:[[ -n {} ]] &&
+                    echo accept ||
+                    echo "change-header:Invalid selection"'
+    \fR
+
 .SS PREVIEW BINDING
 
 With \fBpreview(...)\fR action, you can specify multiple different preview