office-gobmx/config_host
Luboš Luňák fdafe9505c fix documentation for config_xxx.h files
Not that I know why the directory had to be renamed in the first place.

Change-Id: I3e4d07591876636ae4930240ac1acc68522fb94f
2013-02-01 14:19:18 +01:00
..
.gitignore
config_clang.h.in
config_global.h.in
config_graphite.h.in
config_telepathy.h.in
config_vclplug.h.in
config_version.h.in
README

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
- choose the proper config_host/config_xxx.h file to use
    - if it is a global setting (such as availability of a compiler feature),
        use config_host/config_global.h
    - otherwise check if there is a matching config_host/config_hxx.h file
    - if none matches, add a new one:
        - 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
            in configure.ac
        - add config_hxx.h to config_host/.gitignore
- add #undef HAVE_FOO to the config_host/config_hxx.h , possibly with a comment
- add #include <config_xxx.h> before any #ifdef HAVE_XXX in a source file