From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200202261811.g1QIBmC17636@candle.pha.pa.us>
Subject: Re: PostgreSQL 7.2 docs
In-Reply-To: <p051003e0b8a173934b5d@[192.168.254.205]>
To: Rich Morin <rdm@cfcl.com>
Date: Tue, 26 Feb 2002 13:11:48 -0500 (EST)
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII


Answering questions from DOSSIER creator.  Feel free to chime in.

 Rich Morin wrote:
> I'm looking into doing a set of DOSSIER volumes for 7.2 and I'd like to
> know the nature of and relationship between some of the docs.  If you
> can help, please do so.  In any case, please feel free to forward this
> note as appropriate.

OK, done.  CC'ing to docs.

> The archive .../doc/man.tar.gz contains two directories of man pages.
> Are these simply reformatted versions of sections I and II from the
> Reference Manual?

These are just the reference manual pages, formatted into Unix manual
page format, so people can do 'man insert'.

> The archive .../doc/postgres.tar.gz contains one (huge) directory of
> HTML pages.  Looking at the index.html file, it appears that many (if
> not all) of the files are are simply reformatted versions of other
> documents.  Is this the case?  Is there a subset of these pages that
> it would make sense to print up, in addition to the other documents?

Yes, postgres.tar.gz is the mega-manual, while we also distribute the
seconds separately, e.g. admin, reference, etc.

> IIRC, The 7.1 distribution contained a paper called internals.ps, but
> I don't see this in the 7.2 distribution.  Wazzup?

We removed it and put it on the developers page.  We decided it didn't
belong in the CVS or tarball.

> Finally, if there are any other documents that you would like to see
> me include in a DOSSIER volume, please let me know!

I will throw this question out to the group.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026