diff options
Diffstat (limited to 'docs/markdown')
| -rw-r--r-- | docs/markdown/Commands.md | 7 | ||||
| -rw-r--r-- | docs/markdown/snippets/devenv.md | 8 |
2 files changed, 15 insertions, 0 deletions
diff --git a/docs/markdown/Commands.md b/docs/markdown/Commands.md index 2623b5c..3542aa4 100644 --- a/docs/markdown/Commands.md +++ b/docs/markdown/Commands.md @@ -324,4 +324,11 @@ These variables are set in environment in addition to those set using `meson.add Since *Since 0.62.0* if bash-completion scripts are being installed and the shell is bash, they will be automatically sourced. +Since *Since 0.62.0* when GDB helper scripts (*-gdb.py, *-gdb.gdb, and *-gdb.csm) +are installed with a library name that matches one being built, Meson adds the +needed auto-load commands into `<builddir>/.gdbinit` file. When running gdb from +top build directory, that file is loaded by gdb automatically. In the case of +python scripts that needs to load other python modules, `PYTHONPATH` may need +to be modified using `meson.add_devenv()`. + {{ devenv_arguments.inc }} diff --git a/docs/markdown/snippets/devenv.md b/docs/markdown/snippets/devenv.md index 19a272c..1c401c1 100644 --- a/docs/markdown/snippets/devenv.md +++ b/docs/markdown/snippets/devenv.md @@ -8,3 +8,11 @@ and [`python.extension_module()`](Python-module.md#extension_module). If bash-completion scripts are being installed and the shell is bash, they will be automatically sourced. + +## Setup GDB auto-load for `meson devenv` + +When GDB helper scripts (*-gdb.py, *-gdb.gdb, and *-gdb.csm) are installed with +a library name that matches one being built, Meson adds the needed auto-load +commands into `<builddir>/.gdbinit` file. When running gdb from top build +directory, that file is loaded by gdb automatically. + |