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-02-01 07:19:18 -06: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
|
|
|
|
|
- otherwise check if there is a matching config_host/config_hxx.h file
|
2012-12-07 10:51:21 -06:00
|
|
|
- if none matches, add a new one:
|
2013-02-01 07:19:18 -06: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-02-01 07:19:18 -06:00
|
|
|
- add config_hxx.h to config_host/.gitignore
|
2013-03-18 11:41:50 -05:00
|
|
|
- add #undef HAVE_FOO to the config_host/config_hxx.h , possibly with a comment
|
|
|
|
|
- if the setting is an on/off setting (i.e. not a value of anything),
|
|
|
|
|
add the following block right after it
|
2013-03-18 11:10:39 -05:00
|
|
|
#ifndef HAVE_FOO
|
|
|
|
|
#define HAVE_FOO 0
|
|
|
|
|
#endif
|
|
|
|
|
- add #include <config_xxx.h> before any #if HAVE_FOO in a source file
|
|
|
|
|
- make sure you use #if HAVE_FOO, do not use #ifdef
|
