Received: from localhost (IDENT:root@hectic-2.jpl.nasa.gov [128.149.68.204]) by hub.org (8.9.3/8.9.3) with ESMTP id BAA07712 for ; Thu, 20 May 1999 01:20:05 -0400 (EDT) (envelope-from lockhart@alumni.caltech.edu) Received: from alumni.caltech.edu (lockhart@localhost [127.0.0.1]) by localhost (8.8.7/8.8.7) with ESMTP id FAA25706; Thu, 20 May 1999 05:21:19 GMT Sender: lockhart@hub.org Message-ID: <37439BCF.AF1D5863@alumni.caltech.edu> Date: Thu, 20 May 1999 05:21:19 +0000 From: Thomas Lockhart X-Mailer: Mozilla 4.51 [en] (X11; I; Linux 2.0.36 i686) X-Accept-Language: en MIME-Version: 1.0 To: Tom Lane CC: Bruce Momjian , Postgres Documentation List Subject: Re: [HACKERS] Last call for docs References: <1900.927174271@sss.pgh.pa.us> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit > > I can freeze docs in stages; which docs are > > you planning on touching? > I have committed all the SGML files I plan to touch except for > xoper.sgml, libpq.sgml, and possibly start-ag.sgml. > I had intended to try to write some things about troubleshooting > postmaster startup failures (out of semaphores, etc) --- there is some > material in the FAQ but almost none in the SGML files. I could expand > the very small "troubleshooting" chapter in start-ag.sgml, but I wonder > whether you have a better idea. Uh, sounds like I'd better have an idea, huh? :) Hold off for an hour or so while I commit my current changes, which include a bit of a reorg on the Admin Guide. There will be a separate file, trouble.sgml, which is the troubleshooting chapter. A bit more info in it (mostly about pg_options and log messages). > I also want to make some improvements in the main FAQ document and > in FAQ_HPUX, but I fear I am *still* confused about exactly which > files represent the master copies. Bruce? > Finally, the plain-text FAQ_CVS document is now sadly behind > cvs.sgml, and needs to be updated. Is there a better way to > update it than manually extracting and reformatting plain text > from cvs.sgml? istm that there is not need for a flat file FAQ_CVS, and that our web site and our html and hardcopy docs can do a better job of showing that info. I had started cvs.sgml from FAQ_CVS, adding some info about CVSup culled from mailing list messages. Not done yet, but if FAQ_CVS has not been updated recently it is bound to be more complete since afaik FAQ_CVS did not even mention CVSup. I'm planning on cleaning up some of the markup in cvs.sgml and deep-sixing the CVS_FAQ. - Thomas -- Thomas Lockhart lockhart@alumni.caltech.edu South Pasadena, California