Re: PostgreSQL 7.2 docs

From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: Rich Morin <rdm(at)cfcl(dot)com>
Cc: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: PostgreSQL 7.2 docs
Date: 2002-02-26 18:11:48
Message-ID: 200202261811.g1QIBmC17636@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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(at)candle(dot)pha(dot)pa(dot)us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2002-02-26 22:38:08 Re: PostgreSQL 7.2 docs
Previous Message Derrell.Lipman 2002-02-26 03:34:18 Re: "man psql" \set documentation error