m4_comment([$Id: flags.so,v 10.13 2006/10/05 01:06:05 bostic Exp $])

define(__m4_product_name, m4_db)
define(__m4_directory, build_unix)
define(__m4_prev_link, build_unix/small)

m4_ref_title(Building __m4_product_name for UNIX/POSIX systems,
    Changing compile or load options,
    [changing @compile or load options,
    changing compile or @load options],
    __m4_prev_link, __m4_directory/install)

m4_p([dnl
You can specify compiler and/or compile and load time flags by using
environment variables during __m4_product_name configuration.  For
example, if you want to use a specific compiler, specify the CC
environment variable before running configure:])

m4_indent([prompt: env CC=gcc ../dist/configure])

m4_p([dnl
Using anything other than the native compiler will almost certainly mean
that you'll want to check the flags specified to the compiler and
loader, too.])

m4_p([dnl
To specify debugging and optimization options for the C compiler,
use the CFLAGS environment variable:])

m4_indent([prompt: env CFLAGS=-O2 ../dist/configure])

m4_p([dnl
To specify header file search directories and other miscellaneous options
for the C preprocessor and compiler, use the CPPFLAGS environment variable:])

m4_indent([prompt: env CPPFLAGS=-I/usr/contrib/include ../dist/configure])

m4_p([dnl
To specify debugging and optimization options for the C++ compiler,
use the CXXFLAGS environment variable:])

m4_indent([prompt: env CXXFLAGS=-Woverloaded-virtual ../dist/configure])

m4_p([dnl
To specify miscellaneous options or additional library directories for
the linker, use the LDFLAGS environment variable:])

m4_indent([prompt: env LDFLAGS="-N32 -L/usr/local/lib" ../dist/configure])

m4_p([dnl
If you want to specify additional libraries, set the LIBS environment
variable before running configure.  For example, the following would
specify two additional libraries to load, "posix" and "socket":])

m4_indent([prompt: env LIBS="-lposix -lsocket" ../dist/configure])

m4_p([dnl
Make sure that you prepend -L to any library directory names and that you
prepend -I to any include file directory names!  Also, if the arguments
you specify contain blank or tab characters, be sure to quote them as
shown previously; that is with single or double quotes around the values
you are specifying for LIBS.])

m4_p([dnl
The env command, which is available on most systems, simply sets one or
more environment variables before running a command.  If the env command
is not available to you, you can set the environment variables in your
shell before running configure.  For example, in sh or ksh, you could
do the following:])

m4_indent([prompt: LIBS="-lposix -lsocket" ../dist/configure])

m4_p([dnl
In csh or tcsh, you could do the following:])

m4_indent([dnl
prompt: setenv LIBS "-lposix -lsocket"
prompt: ../dist/configure])

m4_p([dnl
See your command shell's manual page for further information.])

m4_page_footer