Zed Debugger: Breakpoint Tweaks and Settings Configuration

Breakpoints can be tweaked depending on your needs; to access additional options of a given breakpoint, right-click on the breakpoint icon in the gutter and select the desired option. At present, you can: - Add a log to a breakpoint, which will output a log message whenever that breakpoint is hit. - Make the breakpoint conditional, which will only stop at the breakpoint when the condition is met. The syntax for conditions is adapter-specific. - Add a hit count to a breakpoint, which will only stop at the breakpoint after it's hit a certain number of times. - Disable a breakpoint, which will prevent it from being hit while leaving it visible in the gutter. Some debug adapters (e.g. CodeLLDB and JavaScript) will also _verify_ whether your breakpoints can be hit; breakpoints that cannot be hit are surfaced more prominently in the UI. All breakpoints enabled for a given project are also listed in "Breakpoints" item in your debugging session UI. From "Breakpoints" item in your UI you can also manage exception breakpoints. The debug adapter will then stop whenever an exception of a given kind occurs. Which exception types are supported depends on the debug adapter. ## Settings - `dock`: Determines the position of the debug panel in the UI. - `stepping_granularity`: Determines the stepping granularity. - `save_breakpoints`: Whether the breakpoints should be reused across Zed sessions. - `button`: Whether to show the debug button in the status bar. - `timeout`: Time in milliseconds until timeout error when connecting to a TCP debug adapter. - `log_dap_communications`: Whether to log messages between active debug adapters and Zed. - `format_dap_log_messages`: Whether to format DAP messages when adding them to the debug adapter logger. ### Dock - Description: The position of the debug panel in the UI. - Default: `bottom` - Setting: debugger.dock **Options** 1. `left` - The debug panel will be docked to the left side of the UI. 2. `right` - The debug panel will be docked to the right side of the UI. 3. `bottom` - The debug panel will be docked to the bottom of the UI. ```json "debugger": { "dock": "bottom" }, ``` ### Stepping granularity - Description: The Step granularity that the debugger will use - Default: line - Setting: debugger.stepping_granularity **Options**

This section describes how to tweak breakpoints, including adding logs, conditions, hit counts, and disabling them. It also details debugger settings like dock position, stepping granularity, breakpoint persistence, status bar button visibility, timeout for TCP connections, and DAP communication logging. It elaborates on the 'dock' and 'stepping_granularity' settings, providing options and examples.