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: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e08b4101e1daa2f4e6644330918177a10cac0aab;p=postgresql

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 72c93845be..96064bbb0d 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>