From 288407384847c74c5f969d6e9a462010fd8a1f2d Mon Sep 17 00:00:00 2001 From: Tom Lane Date: Mon, 19 Feb 2001 22:25:43 +0000 Subject: [PATCH] Document --enable-cassert. --- doc/src/sgml/installation.sgml | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index b225a03f23..90d7314736 100644 --- 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.