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