History

Jan-Marek Glogowski 14069d8417 configure: Improve help-options handling This patch includes: * A README.help.md as a general documentation for the different help types, the LO code and help-related build options. * Adds --disable-xmlhelp for removing the xmlhelp support from the build. Disable for iOS, Android and Emscripten. This was partly included in HAVE_FEATURE_DESKTOP before. * Rename WITH_HELP define to WITH_HELPPACKS, which reflects the actual usage AFAIK. * Depend --with-omindex on --with-help=online and don't override the --with-help setting. Error out on conflicting options. * Depend --with-helppack-integration on build help variants, which actually result in help packs. Kind of reverts commit `2c38ea6d16` ("Building without --with-help is not supposed to disable help functionality"). Change-Id: Ie4cb73905b3ed94e991d9f1bd75cfbd6de9da385 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/116222 Tested-by: Jenkins Reviewed-by: Jan-Marek Glogowski <glogow@fbihome.de>		2021-06-22 14:25:51 +02:00
..
.gitignore
config_box2d.h.in
config_buildid.h.in
config_cairo_canvas.h.in
config_clang.h.in
config_crypto.h.in
config_cxxabi.h.in
config_dbus.h.in
config_dconf.h.in
config_eot.h.in
config_extensions.h.in
config_feature_desktop.h.in
config_feature_opencl.h.in
config_features.h.in	configure: Improve help-options handling	2021-06-22 14:25:51 +02:00
config_firebird.h.in	HAVE_FIREBIRD_30 is not used anymore	2021-06-10 14:07:16 +02:00
config_folders.h.in
config_fuzzers.h.in
config_gio.h.in
config_global.h.in
config_gpgme.h.in
config_java.h.in
config_langs.h.in
config_lgpl.h.in
config_libcxx.h.in
config_liblangtag.h.in
config_locales.h.in
config_mpl.h.in
config_oauth2.h.in
config_oox.h.in
config_options.h.in
config_options_calc.h.in
config_poppler.h.in
config_probes.h.in
config_python.h.in
config_skia.h.in
config_typesizes.h.in
config_vcl.h.in
config_vclplug.h.in	configure: Refactor platform defaults	2021-06-01 15:30:59 +02:00
config_vendor.h.in
config_version.h.in
config_writerperfect.h.in
config_zxing.h.in
README.md

README.md

C/C++ Configuration Created by configure Script

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