diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2021-01-22 11:29:43 -0500 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2021-01-22 11:29:43 -0500 |
| commit | ab66645628d38a7047996b294b213f3048f7ef9b (patch) | |
| tree | 1061bb7245afaf4535e444a980fc56d1a924840b | |
| parent | 0a9ae44288d122c12aa0862b032ae892942da452 (diff) | |
| download | postgresql-ab66645628d38a7047996b294b213f3048f7ef9b.tar.gz postgresql-ab66645628d38a7047996b294b213f3048f7ef9b.zip | |
Doc: remove misleading claim in documentation of PQreset().
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
| -rw-r--r-- | doc/src/sgml/libpq.sgml | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml index 2bb3bf77e43..b22cb38ca3b 100644 --- a/doc/src/sgml/libpq.sgml +++ b/doc/src/sgml/libpq.sgml @@ -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 <xref linkend="libpq-PQreset"/> (above) in that they act in a nonblocking manner. These functions suffer from the same |