3 ms·

> This is a feature, not a bug. Seconded. The hard part of CLIs is discovering what is possible in the current context. You can almost take for granted that a

> This is a feature, not a bug. Seconded. The hard part of CLIs is discovering what is possible in the current context. You can almost take for granted that a GUI will do this for you. CLI not only won't, but will often fail to discuss this in the man page. While there are exceptions (eg tmux), I find most man pages are written for someone who already knows how the command works but forgot a particular detail.

cvlasdkv 6y ago
> While there are exceptions (eg tmux), I find most man pages are written for someone who already knows how the command works but forgot a particular detail. Isn't that a function of how much work is put into man pages vs. the GUI? I'd be hesitant to claim that if you took the same number of hours in writing a GUI and put it into writing better documentation that we'd be in the same place we often are with poorly documented tooling.