aboutsummaryrefslogtreecommitdiff
path: root/doc/foot.1.scd
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2024-02-06 11:13:27 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-02-06 11:13:27 +0000
commit0a302265ec36b1cbdeb752ed9a87cb19b188017c (patch)
treecbe215dad8862bd348c4233dd6469ac6732561f4 /doc/foot.1.scd
parentMerge branch 'modifiers' (diff)
parentgrid: resize with reflow: reflow FTCS_COMMAND_{EXECUTED,FINISHED} (diff)
Merge branch 'pipe-command-output'
Diffstat (limited to 'doc/foot.1.scd')
-rw-r--r--doc/foot.1.scd32
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/foot.1.scd b/doc/foot.1.scd
index 385f9721..8e2fb313 100644
--- a/doc/foot.1.scd
+++ b/doc/foot.1.scd
@@ -424,6 +424,38 @@ See the wiki
(https://codeberg.org/dnkl/foot/wiki#user-content-jumping-between-prompts)
for details, and examples for other shells.
+## Piping last command’s output
+
+The key binding *pipe-command-output* can pipe the last command’s
+output to an application of your choice (similar to the other
+*pipe-\** key bindings):
+
+ *\[key-bindings\]++
+pipe-command-output=[sh -c "f=$(mktemp); cat - > $f; footclient emacsclient -nw $f; rm $f"] Control+Shift+g*
+
+When pressing *ctrl*+*shift*+*g*, the last command’s output is written
+to a temporary file, then an emacsclient is started in a new
+footclient instance. The temporary file is removed after the
+footclient instance has closed.
+
+For this to work, the shell must emit an OSC-133;C (*\\E]133;C\\E\\\\*)
+sequence before command output starts, and an OSC-133;D
+(*\\E]133;D\\E\\\\*) when the command output ends.
+
+In fish, one way to do this is to add _preexec_ and _postexec_ hooks:
+
+ *function foot_cmd_start --on-event fish_preexec
+ echo -en "\\e]133;C\\e\\\\"
+ end*
+
+ *function foot_cmd_end --on-event fish_postexec
+ echo -en "\\e]133;D\\e\\\\"
+ end*
+
+See the wiki
+(https://codeberg.org/dnkl/foot/wiki#user-content-piping-last-commands-output)
+for details, and examples for other shells
+
# TERMINFO
Client applications use the terminfo identifier specified by the