summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/tofi.1.md6
-rw-r--r--doc/tofi.1.scd6
-rw-r--r--doc/tofi.5.md11
-rw-r--r--doc/tofi.5.scd9
4 files changed, 32 insertions, 0 deletions
diff --git a/doc/tofi.1.md b/doc/tofi.1.md
index 6de0027..4529dda 100644
--- a/doc/tofi.1.md
+++ b/doc/tofi.1.md
@@ -27,6 +27,12 @@ When invoked via the name **tofi-drun**, **tofi** will not accept items
on stdin, and will generate a list of applications from desktop files as
described in the Desktop Entry Specification.
+**WARNING**: Currently, when a selection is made in drun mode, the
+filename of the selected desktop file is printed to stdout. In the next
+version of tofi, this will change to an executable command line, to be
+passed to swaymsg exec or similar. The new behaviour can be enabled now
+by passing --drun-print-exec=true to tofi-drun.
+
**tofi-compgen** just prints the list of executables used by
**tofi-run**.
diff --git a/doc/tofi.1.scd b/doc/tofi.1.scd
index d15d394..38ed290 100644
--- a/doc/tofi.1.scd
+++ b/doc/tofi.1.scd
@@ -27,6 +27,12 @@ When invoked via the name *tofi-drun*, *tofi* will not accept items on stdin,
and will generate a list of applications from desktop files as described in the
Desktop Entry Specification.
+*WARNING*: Currently, when a selection is made in drun mode, the filename of
+the selected desktop file is printed to stdout. In the next version of tofi,
+this will change to an executable command line, to be passed to swaymsg exec or
+similar. The new behaviour can be enabled now by passing --drun-print-exec=true
+to tofi-drun.
+
*tofi-compgen* just prints the list of executables used by *tofi-run*.
# OPTIONS
diff --git a/doc/tofi.5.md b/doc/tofi.5.md
index 916fc22..9a76a5d 100644
--- a/doc/tofi.5.md
+++ b/doc/tofi.5.md
@@ -224,6 +224,17 @@ options.
>
> Default: false
+**drun-print-exec**=*true\|false*
+
+> If true, print an executable command line for the selected application
+> when in drun mode. Otherwise, just print the path of the .desktop
+> file.
+>
+> **WARNING**: In the next version of tofi, this will change to always
+> be true, as it should have been from the start.
+>
+> Default: false
+
**hint-font**=*true\|false*
> Perform font hinting. Only applies when a path to a font has been
diff --git a/doc/tofi.5.scd b/doc/tofi.5.scd
index 3ad7015..5a977d3 100644
--- a/doc/tofi.5.scd
+++ b/doc/tofi.5.scd
@@ -194,6 +194,15 @@ options.
Default: false
+*drun-print-exec*=_true|false_
+ If true, print an executable command line for the selected application
+ when in drun mode. Otherwise, just print the path of the .desktop file.
+
+ *WARNING*: In the next version of tofi, this will change to always be
+ true, as it should have been from the start.
+
+ Default: false
+
*hint-font*=_true|false_
Perform font hinting. Only applies when a path to a font has been
specified via *font-name*. Disabling font hinting speeds up text