Skip to content

Commit 6af7bc6

Browse files
committed
Updating the readme after renaming lldb-dap custom-event to lldb-dap send-event.
1 parent b7ead5a commit 6af7bc6

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

lldb/tools/lldb-dap/README.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -290,30 +290,37 @@ The initial repl-mode can be configured with the cli flag `--repl-mode=<mode>`
290290
and may also be adjusted at runtime using the lldb command
291291
`lldb-dap repl-mode <mode>`.
292292

293-
#### `lldb-dap custom-event`
293+
#### `lldb-dap send-event`
294294

295-
lldb-dap includes a custom command to trigger a Debug Adapter Protocol event
296-
from a script. [See the specification](https://microsoft.github.io/debug-adapter-protocol/specification#Base_Protocol_Event)
297-
for more details on Debug Adapter Protocol events.
295+
lldb-dap includes a command to trigger a Debug Adapter Protocol event
296+
from a script.
297+
298+
The event maybe a custom DAP event or a standard event, if the event is not
299+
handled internally by `lldb-dap`.
298300

299301
This command has the format:
300302

301303
```
302-
lldb-dap custom-event <name> <body>?
304+
lldb-dap send-event <name> <body>?
303305
```
304306

305-
For example you can use a launch configuration hook to run the command like:
307+
For example you can use a launch configuration hook to trigger custom events like:
306308

307309
```json
308310
{
309311
"program": "exe",
310312
"stopCommands": [
311-
"lldb-dap custom-event MyStopEvent",
312-
"lldb-dap custom-event MyStopEvent '{\"key\":321}",
313+
"lldb-dap send-event MyStopEvent",
314+
"lldb-dap send-event MyStopEvent '{\"key\": 321}",
313315
]
314316
}
315317
```
316318

319+
[See the specification](https://microsoft.github.io/debug-adapter-protocol/specification#Base_Protocol_Event)
320+
for more details on Debug Adapter Protocol events and the VS Code
321+
[debug.onDidReceiveDebugSessionCustomEvent](https://code.visualstudio.com/api/references/vscode-api#debug.onDidReceiveDebugSessionCustomEvent)
322+
API for handling a custom event from an extension.
323+
317324
## Contributing
318325

319326
`lldb-dap` and `lldb` are developed under the umbrella of the [LLVM project](https://llvm.org/).

0 commit comments

Comments
 (0)