Add documentation of preConnectCommands

Author: cwalther

CHANGELOG.md

@@ -3,6 +3,8 @@
 ## Unreleased
 
 - Fixes [cdt-gdb-adapter `#432`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/issues/432): Incorrect documentation of `initCommands`.
+- Update to cdt-gdb-adapter [v?.?.?](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/releases/tag/v?.?.?)
+    - Implements [`#432`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/issues/432): Add `preConnectCommands` setting.
 
 ## 2.6.0
 

README.md

@@ -35,6 +35,7 @@ Launch and attach configuration settings that can be used with the `gdb` debugge
 | `verbose` | x | x | `boolean` | Produce verbose log output. |
 | `logFile` | x | x | `string` | Absolute path to the file to log interaction with GDB.|
 | `openGdbConsole` | x | x | `boolean` | *(UNIX-only)* Open a GDB console in your IDE while debugging. |
+| `preConnectCommands` | x | x | `string[]` | List of GDB commands sent before attaching to inferior. |
 | `initCommands` | x | x | `string[]` | List of GDB commands sent after attaching to inferior before running/continuing. |
 
 
@@ -54,6 +55,7 @@ Launch and attach configuration settings that can be used with the `gdbtarget` d
 | `verbose` | x | x | `boolean` | Produce verbose log output. |
 | `logFile` | x | x | `string` | Absolute path to the file to log interaction with GDB.|
 | `openGdbConsole` | x | x | `boolean` | *(UNIX-only)* Open a GDB console in your IDE while debugging. |
+| `preConnectCommands` | x | x | `string[]` | List of GDB commands sent to initialize GDB before attaching to target. |
 | `initCommands` | x | x | `string[]` | List of GDB commands sent to initialize debug target after attaching to it but before loading image and symbols. |
 | `preRunCommands` | x | x | `string[]` | List of GDB commands sent after loading image on target before resuming target. |
 | `imageAndSymbols` | x | x | `object` | Additional settings for loading images to the target and symbols into the debugger. See section "`imageAndSymbols` object" for details.

package.json

@@ -153,6 +153,14 @@
                 "type": "boolean",
                 "description": "(UNIX-only) Open a GDB console in your IDE while debugging"
               },
+              "preConnectCommands": {
+                "type": "array",
+                "description": "List of GDB commands sent before initCommands.",
+                "items": {
+                  "type": "string"
+                },
+                "default": []
+              },
               "initCommands": {
                 "type": "array",
                 "description": "List of GDB commands sent before starting inferior.",
@@ -221,6 +229,14 @@
                 "type": "boolean",
                 "description": "(UNIX-only) Open a GDB console in your IDE while debugging"
               },
+              "preConnectCommands": {
+                "type": "array",
+                "description": "List of GDB commands sent before attaching to inferior.",
+                "items": {
+                  "type": "string"
+                },
+                "default": []
+              },
               "initCommands": {
                 "type": "array",
                 "description": "List of GDB commands sent after attaching to inferior before continuing.",
@@ -322,6 +338,14 @@
                 "type": "boolean",
                 "description": "(UNIX-only) Open a GDB console in your IDE while debugging"
               },
+              "preConnectCommands": {
+                "type": "array",
+                "description": "List of GDB commands sent before attaching to target.",
+                "items": {
+                  "type": "string"
+                },
+                "default": []
+              },
               "initCommands": {
                 "type": "array",
                 "description": "List of GDB commands sent after attaching to target before loading image on target.",
@@ -588,6 +612,14 @@
                 "type": "boolean",
                 "description": "(UNIX-only) Open a GDB console in your IDE while debugging"
               },
+              "preConnectCommands": {
+                "type": "array",
+                "description": "List of GDB commands sent before attaching to target.",
+                "items": {
+                  "type": "string"
+                },
+                "default": []
+              },
               "initCommands": {
                 "type": "array",
                 "description": "List of GDB commands sent after attaching to target before loading image on target.",