From 92a50db29e9a842113502067f0eb7746281952cb Mon Sep 17 00:00:00 2001 From: Michael Stapelberg Date: Sat, 4 Jan 2014 12:04:43 +0100 Subject: [PATCH] docs/debugging: merge the debug symbols/backtrace section We rarely have crashes, almost always we just need logs. --- docs/debugging | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/debugging b/docs/debugging index 4b7bd371..88948c50 100644 --- a/docs/debugging +++ b/docs/debugging @@ -81,7 +81,10 @@ DISPLAY=:0 i3-dump-log | bzip2 -c > /tmp/i3.log.bz2 This command does not depend on i3 (it also works while i3 displays the crash dialog), but it requires a working X11 connection. -== Compiling with debug symbols +== On crashes: Obtaining a backtrace + +When i3 crashes, it will display a dialog stating “i3 just crashed”, offering +you to save a backtrace to a text file. To actually get useful backtraces, you should make sure that your version of i3 is compiled with debug symbols: @@ -97,8 +100,6 @@ which is stripped, please check whether your distribution provides debug symbols (package +i3-wm-dbg+ on Debian for example) or if you can turn off stripping. If nothing helps, please build i3 from source. -== Obtaining a backtrace - Once you have made sure that your i3 is compiled with debug symbols and the C debugger +gdb+ is installed on your machine, you can let i3 generate a backtrace in the crash dialog.