devilutionX/tools/gdb/README.md

gdb debugging enhancements

Requires gdb v14.1+.

The code in this directory is imported via .gdbinit.

Working directory .gdb is not loaded by default.

You can run gdb with -iex 'add-auto-load-safe-path .' to load it.

For example:

gdb -iex 'add-auto-load-safe-path .' build/devilutionx

If you're using VS Code with CMake, you can instead add the following to your .vscode/settings.json:

"cmake.debugConfig": {
  "setupCommands": [
    {
      "description": "Enable pretty-printing for gdb",
      "text": "-enable-pretty-printing",
      "ignoreFailures": true
    },
    {
      "description": "Load gdb enhancements",
      "text": "source ${workspaceFolder}/tools/gdb/devilution_gdb/__init__.py",
      "ignoreFailures": false
    }
  ]
}