From: Michael Stapelberg <michael@stapelberg.de>
Date: Fri, 12 Jun 2015 07:52:02 +0000 (+0200)
Subject: userguide: document signal handling caveat affecting at least dash(1)
X-Git-Tag: 4.11~94
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=801b795b450045604626d4995dbc024f505a9c50;p=i3%2Fi3

userguide: document signal handling caveat affecting at least dash(1)

fixes #1741
---

diff --git a/docs/userguide b/docs/userguide
index 2c90c50d..5af5f915 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -1143,7 +1143,10 @@ right hand side of the bar. This is useful to display system information like
 your current IP address, battery status or date/time.
 
 The specified command will be passed to +sh -c+, so you can use globbing and
-have to have correct quoting etc.
+have to have correct quoting etc. Note that for signal handling, depending on
+your shell (users of dash(1) are known to be affected), you have to use the
+shell’s exec command so that signals are passed to your program, not to the
+shell.
 
 *Syntax*:
 ------------------------
@@ -1154,6 +1157,9 @@ status_command <command>
 -------------------------------------------------
 bar {
     status_command i3status --config ~/.i3status.conf
+
+    # For dash(1) users who want signal handling to work:
+    status_command exec ~/.bin/my_status_command
 }
 -------------------------------------------------