aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2014-04-19 08:41:51 -0400
committerBruce Momjian <bruce@momjian.us>2014-04-19 08:41:51 -0400
commit13ecb822e8da5668133b706474c25bc908ae370a (patch)
treebf80faa006fbf9b60cbdb245bcecd9c9a464f099 /doc/src
parent66b1084e2ccf1f5b8cb57ebb41f54f76850a2b5d (diff)
downloadpostgresql-13ecb822e8da5668133b706474c25bc908ae370a.tar.gz
postgresql-13ecb822e8da5668133b706474c25bc908ae370a.zip
libpq: have PQconnectdbParams() and PQpingParams accept "" as default
Previously, these functions treated "" optin values as defaults in some ways, but not in others, like when comparing to .pgpass. Also, add documentation to clarify that now "" and NULL use defaults, like PQsetdbLogin() has always done. BACKWARD INCOMPATIBILITY Patch by Adrian Vondendriesch, docs by me Report by Jeff Janes
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/libpq.sgml12
1 files changed, 6 insertions, 6 deletions
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index be0d602508d..1f0975ada68 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -131,15 +131,15 @@ PGconn *PQconnectdbParams(const char * const *keywords,
<para>
The passed arrays can be empty to use all default parameters, or can
contain one or more parameter settings. They should be matched in length.
- Processing will stop with the last non-<symbol>NULL</symbol> element
- of the <literal>keywords</literal> array.
+ Processing will stop at the first <symbol>NULL</symbol> element
+ in the <literal>keywords</literal> array.
</para>
<para>
- If any parameter is unspecified, then the corresponding
- environment variable (see <xref linkend="libpq-envars">)
- is checked. If the environment variable is not set either,
- then the indicated built-in defaults are used.
+ If any parameter is NULL or an emptry string, the corresponding
+ environment variable (see <xref linkend="libpq-envars">) is checked.
+ If the environment variable is not set either, then the indicated
+ built-in defaults are used.
</para>
<para>