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