Google Groups no longer supports new Usenet posts or subscriptions. Historical content remains viewable.
Dismiss

Announcing the C++ FAQ (Abridged Edition)

1 view
Skip to first unread message

Greg Herlihy

unread,
Jan 2, 2009, 5:28:14 AM1/2/09
to
One of the benefits for a newsgroup to have a list of Frequently Asked
Questions (FAQ) and their answers is to discourage individuals from
posting the same, basic questions that have already been answered in
the newsgroup umpteen times before.

Yet, one of the attendant risks posed by maintaing a FAQ, is to wind
up with a FAQ that answers too many questions (including questions
that may not be that frequently asked, but do happen to touch upon a
pet interest of the FAQ's author). Furthermore, pointing first-time
posters to a FAQ that answers an enormous number of questions - is
practically that same as telling those posters that an encyclopedic
knowledge of the newsgroup topic is a prerequisite for posting at
all.

Of course, it's hard to say whether the current C++ FAQ has avoided
the problem of becoming too large, and that the current FAQ does in
fact answer just the "right " number of C++ related questions.
Nevertheless, there is reason to be a little skeptical. For example,
is the only thing keeping this newsgroup from being overrun by posts
from SmallTalk programmers learning C++ is the section in the current C
++ FAQ devoted to this demographic? Perhaps, but personally, I'm not
so sure.

In any event, I think that heated (and unproductive) debate on this
question can be easily be avoided by the creation of a second, C++ FAQ
- an "abridged" version. This abridged version would contain only
those C++ questions that really are frequently asked, and exclude all
other questions. Posters to this newgroup would first check whether
this abridged FAQ answered their question (and I estimate that in 99%
of the time, it would), before having to consult the current C++ FAQ.

So, I took it upon myself to create this abridged C++ FAQ. Originally,
I expected to wind up with a FAQ with half the number of questions as
the current one. But as I slaved away for months, toiling tirelessly
in complete obscurity, I found myself whittling the number of
questions down and down further: first to one quarter, then to one
eight, and on to one sixteenth the number of questions of the original
C++ FAQ. And I kept whittling the number down further. And although it
is theoretically possible to reduce the number of questions that I did
wind up with - still futher, I am nonetheless convinced that the two
questions that remain in abridged C++ FAQ, are the two (and the only
questions) that must be in this FAQ

So, I am delighted to present:

The List of C++ Frequently Asked Questions (Abridged Edition)

copyright 2009 Greg Herlihy [add more legalese here to suit
one's taste]


Q. My C++ program does not compile, what is the problem?

A. You are missing a "typename" in the right spot.

Q. Great, adding the "typename" seemed to work. But now I have a a
different error when I try to compile. What is wrong this time?

A. You are missing a "::template" in the right spot.

I think that about covers it. :-)

Greg

asm23

unread,
Jan 2, 2009, 7:56:23 AM1/2/09
to
Hi, Greg.
Thanks for your effort!
Sounds interesting, but where is the abridged FAQ? Can you give the links?

joe...@gmail.com

unread,
Jan 2, 2009, 9:01:28 AM1/2/09
to

> > So, I am delighted to present:
>
> >         The List of C++ Frequently Asked Questions (Abridged Edition)
>
> >         copyright 2009 Greg Herlihy [add more legalese here to suit
> > one's taste]
>
> > Q. My C++ program does not compile, what is the problem?
>
> > A. You are missing a "typename" in the right spot.
>
> > Q. Great, adding the "typename" seemed to work. But now I have a a
> > different error when I try to compile. What is wrong this time?
>
> > A. You are missing a "::template" in the right spot.
>
> > I think that about covers it. :-)
>
> > Greg
>
> Hi, Greg.
> Thanks for your effort!
> Sounds interesting, but where is the abridged FAQ? Can you give the links?

Maybe there should be a FAQ for "reading" first :-)

Daniel T.

unread,
Jan 2, 2009, 9:24:16 AM1/2/09
to
In article
<5d652814-0a8f-4536...@a29g2000pra.googlegroups.com>,
Greg Herlihy <gre...@mac.com> wrote:

A question about circular includes MUST be in any FAQ that calls itself
such.

--
Perfection is achieved, not when there is nothing more to add,
but when there is nothing left to take away.
-- Antoine de Saint-Exupery

Greg Herlihy

unread,
Jan 2, 2009, 9:34:38 AM1/2/09
to
On Jan 2, 6:24 am, "Daniel T." <danie...@earthlink.net> wrote:
> In article
> <5d652814-0a8f-4536-bf1d-7bd35af1a...@a29g2000pra.googlegroups.com>,

>  Greg Herlihy <gre...@mac.com> wrote:
>
> A question about circular includes MUST be in any FAQ that calls itself
> such.

I would add only "... and is meant to be taken seriously." :-)

Greg

gw7...@aol.com

unread,
Jan 2, 2009, 10:20:40 AM1/2/09
to
On 2 Jan, 10:28, Greg Herlihy <gre...@mac.com> wrote:
> One of the benefits for a newsgroup to have a list of Frequently Asked
> Questions (FAQ) and their answers is to discourage individuals from
> posting the same, basic questions that have already been answered in
> the newsgroup umpteen times before.

Part of the problem is that the FAQ is what Douglas Adams calls a
"recipriversexcluson". If the FAQ is working properly, then any
question which is in the FAQ will never be asked, and so should be
taken out of the FAQ on its next update.

David Connet

unread,
Jan 2, 2009, 12:23:54 PM1/2/09
to
"Daniel T." <dani...@earthlink.net> wrote in news:daniel_t-
A62F91.092...@earthlink.vsrv-sjc.supernews.net:

I guess that would be:
Q: What do I do when header A needs header B, and B needs A?
A: See the FAQ (Abridged Edition).

Dave Connet

red floyd

unread,
Jan 2, 2009, 3:04:54 PM1/2/09
to

So the FAQ is equivalent to the set of all sets that do not contain
themselves?

Juha Nieminen

unread,
Jan 3, 2009, 6:26:36 AM1/3/09
to
David Connet wrote:
> I guess that would be:
> Q: What do I do when header A needs header B, and B needs A?
> A: See the FAQ (Abridged Edition).

Wouldn't it more closely match something like this:

14. What do I do when header A needs header B, and B needs A?
A: See question 37.

...

37. What do I do when header A needs header B, and B needs A?
A: See question 14.

jason.c...@gmail.com

unread,
Jan 3, 2009, 6:51:03 AM1/3/09
to


:-) Maybe switch the A's and B's in #37, though.

Jason

0 new messages