I hate RTFM. It stands for “Read the $%#%@&* manual” and it is a term used to insult people who ask a question that others think is obviously answered in the manual. It has many aliases (‘man foo’ is my personal annoyance), but ultimately it comes down to “you should have to read a poorly written document because I had to”. While I appreciate the efforts put into writing manuals, they are often written by engineers and not writers. This results in dense, difficult to understand, text. Here’s an example of the grep man page:
SYNOPSIS
grep [options] PATTERN [FILE...]
grep [options] [-e PATTERN | -f FILE] [FILE...]
DESCRIPTION
Grep searches the named input FILEs (or standard input if no files are named, or the file name – is given) for lines containing a match to the given PATTERN. By default, grep prints the matching lines. In addition, two variant programs egrep and fgrep are available. Egrep is the same as grep -E. Fgrep is the same as grep -F.
To someone who uses grep, it makes sense. If I wanted to search for the text “hello” in the files in the current directory, I’d use ‘grep hello ./*’. But reading the above man page, this is not so obvious. The description references FILE, but in the synopsis, there are two “FILE” entries. Which is the correct FILE? Both? Also, there are Options in both synopsis templates, but then in the second they list -e and -f separately. Are these different then the other options? Again, as a user of grep, I understand what it’s saying, not because I read the man page, but because I found examples of how to write a good grep string. But in the man page, there are no examples, just raw data on how to use grep. The equivalent for a doctor would be to hand an intern a scalpel and say this is the tool you use to cut a patient open and then calling them a doctor. It doesn’t tell them how to use the tool; it doesn’t give them the knowledge of how to cut. That’s what most of the man pages do, they show you the tool without giving you the techniques for using it.
So when I see people repost with RTFM, it frustrates me. In part because it is just rude to chastise a person for asking a question, but also because it assumes that everyone has the same mental processing that you do. In the future, please follow the old advice of “if you don’t have anything nice to say…”. At the least, if you are going to reply, give an example so that people can learn.