6 Oct 2004 (updated 7 Oct 2004 at 10:28 UTC)
»
shlomif, I've had to look those options up in the wget manual
a dozen times or more, and have found them every time. You'd think I'd remember
them by now, but as I know I can RTFM why should I waste memory on it?
The only thing I'd add to async's reply is that "read the manual"
is a perfectly good response. The 'F' in RTFM is an unfortunate
consequence of people having to say "RTM" so many times it gets tedious,
and they get annoyed, and they become rude. That is unfortunate, and
a newbie who asks his first question doesn't deserve to be chastised for
previous questions asked by other newbies. However, you should know better
than to act like a newbie and should RTFM.
Update: AlanHorkan, I agree that RTFM is rude and is
unhelpful if your manual is no good, which is true for many projects.
But if you've spent considerable time writing or improving the documentation
then you have no desire to paraphrase it over and over for the rest of the
project's lifetime because someone is too lazy to read the man page or to
search the mailing list for themselves. I wrote it carefully and accurately
once, why do so again?
I say this as a documenter and someone who does take time to explain
things to users, on my own projects and on others'. I don't think I've ever
said "RTFM" but I have frequently said "Have you read the manual/FAQ? See this
<link>" rather than repeat myself. Often I'll search the mailing list to
find my previous responses and give them URLs to those responses, because I
know from experience that trying to find answers on mailing lists can be hard
if you don't know the words or phrases to search for. I do this because I
realise that newbie number 23 is not to blame for the previous 22 newbies,
so I won't be rude to them, but I will still refer them to the canonical docs
rather than reiterate. This is even more relevant if answering the question
directly would involve checking the docs myself to confirm the answer!
I stand by my statement that "RTM" is a reasonable response, and believe
it does the questioner no harm to learn how to find their own answers.