4 ms·
The thing is with RTFM is that it takes time. We don't all have time. So while RTFM will sometimes help, almost all the manuals lack good examples. It would be
by ElijahLynn 8y ago
The thing is with RTFM is that it takes time. We don't all have time. So while RTFM will sometimes help, almost all the manuals lack good examples. It would be much more useful if all manuals had an equally extensive examples section. Then we could say RTFE(xamples). `man awk` and `/` for `examples`, they have a great example section. `man curl` doesn't have a specific section but does have examples sprinkled throughout the options. `man kill` has zero references to `example`, yeah, probably don't need it but there are some nice `kill` tricks that could be in there.
I do read `man` pages daily, and it does get easier & faster with time. I am a pro at searching man pages, but again, most lack good, high quality examples, which would be most effective. As soon as I open a man page I press `/`, which lets me search. If I am looking for an option (e.g. -F) I search for ` -F` with the preceding space, this almost always gets you the actual option, not just mentions of it. Then I press `n` or `shift + n` to go to the next and previous results.
Also keep in mind that some apps don't have man pages, for those try `help <command>` or `info <command>`.
Another tip is that the `apropos` or `man -k|--apropos` command can search all man pages for you. Also there are hidden man pages, like `man 7 signal` instead of just `man signal` (try it). `apropos` can find those for you.
Getting faster at reading is a key part of this, I spent some time exercising my eye muscles and it does help. (Eye Q) was the name of the software I used, I plan on revisiting that again.
I also spent a lot of time reading technical books, which _only_ helps if you practice the information you learn. Otherwise it just goes in and out. You want to take knowledge and turn it into skills, by practicing. Deliberate Practice to be more specific per the book Peak by Anders Erickson (must read for all learners).
At any rate, don't be afraid to ask and use StackOverflow, we don't all have many hours to find answers, we need to be effective, that includes reading a lot, but also knowing how to search, very effectively. Search Engines are a manual in a sense.