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.
This commit is contained in:
Daniel Hahler 2016-04-04 22:44:49 +02:00
parent ce3e6648ac
commit aae81b7e2a
1 changed files with 15 additions and 0 deletions

View File

@ -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 desired results the user should examine this file to gain insight into the
problem. 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 ## Reporting issues
Please report any issues you may find on [our bugtracker](https://github.com/awesomeWM/awesome/issues). Please report any issues you may find on [our bugtracker](https://github.com/awesomeWM/awesome/issues).