extension/src: document delve's outputMode parameter

Update the launch.json schema described in package.json to document the
missing outputMode parameter.

For go-delve/delve#3523

Change-Id: I602ca3b4c321369769a51e840829e1c48ce4e63b
Reviewed-on: https://go-review.googlesource.com/c/vscode-go/+/753000
Reviewed-by: Hongxiang Jiang <hxjiang@golang.org>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Madeline Kalil <mkalil@google.com>
Auto-Submit: Madeline Kalil <mkalil@google.com>

Author: aarzilli

docs/debugging.md

@@ -461,6 +461,7 @@ Here is the list of attributes specific to Go debugging.
 | `logOutput` | Comma separated list of components that should produce debug output. Maps to dlv's `--log-output` flag. Check `dlv log` for details.<br/><p>Allowed Values: `"debugger"`, `"gdbwire"`, `"lldbout"`, `"debuglineerr"`, `"rpc"`, `"dap"`<br/>(Default: `"debugger"`)<br/> | <center>_same as Launch_</center>|
 | `mode` | One of `auto`, `debug`, `test`, `exec`, `replay`, `core`. In `auto` mode, the extension will choose either `debug` or `test` depending on active editor window.<br/><p>Allowed Values: `"auto"`, `"debug"`, `"test"`, `"exec"`, `"replay"`, `"core"`<br/>(Default: `auto`)<br/> | Indicates local or remote debugging. Local is similar to the `dlv attach` command, remote - to `dlv connect`<br/><p>Allowed Values: `"local"`, `"remote"`<br/>(Default: `local`)<br/> |
 | `output` | Output path for the binary of the debugee.<br/>(Default: `"debug"`)<br/> | <center>_n/a_</center> |
+| `outputMode` | When set to 'remote' captures the target program's stdout and stderr and transfers it to the client via DAP protocol's output events.<br/><p>Allowed Values: `"local"`, `"remote"`<br/>(Default: `local`)<br/> | <center>_n/a_</center> |
 | `port` | When applied to remote-attach configurations, will look for "dlv ... --headless --listen=<host>:<port>" server started externally. In dlv-dap mode this will apply to all other configurations as well. The extension will try to connect to an external server started with "dlv dap --listen=<host>:<port>" to ask it to launch/attach to the target process.<br/>(Default: `2345`)<br/> | When applied to remote-attach configurations, will look for "dlv ... --headless --listen=<host>:<port>" server started externally. In dlv-dap mode, this will apply to all other configurations as well. The extension will try to connect to an external server started with "dlv dap --listen=<host>:<port>" to ask it to launch/attach to the target process.<br/>(Default: `2345`)<br/> |
 | `processId` | <center>_n/a_</center> | <br/><p><b>Option 1:</b> Use process picker to select a process to attach, or Process ID as integer.<br/><p>Allowed Values: `"${command:pickProcess}"`, `"${command:pickGoProcess}"`<br/><br/><p><b>Option 2:</b> Attach to a process by name. If more than one process matches the name, use the process picker to select a process.<br/><br/><p><b>Option 3:</b> The numeric ID of the process to be debugged. If 0, use the process picker to select a process.<br/><br/>(Default: `0`)<br/> |
 | `program` | Path to the program folder (or any go file within that folder) when in `debug` or `test` mode, and to the pre-built binary file to debug in `exec` mode. If it is not an absolute path, the extension interprets it as a workspace relative path.<br/>(Default: `"${workspaceFolder}"`)<br/> | <center>_n/a_</center> |

extension/package.json

@@ -875,6 +875,14 @@
                 "description": "(Experimental) Debug with elevated permissions (on Unix). It requires `integrated` or `external` console modes and is ignored in remote debugging.",
                 "type": "boolean"
               },
+              "outputMode": {
+                "default": "local",
+                "description": "When set to 'remote' captures the target program's stdout and stderr and transfers it to the client via DAP protocol's output events.",
+                "enum": [
+                  "local",
+                  "remote"
+                ]
+              },
               "stdinFrom": {
                 "type": "string",
                 "default": "",

extension/src/debugAdapter/goDebug.ts

@@ -309,6 +309,8 @@ interface LaunchRequestArguments extends DebugProtocol.LaunchRequestArguments {
 	// and send the information to DA using the 'env' property.
 	envFile?: string | string[];
 
+	outputMode?: string;
+
 	stdinFrom?: string;
 	stdoutTo?: string;
 	stderrTo?: string;