DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type:content-transfer-encoding;
	b=SnrTnkagGyUSISFX+z6hoYh65iJTdX7iRx6M5ivKz7HtrzTkqqJLW69ckn9yKOjrz9
	ogim1FguhnLjgsCfC6tzjn520QTwJzZ2EYXkTAPxtJqT1XkKRFnw07CLiRyD1VkNNTWI
	xtbtcngZ6Q4xx2NDU3xBHZyCVu55xq3YhEtzw=
MIME-Version: 1.0
In-Reply-To: <bddc86151002101443t69d6e2e7rd6c76ea6287e6061@mail.gmail.com>
References: <bddc86151002101443t69d6e2e7rd6c76ea6287e6061@mail.gmail.com>
Date: Fri, 12 Feb 2010 10:57:53 +0900
Message-ID: <3f0b79eb1002111757y3d11102n7fdfcee8f332f6d4@mail.gmail.com>
Subject: Re: Confusing link in streaming replication section
From: Fujii Masao <masao.fujii@gmail.com>
To: Thom Brown <thombrown@gmail.com>
Cc: pgsql-docs@postgresql.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Thu, Feb 11, 2010 at 7:43 AM, Thom Brown <thombrown@gmail.com> wrote:
> I'm looking at the latest docs for PostgreSQL 9.0
> (http://developer.postgresql.org/pgdocs/postgres/streaming-replication.ht=
ml)
> and under the description of primary_conninfo, there's a link to
> section 30.1 (http://developer.postgresql.org/pgdocs/postgres/libpq-conne=
ct.html)
> which is supposed to describe the string format. =A0Having looked at
> that page, however, it's not crystal clear what is meant by this
> string format. =A0One can only assume it's referring to the
> PQconnectdbParams section and the keywords that can be used for it,
> which would also apply to a connection string, but there's no mention
> of a "format" on that page.

Thanks for the report!

Though at first PQconnectdb() had been linked by the SR doc, instead
PQconnectdbParams() seems to have been linked wrongly when it was committed=
.
How about changing the link so as to point to PQconnectdb() again? Or
copy-pasting the following description from PQconnectdb() to the SR doc?

-----------
The passed string can be empty to use all default parameters, or it can
contain one or more parameter settings separated by whitespace. Each
parameter setting is in the form keyword =3D value. Spaces around the equal
sign are optional. To write an empty value, or a value containing spaces,
surround it with single quotes, e.g., keyword =3D 'a value'. Single quotes
and backslashes within the value must be escaped with a backslash,
i.e., \' and \\.

The currently recognized parameter key words are the same as above.
-----------

Regards,

--=20
Fujii Masao
NIPPON TELEGRAPH AND TELEPHONE CORPORATION
NTT Open Source Software Center