third-party/unittest/googletest/include/gtest/internal/custom/README.md

   1 # Customization Points
   2
   3 The custom directory is an injection point for custom user configurations.
   4
   5 ## Header `gtest.h`
   6
   7 ### The following macros can be defined:
   8
   9 *   `GTEST_OS_STACK_TRACE_GETTER_` - The name of an implementation of
  10     `OsStackTraceGetterInterface`.
  11 *   `GTEST_CUSTOM_TEMPDIR_FUNCTION_` - An override for `testing::TempDir()`. See
  12     `testing::TempDir` for semantics and signature.
  13
  14 ## Header `gtest-port.h`
  15
  16 The following macros can be defined:
  17
  18 ### Logging:
  19
  20 *   `GTEST_LOG_(severity)`
  21 *   `GTEST_CHECK_(condition)`
  22 *   Functions `LogToStderr()` and `FlushInfoLog()` have to be provided too.
  23
  24 ### Threading:
  25
  26 *   `GTEST_HAS_NOTIFICATION_` - Enabled if Notification is already provided.
  27 *   `GTEST_HAS_MUTEX_AND_THREAD_LOCAL_` - Enabled if `Mutex` and `ThreadLocal`
  28     are already provided. Must also provide `GTEST_DECLARE_STATIC_MUTEX_(mutex)`
  29     and `GTEST_DEFINE_STATIC_MUTEX_(mutex)`
  30 *   `GTEST_EXCLUSIVE_LOCK_REQUIRED_(locks)`
  31 *   `GTEST_LOCK_EXCLUDED_(locks)`
  32
  33 ### Underlying library support features
  34
  35 *   `GTEST_HAS_CXXABI_H_`
  36
  37 ### Exporting API symbols:
  38
  39 *   `GTEST_API_` - Specifier for exported symbols.
  40
  41 ## Header `gtest-printers.h`
  42
  43 *   See documentation at `gtest/gtest-printers.h` for details on how to define a
  44     custom printer.