mfussenegger / nvim-dap

Debug Adapter Protocol client implementation for Neovim
GNU General Public License v3.0
5.46k stars 194 forks source link

Docs don't mention `args` or `env` for configuration, only for adapters #1091

Closed FalcoGer closed 10 months ago

FalcoGer commented 10 months ago

Debug adapter definition and debug configuration

N/A

Debug adapter version

N/A

Steps to Reproduce

  1. :help dap-configuration
  2. ???
  3. No mention of env or args anywhere

Expected Result

Documentation of all fields that have an effect

Actual Result

Stumbled upon this feature after reading through issues and finding https://github.com/mfussenegger/nvim-dap/issues/455. Was wondering how to do it.

mfussenegger commented 10 months ago

This is controlled via a Configuration, which has 3 required fields:

In addition, a Configuration accepts an arbitrary number of further options which are debug-adapter-specific.

You have to refer to the upstream debug adapter documentation to learn about their supported options

FalcoGer commented 10 months ago

What does that even mean? gdb is a command line program. As far as I can tell, it interacts with DAP using stdout/stdin.

There is no adapter documentation. How am I supposed to know that I can add random fields to the dap-configuration (that's your plugin, not GDB) and it will affect things?