cleanup - added whitespace around operators, some blank lines, fixed comment typos...

[wxWidgets.git] / include / wx / build.h

diff --git a/include/wx/build.h b/include/wx/build.h
index 60b8da0f4a7f0b5b4bc5658a4a89186dab4e00d7..f0cebe20875bc28de16077e96c2acf3b25e5f406 100644 (file)
--- a/include/wx/build.h
+++ b/include/wx/build.h
@@ -14,6 +14,19 @@
 
 #include "wx/version.h"
 
+// NB: This file contains macros for checking binary compatibility of libraries
+//     in multilib buildm, plugins and user components.
+//     The WX_BUILD_OPTIONS_SIGNATURE macro expands into string that should
+//     uniquely identify binary compatible builds: i.e. if two builds of the
+//     library are binary compatible, their signature string should be the
+//     same; if two builds are binary incompatible, their signatures should
+//     be different.
+//
+//     Therefore, wxUSE_XXX flags that affect binary compatibility (vtables,
+//     function signatures) should be accounted for here. So should compilers
+//     and compiler versions (but note that binary compatible compiler versions
+//     such as gcc-2.95.2 and gcc-2.95.3 should have same signature!).
+
 // ----------------------------------------------------------------------------
 // WX_BUILD_OPTIONS_SIGNATURE
 // ----------------------------------------------------------------------------
@@ -54,41 +67,9 @@
 #elif defined(__VISUALC__)
     #define __WX_BO_COMPILER ",Visual C++"
 #elif defined(__BORLANDC__)
-
-    #if __BORLANDC__ >= 0x600                        /* BCCX */
-        #define __WX_BO_COMPILER_VER " 6.0"
-    #elif __BORLANDC__ >= 0x570                      /* Kylix */
-        #define __WX_BO_COMPILER_VER " 5.7"
-    #elif __BORLANDC__ >= 0x560                      /* BCB++ 6 */
-        #define __WX_BO_COMPILER_VER " 5.6"
-    #elif __BORLANDC__ >= 0x550                      /* BCB++ 5, free command line */
-        #define __WX_BO_COMPILER_VER " 5.5"
-    #elif __BORLANDC__ >= 0x520                      /* BCB++ 1-4 */
-        #define __WX_BO_COMPILER_VER " 5.02"
-    #elif __BORLANDC__ >= 0x500                      /* BC++ 5 */
-        #define __WX_BO_COMPILER_VER " 5.0"
-    #elif __BORLANDC__ >= 0x452                      /* BC++ 4 */
-        #define __WX_BO_COMPILER_VER " 4.0"
-    #elif __BORLANDC__ >= 0x410                      /* BC++ 3.1 */
-        #define __WX_BO_COMPILER_VER " 3.1"
-    #elif __BORLANDC__ >= 0x400                      /* BC++ 3.0 */
-        #define __WX_BO_COMPILER_VER " 3.0"
-    #elif __BORLANDC__ >= 0x200                      /* BC++ 2.0 */
-        #define __WX_BO_COMPILER_VER " 2.0"
-    #else
-        #define __WX_BO_COMPILER_VER
-    #endif
-
-    #define __WX_BO_COMPILER ",Borland C++" __WX_BO_COMPILER_VER
-
+    #define __WX_BO_COMPILER ",Borland C++"
 #elif defined(__DIGITALMARS__)
-
-    #if defined(__DMC_VERSION_STRING__)
-        #define __WX_BO_COMPILER "," __DMC_VERSION_STRING__
-    #else
-        #define __WX_BO_COMPILER ",DigitalMars"
-    #endif
-
+    #define __WX_BO_COMPILER ",DigitalMars"
 #elif defined(__WATCOMC__)
     #define __WX_BO_COMPILER ",Watcom C++"
 #else
@@ -96,16 +77,16 @@
 #endif
 
 // WXWIN_COMPATIBILITY macros affect presence of virtual functions
-#if WXWIN_COMPATIBILITY_2_2
-    #define __WX_BO_WXWIN_COMPAT_2_2 ",compatible with 2.2"
-#else
-    #define __WX_BO_WXWIN_COMPAT_2_2
-#endif
 #if WXWIN_COMPATIBILITY_2_4
     #define __WX_BO_WXWIN_COMPAT_2_4 ",compatible with 2.4"
 #else
     #define __WX_BO_WXWIN_COMPAT_2_4
 #endif
+#if WXWIN_COMPATIBILITY_2_6
+    #define __WX_BO_WXWIN_COMPAT_2_6 ",compatible with 2.6"
+#else
+    #define __WX_BO_WXWIN_COMPAT_2_6
+#endif
 
 // deriving wxWin containers from STL ones changes them completely:
 #if wxUSE_STL
@@ -113,14 +94,14 @@
 #else
     #define __WX_BO_STL ",wx containers"
 #endif
- 
+
 // This macro is passed as argument to wxConsoleApp::CheckBuildOptions()
 #define WX_BUILD_OPTIONS_SIGNATURE \
     __WX_BO_VERSION(wxMAJOR_VERSION, wxMINOR_VERSION, wxRELEASE_NUMBER) \
     " (" __WX_BO_DEBUG "," __WX_BO_UNICODE \
      __WX_BO_COMPILER \
      __WX_BO_STL \
-     __WX_BO_WXWIN_COMPAT_2_2 __WX_BO_WXWIN_COMPAT_2_4 \
+     __WX_BO_WXWIN_COMPAT_2_4 __WX_BO_WXWIN_COMPAT_2_6 \
      ")"
 
 
@@ -131,13 +112,14 @@
 // Use this macro to check build options. Adding it to a file in DLL will
 // ensure that the DLL checks build options in same way IMPLEMENT_APP() does.
 #define WX_CHECK_BUILD_OPTIONS(libName)                                 \
-    static bool wxCheckBuildOptions()                                   \
+    static struct wxBuildOptionsChecker                                 \
     {                                                                   \
-        wxAppConsole::CheckBuildOptions(WX_BUILD_OPTIONS_SIGNATURE,     \
-                                        libName);                       \
-        return true;                                                    \
-    };                                                                  \
-    static bool gs_buildOptionsCheck = wxCheckBuildOptions();
+        wxBuildOptionsChecker()                                         \
+        {                                                               \
+            wxAppConsole::CheckBuildOptions(WX_BUILD_OPTIONS_SIGNATURE, \
+                                            libName);                   \
+        }                                                               \
+    } gs_buildOptionsCheck;
 
 
 #if WXWIN_COMPATIBILITY_2_4