Document --enable-cassert.

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index b225a03f23f5d4cdf8c9fb04a2cdaaa2499d12c8..90d731473643c262c4b1378cc7504ca47a53c1dd 100644 (file)
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-
+
 
 
  <![%flattext-install-include[<productname>PostgreSQL</>]]> Installation Instructions
@@ -682,8 +682,32 @@ su - postgres
         
          Compiles all programs and libraries with debugging symbols.
          This means that you can run the programs through a debugger
-         to analyze problems. This option is not recommended for
-         production use.
+         to analyze problems. This enlarges the size of the installed
+    executables considerably, and on non-gcc compilers it usually
+    also disables compiler optimization, causing slowdowns. However,
+    having the symbols available is extremely helpful for dealing
+    with any problems that may arise.  Currently, this option is
+    considered of marginal value for production installations, but
+    you should have it on if you are doing development work or
+    running a beta version.
+        
+       
+      
+
+      
+       --enable-cassert
+       
+        
+    Enables assertion checks in the server, which test for
+    many can't happen conditions.  This is invaluable for
+    code development purposes, but the tests slow things down a little.
+    Also, having the tests turned on won't necessarily enhance the
+    stability of your server!  The assertion checks are not categorized
+    for severity, and so what might be a relatively harmless bug will
+    still lead to postmaster restarts if it triggers an assertion
+    failure.  Currently, this option is not recommended for
+         production use, but you should have it on for development work
+    or when running a beta version.