Re:The Fall of Stack Overflow
by Culonavirus on Tuesday July 25, 2023 @01:53AM
(#36858470)
Here's a question maybe someone can answer for me, or maybe I'm just stupid and other people don't need it, but...
What's up with the "man Y" aversion towards the usage of examples in the man pages? I don't expect some behemoth like ffmpeg to have a billion examples in the man files, but damn, every other reasonably sized CLI app would be so much easier to use, if you had just a dozen or two of examples at the end of the man file.
tldr pages do exactly this.
bless you - I had no idea this existed!
brew install tldr
tldr ffmpeg
`man` is "a documentation". It turns out there's more than one type of documentation, but lots of man-page writers didn't get the memo.
Case in point: https://stackoverflow.com/q/19622198