From 801b795b450045604626d4995dbc024f505a9c50 Mon Sep 17 00:00:00 2001
From: Michael Stapelberg <michael@stapelberg.de>
Date: Fri, 12 Jun 2015 09:52:02 +0200
Subject: [PATCH] userguide: document signal handling caveat affecting at least
 dash(1)

fixes #1741
---
 docs/userguide | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

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
 }
 -------------------------------------------------