args icon indicating copy to clipboard operation
args copied to clipboard

Display a description and a quick usage message

Open PoloLacoste opened this issue 5 years ago • 1 comments

Would it be usefull to add a quick usage message and a description at the top of the usage message.

For instance, the example in 'example/test_runner.dart' would look like this :

usage: [-c] [-r] [-a] [-s] [-m] [--[no-]checked] [--[no-]host-checked] [-t] [-j] [--shards] [--shard] [--[no-]valgrind] [-p] [--[no-]report] [-v] [--[no-]list] [--[no-]time] [-b] [--[no-]keep-generated-tests] [--special-command] [--dart] [--drt] [--dartium] [--mandatory]

A simple description

===== Platform
-c, --compiler                     Specify any compilation step (if needed).
[...]

PoloLacoste avatar Jan 06 '21 08:01 PoloLacoste

I think most users simply print the description themselves before printing the usage information:

A simple description

usage: [-c] [-r] [-a] [-s] [-m] [--[no-]checked] [--[no-]host-checked] [-t] [-j] [--shards] [--shard] [--[no-]valgrind] [-p] [--[no-]report] [-v] [--[no-]list] [--[no-]time] [-b] [--[no-]keep-generated-tests] [--special-command] [--dart] [--drt] [--dartium] [--mandatory]

===== Platform
-c, --compiler                     Specify any compilation step (if needed).
[...]

munificent avatar Jan 11 '21 20:01 munificent