Message-ID: <1333692550.32606.1.camel@vanquo.pezone.net>
Subject: Re: Another review of URI for libpq, v7 submission
From: Peter Eisentraut <peter_e@gmx.net>
To: Alvaro Herrera <alvherre@commandprompt.com>
Cc: Alex <ash@commandprompt.com>, Heikki Linnakangas
	<heikki.linnakangas@enterprisedb.com>, Pg Hackers
	<pgsql-hackers@postgresql.org>
Date: Fri, 06 Apr 2012 09:09:10 +0300
In-Reply-To: <1333681634-sup-8491@alvh.no-ip.org>
References: 
 <CAAZKuFZ6d5aB8Tt-vq=xdCA4xEcLTDYK_d+G2VunpSuuqyKktA@mail.gmail.com>
	<87d38eaq3f.fsf@commandprompt.com>
	<CAAZKuFYKZbXhFyXiQOHx87Qq7MbzhN2iaqN_SFCQu3fkCV6Z7Q@mail.gmail.com>
	<87k42lsgck.fsf@commandprompt.com> <20120317145110.GA25172@gmail.com>
	<8762dyuda3.fsf@commandprompt.com> <87k42cb9dr.fsf@commandprompt.com>
	<1332868938.24269.1.camel@vanquo.pezone.net>
	<87ty19kfz0.fsf@commandprompt.com> <87pqbxk6bf.fsf@commandprompt.com>
	<1333644733.2524.0.camel@vanquo.pezone.net>
	<1333663521-sup-937@alvh.no-ip.org>
	<1333681634-sup-8491@alvh.no-ip.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Mime-Version: 1.0

On fre, 2012-04-06 at 00:25 -0300, Alvaro Herrera wrote:
> Some moments of radical thinking later, I became unhappy with the fact
> that the conninfo stuff and parameter keywords are all crammed in the
> PQconnectdbParams description.  This feels wrong to me, even more so
> after we expand it even more to add URIs to the mix.  I think it's
> better to create a separate sect1 (which I've entitled "Connection
> Strings") which explains the conninfo and URI formats as well as
> accepted keywords.  The new section is referenced from the multiple
> places that need it, without having to point to PQconnectdbParams.

Yes, it should be split out.  But the libpq chapter already has too many
tiny sect1s.  I think it should be a sect2 under "Database Connection
Control".