You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Is your feature request related to a problem? Please describe.
It feels frustrating when even the help command gives an error.
$ jj help annotate
error: unrecognized subcommand 'annotate'
Usage: jj [OPTIONS] <COMMAND>
For more information, try '--help'.
Right now, we have opaque, minimal descriptions such as
bookmark Manage bookmarks
config Manage config options
file File operations
git Commands for working with Git remotes and the underlying Git repo
operation Commands for working with the operation log
tag Manage tags
util Infrequently used commands such as for generating shell completions
workspace Commands for working with workspaces
There is also duplication of jj version and jj -V. When I tried what I thought should work, I got an error:
$ jj help -V
error: unexpected argument '-V' found
tip: to pass '-V' as a value, use '-- -V'
Usage: jj help [OPTIONS] [COMMAND]...
For more information, try '--help'.
Describe the solution you'd like
Instead of suggesting --help on the help command, it should fall back to -h summary, to output some actual help. Or look one level deeper, to find the subcommand.
The commands with subcommands should list the subcommands in the general help.
I think that the help should always print the version, but if not, it should handle the -V flag, or the -V should be a global option. (Global options don't work with help either though...)
Additional context
Using jj 0.23.0
The text was updated successfully, but these errors were encountered:
The "For more information, try '--help'" seems especially unhelpful, since it doesn't help to add --help.
I'm tempted to add a "help wanted" label, to indicate that we're looking for helpers who can help make our help more helpful, but I will resist doing it for the sole reason of wordplay.
Or maybe it should be a "help help help" label. Help help help our users!
Is your feature request related to a problem? Please describe.
It feels frustrating when even the
help
command gives an error.Right now, we have opaque, minimal descriptions such as
There is also duplication of
jj version
andjj -V
. When I tried what I thought should work, I got an error:Describe the solution you'd like
Instead of suggesting
--help
on thehelp
command, it should fall back to-h
summary, to output some actual help. Or look one level deeper, to find the subcommand.The commands with subcommands should list the subcommands in the general help.
I think that the
help
should always print the version, but if not, it should handle the-V
flag, or the-V
should be a global option. (Global options don't work withhelp
either though...)Additional context
Using
jj
0.23.0The text was updated successfully, but these errors were encountered: