Re: PostgreSQL 7.2 docs - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: PostgreSQL 7.2 docs
Date
Msg-id 200202261811.g1QIBmC17636@candle.pha.pa.us
Whole thread Raw
Responses Re: PostgreSQL 7.2 docs  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
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

pgsql-docs by date:

Previous
From: Derrell.Lipman@UnwiredUniverse.com
Date:
Subject: Re: "man psql" \set documentation error
Next
From: Peter Eisentraut
Date:
Subject: Re: PostgreSQL 7.2 docs