From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200306130218.h5D2IFV28395@candle.pha.pa.us>
Subject: Re: Runtime Configuration Docs
In-Reply-To: <22628.1055470340@sss.pgh.pa.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Date: Thu, 12 Jun 2003 22:18:15 -0400 (EDT)
Cc: josh@agliodbs.com, pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII

Tom Lane wrote:
> Josh Berkus <josh@agliodbs.com> writes:
> > 1) Can someone check my SGML?   I am not familiar with Docbook, and I did t=
> > his=20
> > using a simple text editor (there being no Docbook Gui that I could find).
> > 2) If it parses, can someone recommend a docbook-to-html tool so I can read=
> > =20
> > the darn thing?  I tried one off freshmeat but it didn't seem to work.
> 
> Given that you've installed all the tools mentioned in the docs section
> on how to build the docs, a quick "make" in doc/src/sgml should do the
> trick for both.
> 
> I fooled around making this happen on my Red Hat 8.0 box just recently.
> My recollection is that all the tools were installed already (though I
> may have made a point of selecting them when I installed the distro) ...
> but I had to tweak a couple of symlinks that were pointing to the wrong
> places before Postgres' configure would agree that I had a working doc
> toolchain.
> 
> > 3) two new options, ADD_MISSING_FROM and HAS_RENDEZVOUS have been left blan=
> > k.=20=20=20
> > Who will be documenting those?  I can do the first, if wanted.
> 
> The docs for the former should have been in the commit that implemented
> it ... how old is the checkout you started from?  As for the latter, I
> think Bruce is presently claiming we don't need a GUC variable at all
> for it.

I got the email from Chris stating you do need unique service names to
allow two different postmasters to be seen via Rendezvous, so I do think
it is necessary --- I just haven't gotten to it --- and if not set, it
will default to the hostname, and people using two postmasters will have
to set it on at least on of them to be seen.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073