office-gobmx

History

Tor Lillqvist 2c38ea6d16 Building without --with-help is not supposed to disable help functionality Drop HAVE_FEATURE_HELP. Just check HAVE_FEATURE_DESKTOP instead in the few places in the code where HAVE_FEATURE_HELP had been introduced so far. It's only for the non-desktop platforms that leaving out the traditional help functionality is intended anyway. Change-Id: I2d05869267f509a8e64cf402eed8ebef0020cada		2013-03-28 11:48:14 +02:00
..
.gitignore
config_clang.h.in
config_features.h.in	Building without --with-help is not supposed to disable help functionality	2013-03-28 11:48:14 +02:00
config_global.h.in	autoconf can actually handle #define HAVE_FOO 0 as the default	2013-03-26 19:32:20 +01:00
config_graphite.h.in	autoconf can actually handle #define HAVE_FOO 0 as the default	2013-03-26 19:32:20 +01:00
config_kde4.h.in	autoconf can actually handle #define HAVE_FOO 0 as the default	2013-03-26 19:32:20 +01:00
config_mingw.h.in	autoconf can actually handle #define HAVE_FOO 0 as the default	2013-03-26 19:32:20 +01:00
config_telepathy.h.in	autoconf can actually handle #define HAVE_FOO 0 as the default	2013-03-26 19:32:20 +01:00
config_typesizes.h.in
config_vclplug.h.in	autoconf can actually handle #define HAVE_FOO 0 as the default	2013-03-26 19:32:20 +01:00
config_version.h.in
README	.gitignore already ignores config_*.h	2013-03-27 11:36:02 +02:00

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_XXX.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 #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)
- add #include <config_XXX.h> before any #if HAVE_FOO in a source file
- make sure you use #if HAVE_FOO for on/off settings, do not use #ifdef