pgsql: Doc: clarify behavior of PQconnectdbParams().

Doc: clarify behavior of PQconnectdbParams().

The documentation omitted the critical tidbit that a keyword-array entry
is simply ignored if its corresponding value-array entry is NULL or an
empty string; it will *not* override any previously-obtained value for
the parameter. (See conninfo_array_parse().) I'd supposed that would
force the setting back to default, which is what led me into bug #16746;
but it doesn't.

While here, I couldn't resist the temptation to do some copy-editing,
both in the description of PQconnectdbParams() and in the section
about connection URI syntax.

Discussion: https://postgr.es/m/[email protected]

Branch
------
REL_10_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/bc3b4c8ca1524b46204a380619e4c778ff5eb7cb

Modified Files
--------------
doc/src/sgml/libpq.sgml | 101 +++++++++++++++++++++++++++---------------------
1 file changed, 57 insertions(+), 44 deletions(-)