Add explanation of the various *_min_messages elog() values.

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 1a26e9d7942065233f3a96990e14b7b1c424cf02..07e0575b36831dab66829ab86ca6ed3b75828427 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 
 
 
@@ -801,6 +801,81 @@ env PGOPTIONS='-c geqo=off' psql
    detail to the logs. LOG has a different precedence 
    here than in CLIENT_MIN_MESSAGES.
        
+       
+        Here is a summary of the various message types:
+        
+         
+          DEBUG[1-5]
+          
+           
+            This provides information for use by developers.
+      
+          
+         
+         
+          INFO
+          
+           
+            This provides information requested by the user, e.g. 
+       SET.
+      
+          
+         
+         
+          NOTICE
+          
+           
+            This provides information that may be helpful to users, e.g.
+       truncation of long identifiers, sequence creation as part of
+       SERIAL.
+      
+          
+         
+         
+          WARNING
+          
+           
+            This provides warnings to the user, e.g. COMMIT
+            outside a transaction.
+      
+          
+         
+         
+          ERROR
+          
+           
+            Reports the error that caused the transaction to abort.
+      
+          
+         
+
+         
+          LOG
+          
+           
+            This reports information of interest to administrators, e.g. 
+       checkpoint activity.
+      
+          
+         
+         
+          FATAL
+          
+           
+            This reports why the backend session terminated.
+      
+          
+         
+         
+          PANIC
+          
+           
+            This reports why all backends restarted.
+      
+          
+         
+        
+       
       
      
 
@@ -812,10 +887,11 @@ env PGOPTIONS='-c geqo=off' psql
         default is NOTICE. Valid values are
         DEBUG5, DEBUG4, DEBUG3,
         DEBUG2, DEBUG1, LOG,
-        NOTICE, WARNING, and ERROR. 
-   Later values send less information to the user. LOG 
-   has a different precedence here than in 
-   SERVER_MIN_MESSAGES.
+        NOTICE, WARNING, and ERROR.
+        Later values send less information to the user. LOG
+        has a different precedence here than in
+        SERVER_MIN_MESSAGES. Also see that section for an
+        explanation of the various values.