Gitiles
Code Review Sign In
gerrit.collaboraoffice.com / core / refs/heads/libreoffice-7-4-6 / . / config_host
tree: 36f1ee2a620f3de835a5a3f893d5dd3d28e2c62e [path history] [tgz]
  1. .gitignore
  2. config_box2d.h.in
  3. config_buildid.h.in
  4. config_cairo_canvas.h.in
  5. config_clang.h.in
  6. config_crypto.h.in
  7. config_cxxabi.h.in
  8. config_dbus.h.in
  9. config_dconf.h.in
  10. config_eot.h.in
  11. config_extensions.h.in
  12. config_feature_desktop.h.in
  13. config_feature_opencl.h.in
  14. config_features.h.in
  15. config_firebird.h.in
  16. config_folders.h.in
  17. config_fonts.h.in
  18. config_fuzzers.h.in
  19. config_gio.h.in
  20. config_global.h.in
  21. config_gpgme.h.in
  22. config_java.h.in
  23. config_langs.h.in
  24. config_lgpl.h.in
  25. config_libcxx.h.in
  26. config_liblangtag.h.in
  27. config_locales.h.in
  28. config_mpl.h.in
  29. config_oauth2.h.in
  30. config_oox.h.in
  31. config_options.h.in
  32. config_options_calc.h.in
  33. config_poppler.h.in
  34. config_probes.h.in
  35. config_python.h.in
  36. config_skia.h.in
  37. config_typesizes.h.in
  38. config_validation.h.in
  39. config_vcl.h.in
  40. config_vclplug.h.in
  41. config_vendor.h.in
  42. config_version.h.in
  43. config_wasm_strip.h.in
  44. config_writerperfect.h.in
  45. config_zxing.h.in
  46. README.md
config_host/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