From e08b4101e1daa2f4e6644330918177a10cac0aab Mon Sep 17 00:00:00 2001
From: Robert Haas <rhaas@postgresql.org>
Date: Thu, 22 Mar 2012 22:09:20 -0400
Subject: [PATCH] Clarify that PQconninfoParse returns an array with all legal
 options.

Per discussion with Dmitriy Igrishin and Tom Lane.
---
 doc/src/sgml/libpq.sgml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

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>
-- 
2.40.0