Doc: remove misleading claim in documentation of PQreset().
authorTom Lane <[email protected]>
Fri, 22 Jan 2021 16:29:43 +0000 (11:29 -0500)
committerTom Lane <[email protected]>
Fri, 22 Jan 2021 16:30:06 +0000 (11:30 -0500)
This text claimed that the reconnection would occur "to the same
server", but there is no such guarantee in the code, nor would
insisting on that be an improvement.

Back-patch to v10 where multi-host connection strings were added.

Discussion: https://postgr.es/m/1095901.1611268376@sss.pgh.pa.us

doc/src/sgml/libpq.sgml

index 9f92c98c77a62eda9e091e4d5c525c7a43cf717a..34c0bc816c5d7d7e49eb7399ce765f2b3f7d472b 100644 (file)
@@ -645,8 +645,8 @@ void PQreset(PGconn *conn);
 
       <para>
        This function will close the connection
-       to the server and attempt to  reestablish  a  new
-       connection to the same server, using all the same
+       to the server and attempt to establish a new
+       connection, using all the same
        parameters previously used.  This might be useful for
        error recovery if a working connection is lost.
       </para>
@@ -669,7 +669,7 @@ PostgresPollingStatusType PQresetPoll(PGconn *conn);
 
       <para>
        These functions will close the connection to the server and attempt to
-       reestablish a new connection to the same server, using all the same
+       establish a new connection, using all the same
        parameters previously used. This can be useful for error recovery if a
        working connection is lost. They differ from <function>PQreset</function> (above) in that they
        act in a nonblocking manner. These functions suffer from the same