Merge pull request #1669 from Airblader/feature-docs-2

[i3/i3] / docs / debugging

diff --git a/docs/debugging b/docs/debugging
index b803103693bf760a2b00f31e1e17cc7d277ba963..894a873b10b1111b3bea5bc2c97fff60b275c1d3 100644 (file)
--- a/docs/debugging
+++ b/docs/debugging
@@ -121,3 +121,19 @@ When debugging with us in IRC, be prepared to use a so called nopaste service
 such as http://nopaste.info or http://pastebin.com because pasting large
 amounts of text in IRC sometimes leads to incomplete lines (servers have line
 length limitations) or flood kicks.
+
+== Debugging i3bar
+
+To debug i3bar problems, add +verbose yes+ to all +bar {}+ blocks in your i3 config
+and then restart all i3bar instances like this:
+
+---------------------------------------------------------------------
+$ killall i3bar
+$ for c in $(i3-msg -t get_bar_config | python -c \
+      'import json,sys;print("\n".join(json.load(sys.stdin)))'); do \
+    (i3bar --bar_id=$c >i3bar.$c.log 2>&1) & \
+  done;
+---------------------------------------------------------------------
+
+There will now be +i3bar.*.log+ files in your current directory that you can provide
+in your bug report.