From: Robert Haas <rhaas@postgresql.org>
Date: Fri, 23 Mar 2012 02:09:20 +0000 (-0400)
Subject: Clarify that PQconninfoParse returns an array with all legal options.
X-Git-Tag: REL9_2_BETA1~238
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e08b4101e1daa2f4e6644330918177a10cac0aab;p=thirdparty%2Fpostgresql.git

Clarify that PQconninfoParse returns an array with all legal options.

Per discussion with Dmitriy Igrishin and Tom Lane.
---

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 72c93845beb..96064bbb0de 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1027,8 +1027,10 @@ PQconninfoOption *PQconninfoParse(const char *conninfo, char **errmsg);
       </para>
 
       <para>
-       Note that only options explicitly specified in the string will have
-       values set in the result array; no defaults are inserted.
+       All legal options will be present in the result array, but the
+       <literal>PQconninfoOption</literal> for any option not present
+       in the connection string will have <literal>val</literal> set to
+       <literal>NULL</literal>; default values are not inserted.
       </para>
 
       <para>