Add items for C# extension missing OmniSharp

This commit is contained in:
Mark J Price 2023-06-14 21:56:20 +01:00
parent ed8ca3828a
commit e464aab384
2 changed files with 25 additions and 2 deletions

View file

@ -2,7 +2,7 @@
If you find any mistakes in the seventh edition, *C# 11 and .NET 7 - Modern Cross-Platform Development Fundamentals*, or if you have suggestions for improvements, then please [raise an issue in this repository](https://github.com/markjprice/cs11dotnet7/issues) or email me at markjprice (at) gmail.com. If you find any mistakes in the seventh edition, *C# 11 and .NET 7 - Modern Cross-Platform Development Fundamentals*, or if you have suggestions for improvements, then please [raise an issue in this repository](https://github.com/markjprice/cs11dotnet7/issues) or email me at markjprice (at) gmail.com.
[**Errata** (44 items)](errata.md): Typos, tool user interface changes, or mistakes in code that would cause a compilation error that prevents a successful build. [**Errata** (47 items)](errata.md): Typos, tool user interface changes, or mistakes in code that would cause a compilation error that prevents a successful build.
[**Improvements** (41 items)](improvements.md): Changes to text or code that would improve the content. These are optional. [**Improvements** (41 items)](improvements.md): Changes to text or code that would improve the content. These are optional.

View file

@ -1,11 +1,14 @@
**Errata** (44 items) **Errata** (47 items)
If you find any mistakes, then please [raise an issue in this repository](https://github.com/markjprice/cs11dotnet7/issues) or email me at markjprice (at) gmail.com. If you find any mistakes, then please [raise an issue in this repository](https://github.com/markjprice/cs11dotnet7/issues) or email me at markjprice (at) gmail.com.
> Microsoft has changed their domain for documentation from `https://docs.microsoft.com` to `https://learn.microsoft.com` with an automatic redirect so all links in my books that use the `docs` domain should still work. > Microsoft has changed their domain for documentation from `https://docs.microsoft.com` to `https://learn.microsoft.com` with an automatic redirect so all links in my books that use the `docs` domain should still work.
- [Page 4, 8 - Pros and cons of the .NET Interactive Notebooks extension, Downloading and installing Visual Studio Code](#page-4-8---pros-and-cons-of-the-net-interactive-notebooks-extension-downloading-and-installing-visual-studio-code) - [Page 4, 8 - Pros and cons of the .NET Interactive Notebooks extension, Downloading and installing Visual Studio Code](#page-4-8---pros-and-cons-of-the-net-interactive-notebooks-extension-downloading-and-installing-visual-studio-code)
- [Page 8 - Installing other extensions](#page-8---installing-other-extensions)
- [Page 11 - Understanding the journey to one .NET and Understanding .NET support](#page-11---understanding-the-journey-to-one-net-and-understanding-net-support) - [Page 11 - Understanding the journey to one .NET and Understanding .NET support](#page-11---understanding-the-journey-to-one-net-and-understanding-net-support)
- [Page 28 - Writing code using Visual Studio Code](#page-28---writing-code-using-visual-studio-code)
- [Page 31 - Adding a second project using Visual Studio Code](#page-31---adding-a-second-project-using-visual-studio-code)
- [Page 36 - Getting help for the dotnet tool](#page-36---getting-help-for-the-dotnet-tool) - [Page 36 - Getting help for the dotnet tool](#page-36---getting-help-for-the-dotnet-tool)
- [Page 37 - Getting definitions of types and their members](#page-37---getting-definitions-of-types-and-their-members) - [Page 37 - Getting definitions of types and their members](#page-37---getting-definitions-of-types-and-their-members)
- [Page 75 - Comparing double and decimal types](#page-75---comparing-double-and-decimal-types) - [Page 75 - Comparing double and decimal types](#page-75---comparing-double-and-decimal-types)
@ -62,6 +65,12 @@ The **.NET Interactive Notebooks** extension has been renamed to **Polyglot Note
I wrote that "They cannot read input from the user, for example, you cannot use ReadLine or ReadKey." Although you cannot use the `Console` class methods, you can use the `Microsoft.DotNet.Interactive.Kernel` class and its `GetInputAsync` method. This uses the Visual Studio Code user interface to prompt the user for input. I wrote that "They cannot read input from the user, for example, you cannot use ReadLine or ReadKey." Although you cannot use the `Console` class methods, you can use the `Microsoft.DotNet.Interactive.Kernel` class and its `GetInputAsync` method. This uses the Visual Studio Code user interface to prompt the user for input.
# Page 8 - Installing other extensions
In the table, the C# for Visual Studio Code says it is "powered by OmniSharp". This is true up to the most recent release version `1.25.9`. But if you install the pre-release version `2.0.x` then it does not include OmniSharp any more.
To follow the instructions in the book, if you have installed the pre-release version `2.0.x` then I recommend that you click the button Switch to Release Version to revert back to the current release version `1.25.9`.
# Page 11 - Understanding the journey to one .NET and Understanding .NET support # Page 11 - Understanding the journey to one .NET and Understanding .NET support
Even-numbered .NET releases like .NET 6 and .NET 8 have a support level named **Long Term Support (LTS)** with a duration of 3 years. Odd-numbered .NET releases like .NET 5 and .NET 7 had a support level named **Current** with a duration of 18 months. Even-numbered .NET releases like .NET 6 and .NET 8 have a support level named **Long Term Support (LTS)** with a duration of 3 years. Odd-numbered .NET releases like .NET 5 and .NET 7 had a support level named **Current** with a duration of 18 months.
@ -74,6 +83,20 @@ On October 28, 2022, the .NET team changed the name *again*, to [**Standard Term
*Sigh.* Such are the perils of trying to be up-to-date on release day. *Sigh.* Such are the perils of trying to be up-to-date on release day.
# Page 28 - Writing code using Visual Studio Code
In Step 18, I wrote, "Visual Studio Code may have to download and install C# dependencies like OmniSharp, .NET Core Debugger, and Razor Language Server". This is true up to the most recent release version `1.25.9`. But if you install the pre-release version `2.0.x` then it does not include OmniSharp any more.
To follow the instructions in the book, if you have installed the pre-release version `2.0.x` then I recommend that you click the button Switch to Release Version to revert back to the current release version `1.25.9`.
# Page 31 - Adding a second project using Visual Studio Code
In Step 7, I wrote, "Enter `omni`, and then, in the drop-down list that appears, select **OmniSharp: Select Project**."
This works if you installed the most recent release version `1.25.9`. But if you installed the pre-release version `2.0.x` then it does not include OmniSharp any more.
To follow the instructions in the book, if you have installed the pre-release version `2.0.x` then I recommend that you click the button Switch to Release Version to revert back to the current release version `1.25.9`.
# Page 36 - Getting help for the dotnet tool # Page 36 - Getting help for the dotnet tool
Step 1 is about opening a web browser to show the documentation for a `dotnet` command. It follows this syntax: Step 1 is about opening a web browser to show the documentation for a `dotnet` command. It follows this syntax: