Add item for page 36

This commit is contained in:
Mark J Price 2023-03-05 21:56:10 +00:00
parent 7e9c177bc9
commit 320fe881b4
2 changed files with 22 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.
[**Errata** (31 items)](errata.md): Typos, tool user interface changes, or mistakes in code that would cause a compilation error that prevents a successful build.
[**Errata** (32 items)](errata.md): Typos, tool user interface changes, or mistakes in code that would cause a compilation error that prevents a successful build.
[**Improvements** (16 items)](improvements.md): Changes to text or code that would improve the content. These are optional.

View file

@ -1,4 +1,4 @@
**Errata** (31 items)
**Errata** (32 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.
@ -6,6 +6,7 @@ If you find any mistakes, then please [raise an issue in this repository](https:
- [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 11 - Understanding the journey to one .NET and Understanding .NET support](#page-11---understanding-the-journey-to-one-net-and-understanding-net-support)
- [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 83 - Formatting using numbered positional arguments](#page-83---formatting-using-numbered-positional-arguments)
- [Page 83 - Formatting using interpolated strings](#page-83---formatting-using-interpolated-strings)
@ -59,6 +60,25 @@ 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.
# Page 36 - Getting help for the dotnet tool
Step 1 is about opening a web browser to show the documentation help about a command. It follows this syntax:
```
dotnet help <command>
```
I gave the example of `dotnet help new`, and although this worked in .NET Core 3 up to .NET 6, with .NET 7 it gives an error!
Other examples, like `dotnet help run`, work correctly by opening a web browser to show the `run` command's documentation.
The other type of help, as described in Step 2, is command-line documenation and it follows this syntax:
```
dotnet <command> -?|-h|--help
```
For example, `dotnet new -?` or `dotnet new -h` or `dotnet new --help` outputs documentation about the `new` command at the command-line.
And so `dotnet help help` opens a web browser for the `help` command, and `dotnet help -h` outputs documentation for the `help` command at the command-line!
# Page 37 - Getting definitions of types and their members
In Step 3, I wrote, "Click inside `int` and then right-click and choose **Go To Definition**."