From 1784906d6dbce0494347be3cd97ce3c104eb90ec Mon Sep 17 00:00:00 2001
From: Michael Stapelberg <michael@stapelberg.de>
Date: Tue, 25 Aug 2015 09:23:41 +0200
Subject: [PATCH] docs/userguide: document behavior of tray_output with
 multiple bars

fixes #1855
---
 docs/userguide | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/userguide b/docs/userguide
index eea7141b..98e8dee7 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -1371,6 +1371,11 @@ Note that you might not have a primary output configured yet. To do so, run:
 xrandr --output <output> --primary
 -------------------------
 
+Note that when you use multiple bar configuration blocks, either specify
+`tray_output primary` in all of them or explicitly specify `tray_output none`
+in bars which should not display the tray, otherwise the different instances
+might race each other in trying to display tray icons.
+
 === Tray padding
 
 The tray is shown on the right-hand side of the bar. By default, a padding of 2