| | 1 | ///////////////////////////////////////////////////////////////////////////// |
| | 2 | // Name: forcelnk.h |
| | 3 | // Purpose: see bellow |
| | 4 | // Author: Vaclav Slavik |
| | 5 | // RCS-ID: $Id$ |
| | 6 | // Copyright: (c) Vaclav Slavik |
| | 7 | // Licence: wxWindows licence |
| | 8 | ///////////////////////////////////////////////////////////////////////////// |
| | 9 | |
| | 10 | /* |
| | 11 | |
| | 12 | DESCRPITON: |
| | 13 | |
| | 14 | mod_*.cpp files contain handlers for tags. These files are modules - they contain |
| | 15 | one wxTagModule class and it's OnInit() method is called from wxApp's init method. |
| | 16 | The module is called even if you only link it into the executable, so everything |
| | 17 | seems wonderful. |
| | 18 | |
| | 19 | The problem is that we have these modules in LIBRARY and mod_*.cpp files contain |
| | 20 | no method nor class which is known out of the module. So the linker won't |
| | 21 | link these .o/.obj files into executable because it detected that it is not used |
| | 22 | by the program. |
| | 23 | |
| | 24 | To workaround this I introduced set of macros FORCE_LINK_ME and FORCE_LINK. These |
| | 25 | macros are generic and are not limited to mod_*.cpp files. You may find them quite |
| | 26 | useful somewhere else... |
| | 27 | |
| | 28 | How to use them: |
| | 29 | let's suppose you want to always link file foo.cpp and that you have module |
| | 30 | always.cpp that is certainly always linked (e.g. the one with main() function |
| | 31 | or htmlwin.cpp in wxHtml library). |
| | 32 | |
| | 33 | Place FORCE_LINK_ME(foo) somewhere in foo.cpp and FORCE_LINK(foo) somewhere |
| | 34 | in always.cpp |
| | 35 | See mod_*.cpp and htmlwin.cpp for example :-) |
| | 36 | |
| | 37 | */ |
| | 38 | |
| | 39 | |
| | 40 | #ifndef _WX_FORCELNK_H_ |
| | 41 | #define _WX_FORCELNK_H_ |
| | 42 | |
| | 43 | |
| | 44 | |
| | 45 | // This must be part of the module you want to force: |
| | 46 | #define FORCE_LINK_ME(module_name) \ |
| | 47 | int _link_dummy_func_##module_name (); \ |
| | 48 | int _link_dummy_func_##module_name () \ |
| | 49 | { \ |
| | 50 | return 1; \ |
| | 51 | } |
| | 52 | |
| | 53 | |
| | 54 | // And this must be somewhere where it certainly will be linked: |
| | 55 | #define FORCE_LINK(module_name) \ |
| | 56 | extern int _link_dummy_func_##module_name (); \ |
| | 57 | static int _link_dummy_var_##module_name = \ |
| | 58 | _link_dummy_func_##module_name (); |
| | 59 | |
| | 60 | |
| | 61 | #endif // _WX_FORCELNK_H_ |
projects / wxWidgets.git / blame_incremental