Commit graph

12 commits

Author SHA1 Message Date
Peter Huene
88e2e9e993
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.
2018-05-18 16:43:31 -07:00
jonsequitur
149f292b6a check for help in DotNetTopLevelCommandBase 2017-03-23 08:15:41 -07:00
Jon Sequeira
35732fc07d include HelpText in CommandParsingError, write it to stdout 2017-03-14 12:26:24 -07:00
Jon Sequeira
22fb17422f handle -? and /? arguments as help 2017-03-14 11:30:35 -07:00
Jon Sequeira
f5d9cfc79c reverse order of help response vs error response 2017-03-13 15:29:39 -07:00
Jon Sequeira
204d8594bf throw exception on parse errors 2017-03-13 13:29:03 -07:00
Jon Sequeira
02ac115f2b new CliCommandLine version with help fix 2017-03-13 09:03:14 -07:00
Jon Sequeira
a6c2b6c9f6 update CliCommandLine, other code changes 2017-03-12 15:06:34 -07:00
Jon Sequeira
a3f536c248 move subcommands to new parser 2017-03-10 16:43:44 -08:00
Jon Sequeira
46b799af01 trigger help display using HelpException 2017-03-09 12:31:34 -08:00
Jon Sequeira
fd6f7e48b5 WIP 2017-03-08 16:02:24 -08:00
jonsequitur
5f227c1c45 split parser definitions across multiple files 2017-03-06 12:21:51 -08:00