Update BUILD and DEBUG_{FLAG,INFO} documentation for wxMSW.

The documentation was completely out of date and hence very misleading.

Closes #12244.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@65071 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin 2010-07-23 23:44:05 +00:00
parent e80264fdbe
commit 76e15cbd72

View File

@ -682,10 +682,10 @@ Basic Options
---------------------------------------------------------------- ----------------------------------------------------------------
BUILD=release BUILD=release
Builds release version of the library. It differs from default 'debug' Builds release version of the library. It differs from default 'debug' in
in lack of appended 'd' in name of library, does not define __WXDEBUG__ lack of appended 'd' in name of library and uses the release CRT libraries
and not include debug information compiled into object files and the instead of debug ones. Notice that even release builds do include debug
executable. information by default, see DEBUG_FLAG for more information about it.
SHARED=1 SHARED=1
Build shared libraries (DLLs). By default, DLLs are not built Build shared libraries (DLLs). By default, DLLs are not built
@ -751,16 +751,22 @@ MSLU=1
DEBUG_FLAG=0 DEBUG_FLAG=0
DEBUG_FLAG=1 DEBUG_FLAG=1
If set to 1, define __WXDEBUG__ symbol, append 'd' to library name and do DEBUG_FLAG=2
sanity checks at runtime. If set to 0, don't do it. By default, this is Specifies the level of debug support in wxWidgets. Notice that
governed by BUILD option (if 'debug', DEBUG_FLAG=1, if 'release' it is 0), this is independent from both BUILD and DEBUG_INFO options. By default
but it is sometimes desirable to modify default behaviour and e.g. define always set to 1 meaning that debug support is enabled: asserts are compiled
__WXDEBUG__ even in release builds. into the code (they are inactive by default in release builds of the
application but can be enabled), wxLogDebug() and wxLogTrace() are available
and __WXDEBUG__ is defined. Setting it to 0 completely disables all
debugging code in wxWidgets while setting it to 2 enables even the time
consuming assertions and checks which are deemed to be unsuitable for
production environment.
DEBUG_INFO=0 DEBUG_INFO=0
DEBUG_INFO=1 DEBUG_INFO=1
Same as DEBUG_FLAG in behaviour, this option affects whether debugging This option affects whether debugging information is generated. If
information is included in the executable or not. omitted or set to 'default' its value is determined the value of
the BUILD option.
TARGET_CPU=AMD64|IA64 TARGET_CPU=AMD64|IA64
(VC++ only.) Set this variable to build for x86_64 systems. If unset, x86 (VC++ only.) Set this variable to build for x86_64 systems. If unset, x86