From: Bruce Momjian <maillist@candle.pha.pa.us>
Message-Id: <199807151703.NAA13739@candle.pha.pa.us>
Subject: Re: [DOCS] Re: [INTERFACES] libpq & user
In-Reply-To: <35ACD98B.8CD3F2CB@apop-server.alumni.caltech.edu> from "Thomas
	G. Lockhart" at "Jul 15, 1998  4:32:11 pm"
To: lockhart@alumnus.caltech.edu (Thomas G. Lockhart)
Date: Wed, 15 Jul 1998 13:03:04 -0400 (EDT)
Cc: rknop@mh1.lbl.gov, herouth@oumail.openu.ac.il,
	pgsql-interfaces@postgreSQL.org, docs@postgreSQL.org
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

> > > In the psql source code, they set the user by setting the PGUSER
> > > environment variable. The source of the PQsetdb function states that the
> > > following environment variables are accepted (although this is not
> > > documented - at least not in my old 6.2.1 version):
> > 
> > Aha!  Thank you, that was the secret.  I do not believe that these
> > environment variables are documented in 6.3.1 either -- at least, I 
> > didn't find them.  I tried USER, but not PGUSER.
> 
> These environment variables are documented in the libpq section of the
> new v6.3.x html/hardcopy documents. However, PGUSER was omitted. Would
> someone like to add it to the sgml sources? It is in
>   doc/src/sgml/libpq.sgml
> 
> Look for PGHOST, put in some text in the appropriate area, and send a
> patch. It's that easy! (Wasn't that a Ross Perot quote?...)

Woh, hold on big doggy.  (western saying)

Someone is in the process of converting the 6.3.2 src/man/* pages to
sgml.

We need to continue making changes only to the src/man/* pages until
they are converted all to sgml, and then any changes made to src/man/*
from 6.3.2->current are merged into the sgml source.  At that point, we
switch over to making changes only to the sgml files, and generate
src/man/* before each release.  We need to move to sgml, but we can't
start making changes in two places.  I have added to src/man/libpq.3:

\(bu
.B PGUSER
sets the username use to connect to the database and for authentication.


Is this OK?

-- 
Bruce Momjian                          |  830 Blythe Avenue
maillist@candle.pha.pa.us              |  Drexel Hill, Pennsylvania 19026
  +  If your life is a hard drive,     |  (610) 353-9879(w)
  +  Christ can be your backup.        |  (610) 853-3000(h)