boost/config/user.hpp

   1 //  boost/config/user.hpp  ---------------------------------------------------//
   2
   3 //  (C) Copyright John Maddock 2001.
   4 //  Use, modification and distribution are subject to the
   5 //  Boost Software License, Version 1.0. (See accompanying file
   6 //  LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
   7
   8 //  Do not check in modified versions of this file,
   9 //  This file may be customized by the end user, but not by boost.
  10
  11 //
  12 //  Use this file to define a site and compiler specific
  13 //  configuration policy:
  14 //
  15
  16 // define this to locate a compiler config file:
  17 // #define BOOST_COMPILER_CONFIG <myheader>
  18
  19 // define this to locate a stdlib config file:
  20 // #define BOOST_STDLIB_CONFIG   <myheader>
  21
  22 // define this to locate a platform config file:
  23 // #define BOOST_PLATFORM_CONFIG <myheader>
  24
  25 // define this to disable compiler config,
  26 // use if your compiler config has nothing to set:
  27 // #define BOOST_NO_COMPILER_CONFIG
  28
  29 // define this to disable stdlib config,
  30 // use if your stdlib config has nothing to set:
  31 // #define BOOST_NO_STDLIB_CONFIG
  32
  33 // define this to disable platform config,
  34 // use if your platform config has nothing to set:
  35 // #define BOOST_NO_PLATFORM_CONFIG
  36
  37 // define this to disable all config options,
  38 // excluding the user config.  Use if your
  39 // setup is fully ISO compliant, and has no
  40 // useful extensions, or for autoconf generated
  41 // setups:
  42 // #define BOOST_NO_CONFIG
  43
  44 // define this to make the config "optimistic"
  45 // about unknown compiler versions.  Normally
  46 // unknown compiler versions are assumed to have
  47 // all the defects of the last known version, however
  48 // setting this flag, causes the config to assume
  49 // that unknown compiler versions are fully conformant
  50 // with the standard:
  51 // #define BOOST_STRICT_CONFIG
  52
  53 // define this to cause the config to halt compilation
  54 // with an #error if it encounters anything unknown --
  55 // either an unknown compiler version or an unknown
  56 // compiler/platform/library:
  57 // #define BOOST_ASSERT_CONFIG
  58
  59
  60 // define if you want to disable threading support, even
  61 // when available:
  62 // #define BOOST_DISABLE_THREADS
  63
  64 // define when you want to disable Win32 specific features
  65 // even when available:
  66 // #define BOOST_DISABLE_WIN32
  67
  68 // BOOST_DISABLE_ABI_HEADERS: Stops boost headers from including any
  69 // prefix/suffix headers that normally control things like struct
  70 // packing and alignment.
  71 // #define BOOST_DISABLE_ABI_HEADERS
  72
  73 // BOOST_ABI_PREFIX: A prefix header to include in place of whatever
  74 // boost.config would normally select, any replacement should set up
  75 // struct packing and alignment options as required.
  76 // #define BOOST_ABI_PREFIX my-header-name
  77
  78 // BOOST_ABI_SUFFIX: A suffix header to include in place of whatever
  79 // boost.config would normally select, any replacement should undo
  80 // the effects of the prefix header.
  81 // #define BOOST_ABI_SUFFIX my-header-name
  82
  83 // BOOST_ALL_DYN_LINK: Forces all libraries that have separate source,
  84 // to be linked as dll's rather than static libraries on Microsoft Windows
  85 // (this macro is used to turn on __declspec(dllimport) modifiers, so that
  86 // the compiler knows which symbols to look for in a dll rather than in a
  87 // static library).  Note that there may be some libraries that can only
  88 // be statically linked (Boost.Test for example) and others which may only
  89 // be dynamically linked (Boost.Threads for example), in these cases this
  90 // macro has no effect.
  91 // #define BOOST_ALL_DYN_LINK
  92
  93 // BOOST_WHATEVER_DYN_LINK: Forces library "whatever" to be linked as a dll
  94 // rather than a static library on Microsoft Windows: replace the WHATEVER
  95 // part of the macro name with the name of the library that you want to
  96 // dynamically link to, for example use BOOST_DATE_TIME_DYN_LINK or
  97 // BOOST_REGEX_DYN_LINK etc (this macro is used to turn on __declspec(dllimport)
  98 // modifiers, so that the compiler knows which symbols to look for in a dll
  99 // rather than in a static library).
 100 // Note that there may be some libraries that can only be statically linked
 101 // (Boost.Test for example) and others which may only be dynamically linked
 102 // (Boost.Threads for example), in these cases this macro is unsupported.
 103 // #define BOOST_WHATEVER_DYN_LINK
 104
 105 // BOOST_ALL_NO_LIB: Tells the config system not to automatically select
 106 // which libraries to link against.
 107 // Normally if a compiler supports #pragma lib, then the correct library
 108 // build variant will be automatically selected and linked against,
 109 // simply by the act of including one of that library's headers.
 110 // This macro turns that feature off.
 111 // #define BOOST_ALL_NO_LIB
 112
 113 // BOOST_WHATEVER_NO_LIB: Tells the config system not to automatically
 114 // select which library to link against for library "whatever",
 115 // replace WHATEVER in the macro name with the name of the library;
 116 // for example BOOST_DATE_TIME_NO_LIB or BOOST_REGEX_NO_LIB.
 117 // Normally if a compiler supports #pragma lib, then the correct library
 118 // build variant will be automatically selected and linked against, simply
 119 // by the act of including one of that library's headers.  This macro turns
 120 // that feature off.
 121 // #define BOOST_WHATEVER_NO_LIB
 122
 123
 124