Acid rain is real. So is quicksand. Either of them being common and severe hazards experienced across the entire US (and maybe elsewhere, I don't know what the rest of you were taught in gradeschool), not really.
Real acid rain causes mass ecological damage through relatively subtle increases in acidity over several exposures. The way we learned about it in school, whether they meant to or not, came across like concentrated hydrochloric acid was going to rain from the skies and melt human flesh on contact.
There are exactly three kinds of manpages:
I will take 1 any day over 2 or 3. Sometimes I even need 1, so I'm grateful for them.
But holy goddamn is it awful when I just want to use a command for aguably its most common use case and the flag or option for that is lost in a crowd of 30 other switches or buried under some modal subcommand.
grep
helps if you already know the switch, which isn't always.You could argue commands like this don't have "arguably most common usecases", so manpages should be completely neutral on singling out examples. But I think the existence of tl;dr is the counterargument.
Tangent complaint: I thought the Unix philosophy was "do one thing, and do it well"? Why then do so many of these shell commands have a billion options? Mostly /s but sometimes it's flustering.