Update descriptions of configure's options, and document how to specify

multiple directories for --with-includes or --with-libraries.

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 7492945cb7676a3185f9ffef953059df44f02daf..78387933f9466d7c03ce4f0767c6ae655e842a6e 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -16,7 +16,7 @@
    The following parameters may be of interest to installers:
    
    
-Directory and file names:
+Directories to install PostgreSQL in:
   --prefix=PREFIX         install architecture-independent files in PREFIX
                           [/usr/local/pgsql]
   --bindir=DIR            user executables in DIR [EPREFIX/bin]
@@ -32,28 +32,23 @@ Features and packages:
   --with-template=template
                           use operating system template file
                               see template directory
-  --with-includes=incdir
-                          site header files for tk/tcl, etc in DIR
-  --with-libs=incdir
-                          also search for libraries in DIR
-  --with-libraries=libdir
-                          also search for libraries in DIR
+  --with-includes=dirs    look for header files for tcl/tk, etc in DIRS
+  --with-libraries=dirs   look for additional libraries in DIRS
+  --with-libs=dirs        alternate spelling of --with-libraries
   --enable-locale         enable locale support
   --enable-recode         enable cyrillic recode support
-  --with-mb=encoding
-                          enable multi-byte support
-  --with-pgport=portnum
-                          change default startup port
-  --with-maxbackends=n
-                          set default maximum number of server processes 
+  --enable-multibyte      enable multibyte character support
+  --with-pgport=portnum   change default postmaster port
+  --with-maxbackends=n    set default maximum number of server processes 
   --with-tcl              build Tcl interfaces and pgtclsh
   --with-tclconfig=tcldir
                           tclConfig.sh and tkConfig.sh are in DIR
-  --with-perl             build Perl interface
+  --with-perl             build Perl interface and plperl
   --with-odbc             build ODBC driver package
   --with-odbcinst=odbcdir
                           change default directory for odbcinst.ini
-  --enable-cassert        enable assertion checks (debugging)
+  --enable-cassert        enable assertion checks (for debugging)
+  --enable-debug          build with debugging symbols (-g) 
   --with-CC=compiler
                           use specific C compiler
   --with-CXX=compiler
@@ -67,6 +62,20 @@ Features and packages:
    C++ compiler may need to specify --without-CXX to instruct
    the build procedure to skip construction of libpq++.
   
+  
+   Use the --with-includes and
+   --with-libraries options if you want to build
+   Postgres using include files or libraries
+   that are not installed in your system's standard search path.  For
+   example, you might use these to build with an experimental version of
+   Tcl.  If you need to specify more than one nonstandard directory for
+   include files or libraries, do it like this:
+   
+   --with-includes="/opt/tcl/include /opt/perl5/include"
+   
+  
+  
+  
  
  
   Parameters for Building (<application>make</application>)
@@ -82,7 +91,10 @@ Features and packages:
    will create it using a text editor of your choice. When upgrading installations,
    you can simply copy your old Makefile.custom to the new installation before
    doing the build.
-   
+  
+  
+   Alternatively, you can set variables on the make
+   command line:
    
     make [ variable=value [,...] ]