summaryrefslogtreecommitdiffstats
path: root/doc/rofi-script.5
diff options
context:
space:
mode:
authorDave Davenport <qball@gmpclient.org>2021-03-10 20:45:53 +0100
committerDave Davenport <qball@gmpclient.org>2021-03-10 20:45:53 +0100
commit53533acb77e75076530c699c94afd368e24a924d (patch)
tree8d37169b1615f4ba8421d22f6808593fd2b84db5 /doc/rofi-script.5
parent347bc9517c98c3b31f8ae967b5e467ce2492af2f (diff)
[Doc] update rofi-script to hint about coproc.
Thx to jose1711
Diffstat (limited to 'doc/rofi-script.5')
-rw-r--r--doc/rofi-script.517
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/rofi-script.5 b/doc/rofi-script.5
index 5c83915d..ff06dcb3 100644
--- a/doc/rofi-script.5
+++ b/doc/rofi-script.5
@@ -163,6 +163,23 @@ multiple entries can be passed using the \fB\fC\\x1f\fR separator.
.fi
.RE
+.SH Executing external program
+.PP
+If you want to launch an external program from the script, you need to make sure it is launched in the background.
+If not rofi will wait for its output (to display).
+
+.PP
+In bash the best way to do this is using \fB\fCcoproc\fR\&.
+
+.PP
+.RS
+
+.nf
+ coproc ( myApp > /dev/null 2>\&1 )
+
+.fi
+.RE
+
.SH DASH shell
.PP
If you use the \fB\fCdash\fR shell for your script, take special care with how dash handles escaped values for the separators.