summaryrefslogtreecommitdiffhomepage
path: root/readme.md
diff options
context:
space:
mode:
authorjao <jao@gnu.org>2018-07-19 22:11:14 +0100
committerjao <jao@gnu.org>2018-07-19 22:11:14 +0100
commitcbde794c899d04524a486d5d0f82b8e2d889cdb8 (patch)
treefadf5babc1b9ffffec1fc3f060c332366e505fb1 /readme.md
parent82e186a112ac0d76a139ed572fb24b45a6b83967 (diff)
downloadxmobar-cbde794c899d04524a486d5d0f82b8e2d889cdb8.tar.gz
xmobar-cbde794c899d04524a486d5d0f82b8e2d889cdb8.tar.bz2
New ComX specifying error output string (closes #342)
Diffstat (limited to 'readme.md')
-rw-r--r--readme.md15
1 files changed, 14 insertions, 1 deletions
diff --git a/readme.md b/readme.md
index 92727bb..2022adf 100644
--- a/readme.md
+++ b/readme.md
@@ -1284,7 +1284,20 @@ _uname_ only once), while
Run Com "date" ["+\"%a %b %_d %H:%M\""] "mydate" 600
-can be used in the output template as `%mydate%`
+can be used in the output template as `%mydate%`.
+
+Sometimes, you don't mind if the command executed exits with an error,
+or you might want to display a custom message in that case. To that
+end, you can use the `ComX` variant:
+
+`ComX ProgramName Args ExitMessage Alias RefreshRate`
+
+Works like `Com`, but displaying `ExitMessage` (a string) if the
+execution fails. For instance:
+
+ Run ComX "date" ["+\"%a %b %_d %H:%M\""] "N/A" "mydate" 600
+
+will display "N/A" if for some reason the `date` invocation fails.
## Other Plugins