diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 76afcffbdfe..8b51d9ecc14 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -4934,11 +4934,12 @@ int PQsetnonblocking(PGconn *conn, int arg);
- In the nonblocking state, calls to
+ In the nonblocking state, successful calls to
, ,
, ,
- and will not block but instead return
- an error if they need to be called again.
+ and will not block; their changes
+ are stored in the local output buffer until they are flushed.
+ Unsuccessful calls will return an error and must be retried.