Configure
=========

The following command configures the project for a build.  It is highly recommended that you invoke configure from an empty directory.

     .configure{}

Please see INSTALL for details on configure usage, and standard options. Additionally, the following custom options have been added to configure:

--disable-debug
     Do not generate debug information.  Do not direct compiler to generate debugging information. By default the compiler will generate debug information if the platform supports it.

--disable-optimize
     Do not optimize. Do not direct compiler to optimize code. By default compiler optimization is enabled if the platform supports it.

--disable-fvisibility
     Do not set default ELF symbol visibility. By default configure attempts to detect if the compiler supports this feature. However on some platforms detecting incompatibilty of this feature might not be accurate in which case this option should be given.

--disable-gch
     By default certain platforms are marked to use GCC precompiled headers. Generally this greatly decrease build times but may require more diligence for iterative development; that is to say dependencies may not properly be tracked and more frequent make clean may be required when headers are changed. Use this option to disable GCC precompiled headers.

--disable-largefile
     On some 32-bit platforms or configurations it might be desirable to build without largefile (LFS) support. By default configure attempts to detect formal LFS support and enables it if found.

--disable-util
     Do not build/install utilities. This is convenience option for users who desire to skip building the utilities (eg. command-line executables) which are enabled by default.

--enable-bi=ARCH
     On bi-arch capable platforms it is possible to generate 32 or 64 bit code. This is supported by adding arguments -m32 or -m64, respectively, when compiling or linking. Use this option to override the platform-specific default.

--enable-ub[=ARCHS]
     On OSX systems it is possible to generate universal binaries. This is supported by adding one or more argument patterns -arch ARCH when compiling or linking. Use this option to either target an architecture different from the platform default, or to produce universal binaries.

--enable-dependency-tracking
     Enable automatic dependency tracking for include-files. By default this feature is disabled.