config_host/README

   1 These are configuration files for various features as detected by configure.
   2
   3 Include only those files you need (in order to reduce rebuilds when a setting changes).
   4
   5 Settings here are only C/C++ #define directives, so they apply only to C/C++ source,
   6 not to Makefiles.
   7
   8
   9
  10 Adding a new setting:
  11 =====================
  12
  13 - do AC_DEFINE(HAVE_FOO) in configure.ac when a setting should be set
  14 - choose the proper config_host/config_XXX.h file to use
  15     - if it is a global setting (such as availability of a compiler feature),
  16         use config_host/config_global.h
  17     - otherwise check if there is a matching config_host/config_XXX.h file
  18     - if none matches, add a new one:
  19         - add config_host/config_XXX.h.in here, with just #ifndef include guard
  20         - add AC_CONFIG_HEADERS([config_host/config_XXX.h]) next to the others
  21             in configure.ac
  22 - add #define HAVE_FOO 0 to the config_host/config_XXX.h , possibly with a comment
  23   (do not use #undef HAVE_FOO, unless the setting has more values than on/off)
  24 - add #include <config_XXX.h> before any #if HAVE_FOO in a source file
  25 - make sure you use #if HAVE_FOO for on/off settings, do not use #ifdef