From aae81b7e2a46e232fce72953c12b2ec4db812c9b Mon Sep 17 00:00:00 2001 From: Daniel Hahler Date: Mon, 4 Apr 2016 22:44:49 +0200 Subject: [PATCH] docs: add section about gdb to readme This should maybe get added to a separate section/page altogether instead, but in this short form it seems to fit here. --- docs/01-readme.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/01-readme.md b/docs/01-readme.md index 7a1f791f..009f18c1 100644 --- a/docs/01-readme.md +++ b/docs/01-readme.md @@ -55,6 +55,21 @@ If awesome does not start or the configuration file is not producing the desired results the user should examine this file to gain insight into the problem. +### Debugging tips + +You can call `awesome` with `gdb` like this: + + DISPLAY=:2 gdb awesome + +Then in gdb set any args and run it: + + (gdb) set arg --replace + (gdb) run + +Inside gdb you can use the following to print the current Lua stack traceback: + + (gdb) print luaL_dostring(globalconf.L.real_L_dont_use_directly, "print(debug.traceback())") + ## Reporting issues Please report any issues you may find on [our bugtracker](https://github.com/awesomeWM/awesome/issues).