jyapayne/vimspector
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update contents links

Browse source
This commit is contained in:
Ben Jackson 2020-07-09 18:20:40 +01:00
commit a4abe511c7
2 changed files with 57 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

4
README.md
View file

@ -33,6 +33,8 @@ For a tutorial and usage overview, take a look at the
* [Launch and attach by PID:](#launch-and-attach-by-pid)
* [Launch with options](#launch-with-options)
* [Breakpoints](#breakpoints)
* [Exception breakpoints](#exception-breakpoints)
* [Clear breakpoints](#clear-breakpoints)
* [Stepping](#stepping)
* [Variables and scopes](#variables-and-scopes)
* [Watches](#watches)
@ -66,7 +68,7 @@ For a tutorial and usage overview, take a look at the
* [Motivation](#motivation)
* [License](#license)
<!-- Added by: ben, at: Mon 6 Jul 2020 11:30:01 BST -->
<!-- Added by: ben, at: Thu 9 Jul 2020 18:19:20 BST -->
<!--te-->

56
docs/configuration.md
View file

@ -11,15 +11,21 @@ for Vimspector.
* [Debug adapter configuration](#debug-adapter-configuration)
* [Debug profile configuration](#debug-profile-configuration)
* [Replacements and variables](#replacements-and-variables)
* [The splat operator](#the-splat-operator)
* [Configuration Format](#configuration-format)
* [Files and locations](#files-and-locations)
* [Adapter configurations](#adapter-configurations)
* [Debug configurations](#debug-configurations)
* [Exception breakpionts](#exception-breakpionts)
* [Predefined Variables](#predefined-variables)
* [Remote Debugging Support](#remote-debugging-support)
* [Python (debugpy) Example](#python-debugpy-example)
* [C-family (gdbserver) Example](#c-family-gdbserver-example)
* [Docker Example](#docker-example)
* [Appendix: Configuration file format](#appendix-configuration-file-format)
* [Appendix: Editor configuration](#appendix-editor-configuration)
<!-- Added by: ben, at: Tue 28 Jan 2020 08:47:40 GMT -->
<!-- Added by: ben, at: Thu 9 Jul 2020 18:19:39 BST -->
<!--te-->
@ -330,7 +336,7 @@ the configured response is empty string, the debug adapter default will be used.
Referring to the above example, the following tells the debug adapter to use the
default value for `caught` exceptoins and to break on `uncaught` exception:
```
```json
{
"configurations": {
"example-debug-configuration": {
@ -344,6 +350,52 @@ default value for `caught` exceptoins and to break on `uncaught` exception:
...
```
The keys in the `exception` mapping are what Vimspector includes in the prompt.
For example, when prompted with the following:
```
cpp_throw: Break on C++: on throw (Y/N/default: Y)?
```
The exception breakpoint "type" is `cpp_throw` and the default is `Y`.
Similarly:
```
cpp_catch: Break on C++: on catch (Y/N/default: N)?
```
The exception breakpoint "type" is `cpp_catch` and the default is `N`.
Use the following to set the values in config and not get asked:
```json
"configurations": {
"example-debug-configuration": {
"adapter": "example-adapter-name",
"breakpoints": {
"exception": {
"cpp_throw": "Y",
"cpp_catch": "Y"
}
},
```
To just accept the defaults for these exception breakpoint types, don't specify
a value, as in :
```json
"configurations": {
"example-debug-configuration": {
"adapter": "example-adapter-name",
"breakpoints": {
"exception": {
"cpp_throw": "",
"cpp_catch": ""
}
},
```
## Predefined Variables
The following variables are provided: