3 ms·
From my experience some manpages glaringly miss examples or explanations. Hint: all manpages that you don't need to move down for more contents probably fall in
by markus_zhang 3y ago
From my experience some manpages glaringly miss examples or explanations. Hint: all manpages that you don't need to move down for more contents probably fall into this catalog.
I completely agree that they are only useful if you know what you are looking for, and nothing else.
Although I'm still a newbie, but I'll never tell a complete newbie to RTFM, considering there is not many high quality manual out there. Actually most hottie open source tools we happened to introduce into our workflow have half-assed doc at most. I'll just teach him to Google stuffs efficiently and let himself figure out the rest. Sometimes it's surprisingly difficult to know what exactly to put into that search box.
I'm not a hacker. I'll never be even close to Ritchie, Carmack, whoever write state of art malwares. I know the pain.
- JdeBP 3y agoToo many people think that GNU manual pages are what all manual pages look like. Not everyone has the GNU tradition of telling you to switch to a different doco format for better man pages. (-: The thing to remember is that for many systems there are both guides and handbooks, tutorial style doco, in addition to the reference doco, the manual pages. Linux-based operating systems come up a bit short in comparison to the old commercial Unices which had specific user guides, and in comparison to the BSDs, all of which have handbooks. Even Debian only has an admininstrators' guide, not a users' guide. But The Linux Documentation Project is oft forgotten. It's stale. It's unfashionable. It's oddly chock full of how-tos for things that one wouldn't dream of wanting to do this century. But it also has longer format stuff, and it's still there. Consider the _Introduction To Linux_ for example: * https://tldp.org/LDP/intro-linux/html/sect_05_01.html https://tldp.org/LDP/intro-linux/html/sect_05_01.html Or the _Linux Command-Line Tools Summary_: * https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/working-files-folders.html https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/working-fi... Or the _Bash Guide for Beginners_: * https://tldp.org/LDP/Bash-Beginners-Guide/html/sect_04_03.html https://tldp.org/LDP/Bash-Beginners-Guide/html/sect_04_03.ht...
- markus_zhang 3y agoThanks! I did find tldp extremely helpful and entertaining to read sometimes.