]>
Commit | Line | Data |
---|---|---|
4514447c FM |
1 | ///////////////////////////////////////////////////////////////////////////// |
2 | // Name: utilities.h | |
3 | // Purpose: Utilities page of the Doxygen manual | |
4 | // Author: wxWidgets team | |
526954c5 | 5 | // Licence: wxWindows licence |
4514447c FM |
6 | ///////////////////////////////////////////////////////////////////////////// |
7 | ||
880efa2a | 8 | /** |
4514447c | 9 | |
11259601 | 10 | @page page_utils Utilities Overview |
4514447c | 11 | |
e7054054 BP |
12 | @tableofcontents |
13 | ||
dc28cdf8 FM |
14 | In addition to the wxWidgets libraries (see @ref page_libs), some utilities |
15 | are available to the users in the @c utils hierarchy (even if some of them are | |
4c51a665 | 16 | explicitly conceived for wxWidgets maintainance and will probably be of |
dc28cdf8 | 17 | little use to others). |
4514447c | 18 | |
dc28cdf8 FM |
19 | Please note that these utilities do represent only the utilities developed |
20 | and maintained by the wxWidgets team. | |
21 | There are lots of other user-contributed and user-maintained packages; | |
22 | see the wxWidgets download page: http://www.wxwidgets.org/downloads | |
23 | or directly http://wxcode.sourceforge.net or http://www.wxcommunity.com/ . | |
4514447c | 24 | |
4514447c | 25 | |
4514447c | 26 | |
dc28cdf8 | 27 | @section page_utils_emulator Emulator |
4514447c | 28 | |
dc28cdf8 | 29 | Xnest-based display emulator for X11-based PDA applications. |
4514447c | 30 | |
dc28cdf8 FM |
31 | <!-- On some systems, the Xnest window does not synchronise with the |
32 | 'skin' window. THIS ISN'T THE PLACE FOR THIS STATEMENT I THINK --> | |
4514447c | 33 | |
dc28cdf8 | 34 | This program can be found in @c utils/emulator. |
4514447c | 35 | |
4514447c | 36 | |
5934cda1 | 37 | @section page_utils_helpview Help Viewer |
4514447c | 38 | |
5934cda1 FM |
39 | Helpview is a program for displaying wxWidgets HTML Help files. |
40 | In many cases, you may wish to use the wxWidgets HTML | |
dc28cdf8 FM |
41 | Help classes from within your application, but this provides a |
42 | handy stand-alone viewer. See @ref overview_html for more details. | |
4514447c | 43 | |
dc28cdf8 | 44 | You can find Helpview in @c utils/helpview. |
4514447c FM |
45 | |
46 | ||
dc28cdf8 | 47 | @section page_utils_hhp2cached HHP2Cached |
3c4f71cc | 48 | |
dc28cdf8 FM |
49 | This utility creates a "cached" version of a @c .hhp file; using cached @c .hhp |
50 | files in wxHtmlHelpController can drammatically improve the performances | |
51 | of the help viewer. See wxHtmlHelpController for more details. | |
3c4f71cc | 52 | |
0c1cc948 | 53 | You can find HHP2Cached in @c utils/hhp2cached. |
3c4f71cc | 54 | |
3c4f71cc | 55 | |
e7054054 | 56 | @section page_utils_ifacecheck Interface Checker |
5934cda1 FM |
57 | |
58 | This utility compares the wxWidgets real interface contained in the @c include | |
59 | hierarchy with the wxWidgets interface used for documentation purposes and | |
60 | kept in the @c interface hierarchy. | |
61 | ||
62 | Ifacecheck warns about incoherences (mainly wrong prototype signatures) and | |
63 | can even correct them automatically. It uses the XML outputs of the gccxml utility | |
64 | (see http://www.gccxml.org) and of the Doxygen utility (see http://www.doxygen.org) | |
65 | to do the comparisons. | |
66 | ||
4c51a665 | 67 | It's explicitly designed for wxWidgets documentation needs and is probably of little |
21864ff2 FM |
68 | use for anything else than wxWidgets docs reviewing. |
69 | ||
5934cda1 FM |
70 | You can find it in @c utils/ifacecheck. |
71 | ||
72 | ||
e7054054 BP |
73 | @section page_utils_screenshotgen Screenshot Generator |
74 | ||
75 | This utility automates the process of taking screenshots of various GUI | |
76 | components for use in the HTML documentation of wxWidgets. | |
77 | ||
78 | You can find it in @c utils/screenshotgen. | |
79 | ||
80 | ||
5934cda1 | 81 | @section page_utils_wxrc wxWidgets XML Resource Compiler |
3c4f71cc | 82 | |
dc28cdf8 FM |
83 | This utility allows the user to compile @e binary versions of their XRC files, |
84 | which are compressed and can be loaded faster than plain XRC files. | |
85 | See @ref overview_xrc for more info. | |
3c4f71cc | 86 | |
dc28cdf8 | 87 | You can find it under @c utils/wxrc. |
3c4f71cc | 88 | |
4514447c | 89 | */ |
29f86fc1 | 90 |