2012-12-07 10:51:21 -06:00
|
|
|
These are configuration files for various features as detected by configure.
|
|
|
|
|
|
|
|
|
|
Include only those files you need (in order to reduce rebuilds when a setting changes).
|
|
|
|
|
|
|
|
|
|
Settings here are only C/C++ #define directives, so they apply only to C/C++ source,
|
|
|
|
|
not to Makefiles.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Adding a new setting:
|
|
|
|
|
=====================
|
|
|
|
|
|
|
|
|
|
- do AC_DEFINE(HAVE_FOO) in configure.ac when a setting should be set
|
2013-03-22 12:12:05 -05:00
|
|
|
- choose the proper config_host/config_XXX.h file to use
|
2012-12-07 10:51:21 -06:00
|
|
|
- if it is a global setting (such as availability of a compiler feature),
|
2013-02-01 07:19:18 -06:00
|
|
|
use config_host/config_global.h
|
2013-03-22 12:12:05 -05:00
|
|
|
- otherwise check if there is a matching config_host/config_XXX.h file
|
2012-12-07 10:51:21 -06:00
|
|
|
- if none matches, add a new one:
|
2013-03-22 12:12:05 -05:00
|
|
|
- add config_host/config_XXX.h.in here, with just #ifndef include guard
|
|
|
|
|
- add AC_CONFIG_HEADERS([config_host/config_XXX.h]) next to the others
|
2012-12-07 10:51:21 -06:00
|
|
|
in configure.ac
|
2013-03-26 13:32:20 -05:00
|
|
|
- add #define HAVE_FOO 0 to the config_host/config_XXX.h , possibly with a comment
|
|
|
|
|
(do not use #undef HAVE_FOO, unless the setting has more values than on/off)
|
2013-03-22 12:12:05 -05:00
|
|
|
- add #include <config_XXX.h> before any #if HAVE_FOO in a source file
|
2013-03-26 13:32:20 -05:00
|
|
|
- make sure you use #if HAVE_FOO for on/off settings, do not use #ifdef
|
