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 and attach by PID:](#launch-and-attach-by-pid)
* [Launch with options](#launch-with-options) * [Launch with options](#launch-with-options)
* [Breakpoints](#breakpoints) * [Breakpoints](#breakpoints)
* [Exception breakpoints](#exception-breakpoints)
* [Clear breakpoints](#clear-breakpoints)
* [Stepping](#stepping) * [Stepping](#stepping)
* [Variables and scopes](#variables-and-scopes) * [Variables and scopes](#variables-and-scopes)
* [Watches](#watches) * [Watches](#watches)
@ -66,7 +68,7 @@ For a tutorial and usage overview, take a look at the
* [Motivation](#motivation) * [Motivation](#motivation)
* [License](#license) * [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--> <!--te-->

56
docs/configuration.md
View file

@ -11,15 +11,21 @@ for Vimspector.
* [Debug adapter configuration](#debug-adapter-configuration) * [Debug adapter configuration](#debug-adapter-configuration)
* [Debug profile configuration](#debug-profile-configuration) * [Debug profile configuration](#debug-profile-configuration)
* [Replacements and variables](#replacements-and-variables) * [Replacements and variables](#replacements-and-variables)
* [The splat operator](#the-splat-operator)
* [Configuration Format](#configuration-format) * [Configuration Format](#configuration-format)
* [Files and locations](#files-and-locations) * [Files and locations](#files-and-locations)
* [Adapter configurations](#adapter-configurations) * [Adapter configurations](#adapter-configurations)
* [Debug configurations](#debug-configurations) * [Debug configurations](#debug-configurations)
* [Exception breakpionts](#exception-breakpionts) * [Exception breakpionts](#exception-breakpionts)
* [Predefined Variables](#predefined-variables) * [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) * [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--> <!--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 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: default value for `caught` exceptoins and to break on `uncaught` exception:
``` ```json
{ {
"configurations": { "configurations": {
"example-debug-configuration": { "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 ## Predefined Variables
The following variables are provided: The following variables are provided: