Add wxDEBUG_LEVEL to wx/setup.h and document it.
Under Unix wxDEBUG_LEVEL can be set using configure --enable-debug=max option but under Windows it needs to be changed in wx/msw/setup.h so add it to this file with a comment explaining its meaning. Also document this symbol with the other preprocessor constants. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@61890 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -59,6 +59,50 @@
|
||||
// debugging settings
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
// wxDEBUG_LEVEL will be defined as 1 in wx/debug.h so normally there is no
|
||||
// need to define it here. You may do it for two reasons: either completely
|
||||
// disable/compile out the asserts in release version (then do it inside #ifdef
|
||||
// NDEBUG) or, on the contrary, enable more asserts, including the usually
|
||||
// disabled ones, in the debug build (then do it inside #ifndef NDEBUG)
|
||||
//
|
||||
// #ifdef NDEBUG
|
||||
// #define wxDEBUG_LEVEL 0
|
||||
// #else
|
||||
// #define wxDEBUG_LEVEL 2
|
||||
// #endif
|
||||
|
||||
// wxHandleFatalExceptions() may be used to catch the program faults at run
|
||||
// time and, instead of terminating the program with a usual GPF message box,
|
||||
// call the user-defined wxApp::OnFatalException() function. If you set
|
||||
// wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work.
|
||||
//
|
||||
// This setting is for Win32 only and can only be enabled if your compiler
|
||||
// supports Win32 structured exception handling (currently only VC++ does)
|
||||
//
|
||||
// Default is 1
|
||||
//
|
||||
// Recommended setting: 1 if your compiler supports it.
|
||||
#define wxUSE_ON_FATAL_EXCEPTION 1
|
||||
|
||||
// Set this to 1 to be able to generate a human-readable (unlike
|
||||
// machine-readable minidump created by wxCrashReport::Generate()) stack back
|
||||
// trace when your program crashes using wxStackWalker
|
||||
//
|
||||
// Default is 1 if supported by the compiler.
|
||||
//
|
||||
// Recommended setting: 1, set to 0 if your programs never crash
|
||||
#define wxUSE_STACKWALKER 1
|
||||
|
||||
// Set this to 1 to compile in wxDebugReport class which allows you to create
|
||||
// and optionally upload to your web site a debug report consisting of back
|
||||
// trace of the crash (if wxUSE_STACKWALKER == 1) and other information.
|
||||
//
|
||||
// Default is 1 if supported by the compiler.
|
||||
//
|
||||
// Recommended setting: 1, it is compiled into a separate library so there
|
||||
// is no overhead if you don't use it
|
||||
#define wxUSE_DEBUGREPORT 1
|
||||
|
||||
// Generic comment about debugging settings: they are very useful if you don't
|
||||
// use any other memory leak detection tools such as Purify/BoundsChecker, but
|
||||
// are probably redundant otherwise. Also, Visual C++ CRT has the same features
|
||||
@@ -66,10 +110,13 @@
|
||||
// may prefer to use it instead of built in memory debugging code because it is
|
||||
// faster and more fool proof.
|
||||
//
|
||||
// Using VC++ CRT memory debugging is enabled by default in debug mode
|
||||
// (__WXDEBUG__) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0)
|
||||
// Using VC++ CRT memory debugging is enabled by default in debug build (_DEBUG
|
||||
// is defined) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0)
|
||||
// and if __NO_VC_CRTDBG__ is not defined.
|
||||
|
||||
// The rest of the options in this section are obsolete and not supported,
|
||||
// enable them at your own risk.
|
||||
|
||||
// If 1, enables wxDebugContext, for writing error messages to file, etc. If
|
||||
// __WXDEBUG__ is not defined, will still use the normal memory operators.
|
||||
//
|
||||
@@ -110,37 +157,6 @@
|
||||
// Recommended setting: 0
|
||||
#define wxUSE_DEBUG_NEW_ALWAYS 0
|
||||
|
||||
// wxHandleFatalExceptions() may be used to catch the program faults at run
|
||||
// time and, instead of terminating the program with a usual GPF message box,
|
||||
// call the user-defined wxApp::OnFatalException() function. If you set
|
||||
// wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work.
|
||||
//
|
||||
// This setting is for Win32 only and can only be enabled if your compiler
|
||||
// supports Win32 structured exception handling (currently only VC++ does)
|
||||
//
|
||||
// Default is 1
|
||||
//
|
||||
// Recommended setting: 1 if your compiler supports it.
|
||||
#define wxUSE_ON_FATAL_EXCEPTION 1
|
||||
|
||||
// Set this to 1 to be able to generate a human-readable (unlike
|
||||
// machine-readable minidump created by wxCrashReport::Generate()) stack back
|
||||
// trace when your program crashes using wxStackWalker
|
||||
//
|
||||
// Default is 1 if supported by the compiler.
|
||||
//
|
||||
// Recommended setting: 1, set to 0 if your programs never crash
|
||||
#define wxUSE_STACKWALKER 1
|
||||
|
||||
// Set this to 1 to compile in wxDebugReport class which allows you to create
|
||||
// and optionally upload to your web site a debug report consisting of back
|
||||
// trace of the crash (if wxUSE_STACKWALKER == 1) and other information.
|
||||
//
|
||||
// Default is 1 if supported by the compiler.
|
||||
//
|
||||
// Recommended setting: 1, it is compiled into a separate library so there
|
||||
// is no overhead if you don't use it
|
||||
#define wxUSE_DEBUGREPORT 1
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// Unicode support
|
||||
|
Reference in New Issue
Block a user