Thread: Re: PostgreSQL 7.2 docs

Re: PostgreSQL 7.2 docs

From
Bruce Momjian
Date:
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

Re: PostgreSQL 7.2 docs

From
Peter Eisentraut
Date:
Bruce Momjian writes:

>  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.

There's an attempt to explain this here:

http://www.us.postgresql.org/users-lounge/docs/7.2/postgres/docguide.html

> > 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?

Sections I, II, and III.  In other words, there's nothing in the man pages
that you don't see in the HTML version or in any other format.

> > 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?

It is in the nature of the way we maintain and format our documentation
that any format can be viewed as a reformatted version of another format.
See also under the link posted above.

> > Is there a subset of these pages that
> > it would make sense to print up, in addition to the other documents?

All of these pages are theoretically worth printing.  Not sure what "other
documents" you are referring to.  If there are any, then there's something
wrong.

--
Peter Eisentraut   peter_e@gmx.net


Re: PostgreSQL 7.2 docs

From
Rich Morin
Date:
At 5:38 PM -0500 2/26/02, Peter Eisentraut wrote:
>It is in the nature of the way we maintain and format our documentation
>that any format can be viewed as a reformatted version of another format.

So, if I'm printing the PostgreSQL "books", FAQs, and the "internals.ps"
file, I've got things pretty well covered.

>All of these pages are theoretically worth printing.  Not sure what "other
>documents" you are referring to.  If there are any, then there's something
>wrong.

There might be some (e.g., historic) papers that aren't in the distro for
some reason, but would be interesting for some folks to have.  Can't hurt
to ask...

-r
--
email: rdm@cfcl.com; phone: +1 650-873-7841
http://www.cfcl.com/rdm    - my home page, resume, etc.
http://www.cfcl.com/Meta   - The FreeBSD Browser, Meta Project, etc.
http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series
http://www.ptf.com/tdc     - Prime Time Freeware's Darwin Collection