Index: doc/src/sgml/libpq.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v
retrieving revision 1.275
diff -c -c -r1.275 libpq.sgml
*** doc/src/sgml/libpq.sgml	10 Jan 2009 20:14:30 -0000	1.275
--- doc/src/sgml/libpq.sgml	6 Feb 2009 18:17:55 -0000
***************
*** 63,68 ****
--- 63,83 ----
     The <function>PQstatus</> function should be called to check
     whether a connection was successfully made before queries are sent
     via the connection object.
+   
+    <note>
+     <para>
+      On Windows, there is a way to improve performance if a single
+      database connection is repeated started and shutdown.  Internally,
+      libpq calls WSAStartup() and WSACleanup() for connection startup
+      and shutdown, respectively.  WSAStartup() increments an internal
+      Windows library reference count which is decremented by WSACleanup().
+      When the reference count is just one, calling WSACleanup() frees
+      all resources and all DLLs are unloaded.  This is an expensive
+      operation.  To avoid this, an application can manually call
+      WSAStartup() so resources will not be freed when the last database
+      connection is closed.
+     </para>
+    </note>
  
     <variablelist>
      <varlistentry>