From 502cd381ea3e69e6df49aa29200e5ca69d68f26d Mon Sep 17 00:00:00 2001 From: Andrew Schwartzmeyer Date: Fri, 6 May 2016 10:55:17 -0700 Subject: [PATCH] Note the pre-release VS Code requirements --- docs/debugging/README.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/debugging/README.md b/docs/debugging/README.md index 2994048d1..319c423d6 100644 --- a/docs/debugging/README.md +++ b/docs/debugging/README.md @@ -2,7 +2,7 @@ Debugging ========= VS Code -------- +======= [Experimental .NET Core Debugging in VS Code][core-debug] enables cross-platform debugging with the [Visual Studio Code][vscode] editor. @@ -38,19 +38,32 @@ process named `powershell`, and will attach to it. If you need more fine grained control, replace `processName` with `processId` and provide a PID. (Please be careful not to commit such a change). +Important Note +-------------- + +Debugging is very sensitive to the versions of our .NET Core packages, VS Code, +and the C# extension. + +- Use the VS Code [Insiders][] build +- Use the latest pre-release of the [C# extension][] +- Refer to the pre-release [documentation][] + [core-debug]: https://blogs.msdn.microsoft.com/visualstudioalm/2016/03/10/experimental-net-core-debugging-in-vs-code/ [vscode]: https://code.visualstudio.com/ [OmniSharp]: https://github.com/OmniSharp/omnisharp-vscode [vscclrdebugger]: http://aka.ms/vscclrdebugger +[insiders]: https://code.visualstudio.com/insiders +[C# extension]: https://github.com/OmniSharp/omnisharp-vscode/releases +[documentation]: https://github.com/OmniSharp/omnisharp-vscode/pull/157 corehost --------- +======== The native executable prouduced by .NET CLI will produce trace output if launched with `COREHOST_TRACE=1 ./powershell`. CoreCLR PAL ------------ +=========== The native code in the CLR has debug channels to selectively output information to the console. These are controlled by the