Thread: Re: PostgreSQL 7.2 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
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
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