Sam said:
oh come on... an FAQ about a newsgroup and the only mention of the
topic of discussion is hinted at in question 19.1.
On the one hand, you're right, it's unfair to expect someone to
find that fact hidden there. And while the FAQ list was (to be
honest) originally written with the expectation that it be read
cover-to-cover, this too is an unrealistic and unreasonable
requirement. In fact, whenever someone scolds you for not having
noticed some salient fact hiding in a disused footnote of the
FAQ list behind a link marked "beware of the leopard", *you* can
scold *them* for not having noticed this sentence sitting right
there in the introduction:
This is a large and heavy document, so don't assume that
everyone on the net has managed to read all of it in
detail, and please don't roll it up and thwack people
over the head with it just because they missed their
answer in it.
it should be the very first sentence to the FAQ.
On the other hand, though, there's a fallacy here. At other
times (i.e. when we've just emerged bloodied from yet another
horribly tedious rehash of some other tired old topic), it has
seemed like the very first sentence of the FAQ list really needed
to be "What's the story with null pointers?" or "How do I read
single characters without waiting for the RETURN key?" or "What's
wrong with void(main)?" or "Why doesn't i++-++i do what I expect?".
Comp.lang.c's FAQ list goes back quite a ways. Back when I first
started constructing it, FAQ lists covered, well, questions that
were frequently asked in a newsgroup; they did not attempt to
be comprehensive introductions to the newsgroup (or the topic),
or to enumerate the group's charter or posting guidelines or
netiquette or whatnot. And I've been pretty stubborn and/or lazy
(in the face of admittedly quite a few requests) to put that
stuff in, feeling that it belonged in a separate "Welcome to..."
document which, in the fullness to time, Billy Chambless was kind
enough to write and James has been kind enough to keep posting.
With that said, however, I do intend to add a new section 21
dedicated solely to comp.lang.c netiquette issues. (Among other
things, for better or worse, questions like "What's the group's
charter?" and "What are the posting guidelines?" and especially
"Why is everyone beating me up for posting a perfectly ordinary
question?" now *are* Frequently Asked here, sometimes seemingly
more frequently than the real questions we ought to be
discussing.) I almost wrote that new section a couple of months
ago, but I decided that completing the rest of the long-delayed
improvements ought to come first.
Steve Summit
(e-mail address removed)