Skip to content

Commit 540c1af

Browse files
committed
Update links to use dotnet/vscode-csharp
1 parent f76cda2 commit 540c1af

11 files changed

+57
-57
lines changed

docs/C#-Extension-support-for-new-Linux-Distros-with-.NET-Core.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ There are four buckets that various Linux distros might fall into --
66
In this case the C# extension team should be able to produce a new version of the C# extension fairly soon after the .NET Core team publishes nuget packages which the C# extension can download.
77

88
### 2: .NET Core and vsdbg from another distro are binary compatible
9-
In this case it is just a matter of tweaking this [switch statement](https://github.com/OmniSharp/omnisharp-vscode/blob/a0d803fb0e30832b3a8c034e938c2e97662f9788/src/platform.ts#L226) which parses the output from `cat /etc/os-release`. While we cannot commit to testing on these unofficial distros we are happy to accept a PR to enable the distro, and if there are minor bugs in the debugger we are happy to try and fix them as well.
9+
In this case it is just a matter of tweaking this [switch statement](https://github.com/dotnet/vscode-csharp/blob/a0d803fb0e30832b3a8c034e938c2e97662f9788/src/platform.ts#L226) which parses the output from `cat /etc/os-release`. While we cannot commit to testing on these unofficial distros we are happy to accept a PR to enable the distro, and if there are minor bugs in the debugger we are happy to try and fix them as well.
1010

1111
### 3: The community has produced a .NET Core install script, and the public vsdbg can run
12-
For these distributions, the [debugger installer class](https://github.com/OmniSharp/omnisharp-vscode/blob/master/src/coreclr-debug/install.ts) can be run as a [gulp task](https://github.com/OmniSharp/omnisharp-vscode/blob/bc2eb6e5ec90f3b2c9e5a45e3aadd47e28539d01/gulpfile.js#L64). So it might be possible for the community to provide an install script which will find the current installed C# extension, use gulp to have the debugger and OmniSharp download the version of the extension from some other Linux distro, and then patch the CoreCLR/FX which they are running on. The C# extension team is happy to accept tweaks to the install code to make this easier.
12+
For these distributions, the [debugger installer class](https://github.com/dotnet/vscode-csharp/blob/master/src/coreclr-debug/install.ts) can be run as a [gulp task](https://github.com/dotnet/vscode-csharp/blob/bc2eb6e5ec90f3b2c9e5a45e3aadd47e28539d01/gulpfile.js#L64). So it might be possible for the community to provide an install script which will find the current installed C# extension, use gulp to have the debugger and OmniSharp download the version of the extension from some other Linux distro, and then patch the CoreCLR/FX which they are running on. The C# extension team is happy to accept tweaks to the install code to make this easier.
1313

1414
### 4: New vsdbg is needed
15-
vsdbg is the cross-platform .NET Core debugger backend. It is based on the same debugger as Visual Studio, and so is a closed-sound product. Distributions where the current public version of vsdbg cannot run are difficult to deal with. In general, we would need official support from the .NET Core team in these cases. Though feel free to open an [issue](https://github.com/OmniSharp/omnisharp-vscode/issues) to discuss the problem.
15+
vsdbg is the cross-platform .NET Core debugger backend. It is based on the same debugger as Visual Studio, and so is a closed-sound product. Distributions where the current public version of vsdbg cannot run are difficult to deal with. In general, we would need official support from the .NET Core team in these cases. Though feel free to open an [issue](https://github.com/dotnet/vscode-csharp/issues) to discuss the problem.

docs/How-to-run-and-debug-unit-tests.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ The C# extension currently supports running and debugging a unit test via CodeLe
55
### Notes
66

77
* Because `dotnet test` will run the test code in a child process, it isn't possible to configure a "unit test debugging" configuration in launch.json
8-
* There currently isn't a VS Code command to run the current test, though there is an [issue for this in the backlog](https://github.com/OmniSharp/omnisharp-vscode/issues/421).
9-
* You can tweak [debugging options](https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger-launchjson.md) for unit tests by opening your VS Code settings file (ex: File->Preferences->Settings on Windows), and configuring the `"csharp.unitTestDebuggingOptions"` setting. See example below.
10-
* If your unit tests are targeting .NET Framework instead of .NET Core, see [Desktop .NET Framework](https://github.com/OmniSharp/omnisharp-vscode/wiki/Desktop-.NET-Framework) for more information.
8+
* There currently isn't a VS Code command to run the current test, though there is an [issue for this in the backlog](https://github.com/dotnet/vscode-csharp/issues/421).
9+
* You can tweak [debugging options](https://github.com/dotnet/vscode-csharp/blob/master/debugger-launchjson.md) for unit tests by opening your VS Code settings file (ex: File->Preferences->Settings on Windows), and configuring the `"csharp.unitTestDebuggingOptions"` setting. See example below.
10+
* If your unit tests are targeting .NET Framework instead of .NET Core, see [Desktop .NET Framework](https://github.com/dotnet/vscode-csharp/wiki/Desktop-.NET-Framework) for more information.
1111

1212
Example User Settings file with unit test debugging options:
1313

docs/Troubleshooting:-'The-.NET-Core-SDK-cannot-be-located.'-errors.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ Note that, as of the time of this writing, there are also other incompatibilitie
7070
7171
More information about this problem can be found in [dotnet/cli#12110](https://github.com/dotnet/cli/issues/12110).
7272

73-
Some community members have been successful in using the Snap install by following the instructions listed in [Configuring Snap installs of dotnet-sdk](https://github.com/OmniSharp/omnisharp-vscode/wiki/Configuring-Snap-installs-of-dotnet-sdk).
73+
Some community members have been successful in using the Snap install by following the instructions listed in [Configuring Snap installs of dotnet-sdk](https://github.com/dotnet/vscode-csharp/wiki/Configuring-Snap-installs-of-dotnet-sdk).
7474

7575
Another possible workaround is to add the following to `~/.omnisharp/omnisharp.json`.
7676

@@ -84,4 +84,4 @@ Another possible workaround is to add the following to `~/.omnisharp/omnisharp.j
8484

8585
Instead, you also may create a symbolic link to your dotnet install like so:
8686

87-
`ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet`
87+
`ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet`

docs/debugger/.NET-Core-debugging-feature-list.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@ The following table describes the feature list for .NET Core debugging using VS
22

33
| Feature | Description | Visual Studio Code | Visual Studio For Mac | Visual Studio | Availability |
44
| --------- | ----------- | :----------------: | :-------------------: | :-----------: | ------------- |
5-
| Breakpoints | Adding / removing breakpoints | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview |
5+
| Breakpoints | Adding / removing breakpoints | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview |
66
| Execution control | Step through code (including async stepping), pause, continue | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
7-
| Launch / Attach | Includes launching, attaching to, detaching from and terminating the target app | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
8-
| EE | This is the ability to view variables, custom expressions in locals / watch windows | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
9-
| Just my code | This is the ability to hide external code during debugging | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
7+
| Launch / Attach | Includes launching, attaching to, detaching from and terminating the target app | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
8+
| EE | This is the ability to view variables, custom expressions in locals / watch windows | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
9+
| Just my code | This is the ability to hide external code during debugging | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.2.2 / VS For Mac Preview|
1010
| Conditional breakpoints | This is the ability to stop on a breakpoint when the given condition is satisfied | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.3.0 / VS For Mac Preview|
1111
| Debugging Razor views | This is the ability to debug embedded code in cshtml files | :white_check_mark: | :white_check_mark: | N/A | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.3.0 |
1212
| Edit variable values | This is the ability to update the value of a variable inside locals / watch windows | :white_check_mark: | :white_check_mark: | :white_check_mark: | VS2015.3 + [MIEngine](https://github.com/Microsoft/MIEngine/wiki/Building-the-MIEngine) / C# ext 1.3.0 / VS For Mac Preview|
@@ -16,10 +16,10 @@ The following table describes the feature list for .NET Core debugging using VS
1616
| Symbol Server | This is the ability to specify a remote server to pull down pdbs for code being debugged | [Work Item](https://github.com/dotnet/roslyn/issues/6881) | [Work Item](https://github.com/dotnet/roslyn/issues/6881) | [Work Item](https://github.com/dotnet/roslyn/issues/6881) |
1717
| Source Server | This is the ability to pull down sources from a remote server for code being debugged | [Work Item](https://github.com/dotnet/roslyn/issues/5397) [Work Item](https://github.com/dotnet/roslyn/issues/4119)| [Work Item](https://github.com/dotnet/roslyn/issues/5397) [Work Item](https://github.com/dotnet/roslyn/issues/4119) | [Work Item](https://github.com/dotnet/roslyn/issues/5397) [Work Item](https://github.com/dotnet/roslyn/issues/4119) | |
1818
| Manual symbol loading | This is the ability to locate and load symbols for a module anytime during a debug session | | | | |
19-
| Function bps | This is the ability to stop the debugger at the start of a given function | [Work Item](https://github.com/OmniSharp/omnisharp-vscode/issues/295)| [Work Item](https://github.com/OmniSharp/omnisharp-vscode/issues/295) | [Work Item](https://github.com/OmniSharp/omnisharp-vscode/issues/295) |
20-
| Hit count bps | This is the ability to stop the debugger after a breakpoint is hit given number of times | [Work Item](https://github.com/OmniSharp/omnisharp-vscode/issues/895)| [Work Item](https://github.com/OmniSharp/omnisharp-vscode/issues/895) | [Work Item](https://github.com/OmniSharp/omnisharp-vscode/issues/895) |
19+
| Function bps | This is the ability to stop the debugger at the start of a given function | [Work Item](https://github.com/dotnet/vscode-csharp/issues/295)| [Work Item](https://github.com/dotnet/vscode-csharp/issues/295) | [Work Item](https://github.com/dotnet/vscode-csharp/issues/295) |
20+
| Hit count bps | This is the ability to stop the debugger after a breakpoint is hit given number of times | [Work Item](https://github.com/dotnet/vscode-csharp/issues/895)| [Work Item](https://github.com/dotnet/vscode-csharp/issues/895) | [Work Item](https://github.com/dotnet/vscode-csharp/issues/895) |
2121
| Edit and Continue | This is the ability to make code changes during a debugging session without having to restart a new session | [Work Item](https://github.com/dotnet/roslyn/issues/1952) | [Work Item](https://github.com/dotnet/roslyn/issues/1952) | [Work Item](https://github.com/dotnet/roslyn/issues/1952) |
2222
| Dump debugging | This is the ability to debug crash dumps | | | | |
2323
| Return values | This is the ability to see the values a function returns as the user is stepping through the code | | | | |
2424
| Visualizers | This is the ability to invoke a custom UI for visualizing a value in the locals / watch windows | | | | |
25-
| Step Into Specific | This is the ability to select a particular function to step into when the current instruction pointer is on a line that contains multiple functions to be called | | | |
25+
| Step Into Specific | This is the ability to select a particular function to step into when the current instruction pointer is on a line that contains multiple functions to be called | | | |

docs/debugger/Attaching-to-remote-processes.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ Last, to be able to debug obviously the application must somehow be runnable on
9191

9292
There are two special concerns in this area when it comes to debugging:
9393

94-
1. Debug vs. Release Configuration: If you are going to be debugging, the experience is going to be much better if the debug configuration of your application is running instead of the release configuration. If this isn't possible, one can debug release code. To do this, disable [justMyCode](https://github.com/OmniSharp/omnisharp-vscode/blob/release/debugger.md#just-my-code) in launch.json.
94+
1. Debug vs. Release Configuration: If you are going to be debugging, the experience is going to be much better if the debug configuration of your application is running instead of the release configuration. If this isn't possible, one can debug release code. To do this, disable [justMyCode](https://github.com/dotnet/vscode-csharp/blob/release/debugger.md#just-my-code) in launch.json.
9595
2. PDB files: In order for VSDBG to be able to be able to map executable code back to its source code (or vice versa) VSDBG needs to have PDB files. If you are already building your application on the target server, this is taken care of for you. If you are building it somewhere else, you need to make sure to copy the PDB files next to their associated dll or set the DebugType to 'embedded' so that the PDB data is kept inside of the compiled dll.
9696

9797
### Configuring Docker attach with launch.json
@@ -156,7 +156,7 @@ If vsdbg is crashing or being aborted a few additional troubleshooting steps:
156156

157157
#### 1: Check for libicu compatibility
158158

159-
See the [Testing libicu compatibility on Linux](https://github.com/OmniSharp/omnisharp-vscode/wiki/Testing-libicu-compatibility-on-Linux) page for more information.
159+
See the [Testing libicu compatibility on Linux](https://github.com/dotnet/vscode-csharp/wiki/Testing-libicu-compatibility-on-Linux) page for more information.
160160

161161
#### 2: Save a coredump of a possible vsdbg crash
162162

docs/debugger/Desktop-.NET-Framework.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
The C# extension supports limited full .NET framework debugging. It can only debug 64-bit applications with [portable PDBs](https://github.com/OmniSharp/omnisharp-vscode/wiki/Portable-PDBs).
1+
The C# extension supports limited full .NET framework debugging. It can only debug 64-bit applications with [portable PDBs](https://github.com/dotnet/vscode-csharp/wiki/Portable-PDBs).
22

33
To enable the Desktop CLR debugger, change the configuration type in launch.json to be "clr" instead of "coreclr" and program should be pointing at the exe (**NOT** a .dll).
44

55
For unit tests, this can be done thusly:
66
1. File->Preferences->Settings
77
2. Open "CSharp: Unit Test Debugging Options"
88
3. Set the 'type' to 'clr' (see settings.json example below)
9-
4. NOTE: For MSTest projects, also see [Forcing MSTest projects to use a 64-bit worker](https://github.com/OmniSharp/omnisharp-vscode/wiki/Desktop-.NET-Framework#forcing-mstest-projects-to-use-a-64-bit-worker) section.
9+
4. NOTE: For MSTest projects, also see [Forcing MSTest projects to use a 64-bit worker](https://github.com/dotnet/vscode-csharp/wiki/Desktop-.NET-Framework#forcing-mstest-projects-to-use-a-64-bit-worker) section.
1010

1111
## launch.json example
1212

@@ -49,4 +49,4 @@ To fix this:
4949
<TargetPlatform>x64</TargetPlatform>
5050
</RunConfiguration>
5151
</RunSettings>
52-
```
52+
```

docs/debugger/Diagnosting-'Debug-adapter-process-has-terminated-unexpectedly'.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
If Visual Studio code displays "Debug adapter process has terminated unexpectedly", and the debug console doesn't have information about why, this generally means that the debugger process (vsdbg-ui) crashed. Here is some information you can provide us to diagnose what went wrong.
22

33
### Common
4-
On all OSs, it can be useful to have [logging enabled](https://github.com/OmniSharp/omnisharp-vscode/wiki/Enabling-C%23-debugger-logging), and to provide the last bit of the event log.
4+
On all OSs, it can be useful to have [logging enabled](https://github.com/dotnet/vscode-csharp/wiki/Enabling-C%23-debugger-logging), and to provide the last bit of the event log.
55

66
### macOS
77

@@ -66,8 +66,8 @@ Faulting application start time: 0x01d2cf58f1e7031e
6666
Faulting application path: C:\Users\greggm\.vscode\extensions\ms-dotnettools.csharp-1.21.18\.debugger\vsdbg-ui.exe
6767
Faulting module path: C:\Users\greggm\.vscode\extensions\ms-dotnettools.csharp-1.21.18\.debugger\vsdbg.DLL
6868
Report Id: 694807aa-44e0-42d3-8129-437f457a5efd
69-
Faulting package full name:
70-
Faulting package-relative application ID:
69+
Faulting package full name:
70+
Faulting package-relative application ID:
7171
```
7272

7373
### Linux

docs/debugger/Microsoft-.NET-Core-Debugger-licensing-and-Microsoft-Visual-Studio-Code.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,4 @@ The C# extension for Visual Studio Code includes the Microsoft .NET Core Debugge
1010

1111
If you installed the OSS version of VS Code, you can uninstall it and reinstall the Microsoft version from [https://code.visualstudio.com/download](https://code.visualstudio.com/download).
1212

13-
If you believe you have the Microsoft version installed and you are still seeing this problem, you can [open an issue](https://github.com/omnisharp/omnisharp-vscode/issues) in this repo.
13+
If you believe you have the Microsoft version installed and you are still seeing this problem, you can [open an issue](https://github.com/dotnet/vscode-csharp/issues) in this repo.

0 commit comments

Comments
 (0)