few doc cleanups

diff --git a/doc/config.txt b/doc/config.txt
index bb0ef58e74bfaf275a1db9be1469e2d4c9619ee4..a91fab7a5a038bb5b7319a6de80e82af523e9037 100644 (file)
--- a/doc/config.txt
+++ b/doc/config.txt
@@ -239,7 +239,8 @@ Default: SELECT 1;
 ==== server_lifetime ====
 
 Pooler tries to close server connections that are been connected longer than
-this.
+this.  Setting it to 0 means the connection is to be used only once,
+then closed.
 
 Default: 3600
 

diff --git a/doc/usage.txt b/doc/usage.txt
index 72beb4afdb44dc4f7b8c0e57cac08dd7951e6345..9d5104a459cb6fe4935a101e0c05bc3bb92843bb 100644 (file)
--- a/doc/usage.txt
+++ b/doc/usage.txt
@@ -100,7 +100,8 @@ Basic setup and usage as following.
 
 -R::
       Do a online restart. That means connecting to running process, loading
-      open sockets from it and using them.
+      open sockets from it and using them.  If there is no active process,
+      boot normally.
 
 -u user::
       Switch to user on startup.
@@ -109,7 +110,9 @@ Basic setup and usage as following.
       Increase verbosity.  Can be used multiple times.
 
 -q::
-      Be quiet - don't log to stdout.
+      Be quiet - don't log to stdout.  Note this does not affect
+      logging verbosity, only that stdout is not to be used.
+      For use in init.d scripts.
 
 -V::
       Show version.
@@ -393,12 +396,14 @@ changeable::
 ==== PAUSE; ====
 
 PgBouncer tries to disconnect from all servers, first waiting for all queries
-to complete. The command will not return before all is done.
+to complete. The command will not return before all is done.  To be used
+at the time of database restart.
 
 ==== SUSPEND; ====
 
 All socket buffers are flushed and PgBouncer stops listening data on them. The
-command will not return before all is done.
+command will not return before all is done. To be used at the time of
+PgBouncer restart.
 
 ==== RESUME; ====