Would you agree that man page with good example section of common use cases would better serve the purpose or do you think there has to be separate tool to show only a short summary of the manual?
For most programs, manpage or -h is more than a whole screen of text… 99% of the time i’m just looking for a common usuage example in one line. Tldr provides that very quickly
I (not who you are asking) responded to your original comment about cheat.sh, but feot kinda fitting here too,
in the case if cheat.sh it does so much more than the manpages that I would definitely say that manpages should keep doing it’s thing, because these tools strive to do more, which both makes them valuable and makes the manpages the right tool for it’s thing.
I think most people use only the main functions of the program and not all of them
Would you agree that man page with good example section of common use cases would better serve the purpose or do you think there has to be separate tool to show only a short summary of the manual?
I agree that the first option is better because it doesn’t need the support of a third party.
For most programs, manpage or -h is more than a whole screen of text… 99% of the time i’m just looking for a common usuage example in one line. Tldr provides that very quickly
I (not who you are asking) responded to your original comment about cheat.sh, but feot kinda fitting here too,
in the case if cheat.sh it does so much more than the manpages that I would definitely say that manpages should keep doing it’s thing, because these tools strive to do more, which both makes them valuable and makes the manpages the right tool for it’s thing.