Improve command line help user experience.
This commit attempts to make the command line help user experience for `dotnet` more consistent for all of the built-in SDK commands. The following has been changed: * Organized the top-level help into a section detailing how to run .NET applications and a section on running SDK commands. * Sorted the SDK commands by name (previous ordering was undefined). * Removed `--verbosity` from the "common options section" since it is not a top-level option, nor is it common to all commands. * Added missing parameter names for parameterized options (especially for the `dotnet tool` subcommands). * Fixed the localization of parameter names for parameterized options. * Added missing `PROJECT` parameter to a few commands. * Fixed the localization of the build command's `PROJECT` parameter description. * Fixed the confusing descriptions for the `--framework`, `--configuration`, and `--runtime` options that were being shared between different commands. * Fixed the "unknown command" error for `dotnet help <command>` to show in red. * Deleted .resx for `dotnet msbuild` that is no longer used. * Change the option descriptions to be more consistent in their grammatical structure. * Removed extra blank line from end of help output. Fixes #7431. Fixes #9230. Fixes #9165.
This commit is contained in:
parent
a45bba7eb9
commit
88e2e9e993
363 changed files with 6214 additions and 4797 deletions
|
@ -20,8 +20,7 @@ Arguments:
|
|||
<PROJECT> The project file to operate on. If a file is not specified, the command will search the current directory for one.
|
||||
|
||||
Options:
|
||||
-h, --help Show help information.
|
||||
";
|
||||
-h, --help Show command line help.";
|
||||
|
||||
private const string ListCommandHelpText = @"Usage: dotnet list [options] <PROJECT> [command]
|
||||
|
||||
|
@ -29,11 +28,10 @@ Arguments:
|
|||
<PROJECT> The project file to operate on. If a file is not specified, the command will search the current directory for one.
|
||||
|
||||
Options:
|
||||
-h, --help Show help information.
|
||||
-h, --help Show command line help.
|
||||
|
||||
Commands:
|
||||
reference List all project-to-project references of the project.
|
||||
";
|
||||
reference List all project-to-project references of the project.";
|
||||
|
||||
const string FrameworkNet451Arg = "-f net451";
|
||||
const string ConditionFrameworkNet451 = "== 'net451'";
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue