3 ms·
> The Linux man pages are upside down. Examples don't come till the very end, if at all. man pages are meant to be a full reference, not a quick tutorial. To
by divbzero 6y ago
> The Linux man pages are upside down. Examples don't come till the very end, if at all.
man pages are meant to be a full reference, not a quick tutorial.
To get the quick tutorial others have already mentioned cheat.sh [1] and tldr pages [2] is another good resource.
[1]: https://cheat.sh/ https://cheat.sh/
[2]: https://tldr.sh/ https://tldr.sh/
- keyle 6y ago+1 for tldr.sh. It's fantastic, I use it all the time, sometimes randomly for stuff I haven't got installed to find out whether I should homebrew it or not. Unlike man pages, tldr can search and find docs for stuff you don't currently have installed. And it's fun to read. It's how man pages should be written, at least have a tl;dr before boring you to death.
- jai_ 6y agoThey can still be both! You can flip the general structure of man pages to be examples first while still having all the complete reference material after.
- thotsBgone 6y agoOr just use tldr, which already does what you want.
- arp242 6y agoThe downside of that is that searching for something would mean I'd first get the examples, and then the reference.
- vram22 6y ago> man pages are meant to be a full reference, not a quick tutorial. Yes, and for both quick and longer tutorials, there are also these things called books and courses - both of which are available in hard copy / offline as well as soft copy / online versions from many years now :) Many of us grew up using them and investing in them for our careers ...
- bostonvaulter2 6y agoBig +1 for tldr from me. And the commands are effectively a wiki (or maybe it's stored in git). Anyway you can contribute to them.