Feature #4503
closed
nfdc: add aliases of ‘help’ subcommand
100%
Description
‘nfdc help face’ should be aliased as:
- nfdc face -h
- nfdc face help
Updated by Alex Afanasyev almost 7 years ago
Please make aliases to this one. Not receiving any hint is really frustrating.
Updated by Nicholas Gordon almost 7 years ago
I agree. Most people building it from source won't install the manpages, either. I don't even know how to install them, for example.
Updated by Davide Pesavento almost 7 years ago
- Subject changed from Improve usability of `nfdc` to Improve usability of nfdc
- Category set to Tools
100% agree. I've been wanting to open a similar issue for a long time. Current nfdc is very unfriendly to the user.
Updated by Junxiao Shi almost 7 years ago
- Tracker changed from Task to Feature
- Subject changed from Improve usability of nfdc to nfdc: add aliases of ‘help’ subcommand
- Description updated (diff)
Original description:
I am having really hard time with nfdc interface, as it does not provide help along the way. Here are my expectation to give me hints (to give short list of available commands)
nfdc facenfdc face -hnfdc face help
An issue must have measurable completion point, and “improving useability” is a goal but does not have measurable completion.
I’ve limited the scope of this issue to provide aliases only. Note that ‘nfdc face’ cannot be aliased to ‘nfdc help face’ because it’s already an alias of ‘nfdc face list’.
A follow-up issue #4505 offers TAB completion of command names, further improves useability.
Updated by Junxiao Shi almost 7 years ago
- Related to Feature #4505: nfdc: TAB completion for command names added
Updated by Davide Pesavento almost 7 years ago
- Status changed from New to In Progress
- Assignee set to Davide Pesavento
- Target version set to v0.7
Updated by Davide Pesavento almost 7 years ago
- Status changed from In Progress to Code review
- % Done changed from 0 to 100
Updated by Junxiao Shi almost 7 years ago
hmm do we want this to work also for
nfdc <module> <verb> --help? i.e. when both module and verb are specified before --help? (it doesn't at the moment)
Yes, nfdc noun verb —help and nfdc noun verb -h are useful.
nfdc noun verb help should be avoided because it causes ambiguity with a command argument named “help”.
Updated by Davide Pesavento almost 7 years ago
Junxiao Shi wrote:
nfdc noun verb helpshould be avoided because it causes ambiguity with a command argument named “help”.
No command has an argument named "help" at the moment, and I don't expect we'll ever have one. It's more important to reserve "help" as a synonym of "--help".
Updated by Davide Pesavento almost 7 years ago
- Status changed from Code review to In Progress
Updated by Davide Pesavento almost 7 years ago
- Status changed from In Progress to Code review
- % Done changed from 50 to 100
Updated by Davide Pesavento almost 7 years ago
- Status changed from Code review to Closed