Re: CVS branch management (was Re: A problem with new

On Wednesday 28 November 2001 03:48 pm, Peter Eisentraut wrote:
> Bruce Momjian writes:
> > I added these to the developer's FAQ.  The seem a little detailed for
> > the main docs.

> I was always under the impression that a FAQ was an *abbreviated* version
> of some of the main docs.  As in, FAQ = frequently asked questions, main
> docs = all possible questions.  So this reasoning doesn't make sense to
> me.

FAQ = questions from users on how the thing works, with answers gleaned 
fromthe developer's mailing list (this has been the definition for at least 
ten years -- or more -- but, as I've only been internet-literate for a mere 
ten years, I wouldn't have first-hand knowledge of accepted practice prior to 
1991.  As I ran a C-News site beginning in 1991, I got up to speed on the 
Jargon fairly quickly.  Speaking of Jargon.... according to Jargoogle, FAQ is 
'officially':
"FAQ /F-A-Q/ or /fak/ n. 

[Usenet] 1. A Frequently Asked Question. 2. A compendium of accumulated lore, 
posted periodically to high-volume newsgroups in an attempt to forestall such 
questions. Some people prefer the term `FAQ list' or `FAQL' /fa'kl/, 
reserving `FAQ' for sense 1. 

This lexicon itself serves as a good example of a collection of one kind of 
lore, although it is far too big for a regular FAQ posting. Examples: "What 
is the proper type of NULL?" and "What's that funny name for the # 
character?" are both Frequently Asked Questions. Several FAQs refer readers 
to this file. "

So, while Bruce isn't doing the regular list posting of the dev FAQ, it still 
is a compendium in sense 2....)

docs = our take on the questions we think will be asked about how the thing 
works, plus any FAQL's necessary.

While it may seem to be hairsplitting, the traditional FAQ list is just 
exactly what Bruce has developed in the developers FAQ -- these are answers 
that currently don't fit in our docs in an organized fashion.  Now, maybe if 
the docs were modified to include this information... (hint, hint)....
-- 
Lamar Owen
WGCR Internet Radio
1 Peter 4:11