Comment by teamhappy
8 years ago
https://man.openbsd.org/tar#EXAMPLES
What they're covering is just the examples section of a traditional man page. What makes you think people wouldn't merge these?
8 years ago
https://man.openbsd.org/tar#EXAMPLES
What they're covering is just the examples section of a traditional man page. What makes you think people wouldn't merge these?
It's a fundamentally different goal / structure.
`man` documents every last flag, and I generally use it for a command I know decently but need to dig into particulars. It goes to a scrollable page like `less` which is important bc it's total size spans several pages.
`tldr` is shows the 3-4 most common use cases for a command, and puts it right to stdout more like `cat` so you can refer to it as you type along. I'd generally use this for a command I do not know so well.
And why could that not go in the example section of the manual?