source: trunk/os2-doc/macros.html@ 16

Last change on this file since 16 was 8, checked in by dmik, 20 years ago

Transferred Qt for OS/2 version 3.3.1-rc5 sources from the CVS
File size: 8.1 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<?xml-stylesheet type="text/css"
3href="file:qtos2-xxe.css"
4?>
5<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
6"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
7<html>
8 <head>
9 <link href="qtos2-www.css" rel="stylesheet" type="text/css" />
10
11 <link href="#top" rel="top" />
12
13 <link href="index.html" rel="first" />
14
15 <link href="changes.html" rel="prev" />
16
17 <title>Qt for OS/2 Project</title>
18 </head>
19
20 <body id="changelog">
21 <h1><a name="top">The meaning of some macros</a></h1>
22
23 <p>This table contains descriptions of some (mostly internal) macros which
24 are not described anywhere (or not enough described) in the original Qt
25 docs. It does not pretend to be a complete list of all Qt macros -- only
26 those that are considered to be interesting or important are mentioned
27 here.</p>
28
29 <table border="1">
30 <thead>
31 <tr>
32 <th>Macro</th>
33
34 <th>Meaning</th>
35
36 <th>Scope</th>
37
38 <th>Notes</th>
39 </tr>
40 </thead>
41
42 <tr>
43 <td><code>Q_OS_OS2</code></td>
44
45 <td>We're compiling under OS/2</td>
46
47 <td>everywhere</td>
48
49 <td></td>
50 </tr>
51
52 <tr>
53 <td><code>Q_OS_OS2EMX</code></td>
54
55 <td>We're compiling under OS/2in EMX mode to be run under
56 XFree86/2</td>
57
58 <td>everywhere</td>
59
60 <td></td>
61 </tr>
62
63 <tr>
64 <td><code>Q_WS_PM</code></td>
65
66 <td>We're compiling for the OS/2 PM windowing system</td>
67
68 <td>everywhere</td>
69
70 <td>This macro is defined if <code>Q_OS_OS2</code> is defined, and
71 <b>not</b> if <code>Q_OS_OS2EMX</code> is</td>
72 </tr>
73
74 <tr>
75 <td><code>HAVE_QCONFIG_CPP</code></td>
76
77 <td>If defined it means that the <kbd>tools</kbd> package contains
78 <code>gconfig.cpp</code>, that contains static <code>char*</code>
79 constants for various Qt installation paths
80 (<code>QT_INSTALL_*</code>). Otherwise it is assumed that these
81 constants are <code>#define</code>d somewhere in makefiles during
82 compilation.</td>
83
84 <td><kbd>qmake</kbd> only</td>
85
86 <td></td>
87 </tr>
88
89 <tr>
90 <td><code>Q_FS_FAT</code></td>
91
92 <td>The filesystem Qt lives in is FAT-like (i.e. <code>;</code> are
93 used as path separators instead of <code>:</code> and so on).</td>
94
95 <td><code>QDir</code> class</td>
96
97 <td></td>
98 </tr>
99
100 <tr>
101 <td><code>QT_LARGEFILE_SUPPORT</code></td>
102
103 <td>OS supports manipulations with large (&gt;2/4G) files</td>
104
105 <td></td>
106
107 <td>In OS/2 we currently disable it since only JFS has a support of
108 large files.</td>
109 </tr>
110
111 <tr>
112 <td><code>NEEDS_QMAIN</code></td>
113
114 <td>If defined, then the symbol <code>main</code> is redefined as
115 <code>qMain</code></td>
116
117 <td></td>
118
119 <td></td>
120 </tr>
121
122 <tr>
123 <td><code>QWS</code></td>
124
125 <td>Qt/Embedded ??</td>
126
127 <td></td>
128
129 <td></td>
130 </tr>
131
132 <tr>
133 <td><code>QT_NO_COMPONENT</code></td>
134
135 <td>If defined, no dynamic module linking (runtime DLL loading) (?)
136 will be done</td>
137
138 <td>some classes</td>
139
140 <td>On Windows, this disables (?) COM support and
141 <code>QPluginManager</code>. Also, If this is <b>not</b> defined, then
142 <code>QFileInfo</code> will use dynamic loading of
143 <kbd>ADVAPI32.DLL</kbd> to resolve some security info functions.
144 Currently I don't know whether we should take this macro into account
145 under OS/2 or not.</td>
146 </tr>
147
148 <tr>
149 <td><code>QT_NO_TEXTCODEC</code></td>
150
151 <td>If defined, no <code>QTextCodec</code> class will be available and
152 all unicode strings will be considered as <kbd>latin1</kbd>
153 strings</td>
154
155 <td>in parts related to the text conversion</td>
156
157 <td>In particular, this means that any conversion from Unicode to
158 single byte strings will be done by simple casting of every unicode
159 char to a regular char (i.e. eliminating the high byte of the unicode
160 word) and replacing unicode symbols whose codes higher than
161 <code>0xFF</code> with the '<code>?</code>' char.</td>
162 </tr>
163
164 <tr>
165 <td><code>QT_NO_CODECS</code></td>
166
167 <td>If defined, there will be no Tamil, ISCII, Herbew and simple
168 codecs</td>
169
170 <td><kbd>codecs</kbd> module</td>
171
172 <td></td>
173 </tr>
174
175 <tr>
176 <td><code>QT_NO_BIG_CODECS</code></td>
177
178 <td>Will be no big codecs such as Japanese etc.</td>
179
180 <td><kbd>codecs</kbd> module</td>
181
182 <td></td>
183 </tr>
184
185 <tr>
186 <td><code>UNICODE</code></td>
187
188 <td>if defined, Win32 uses <code>*W</code> versions of API functions
189 when the unicode support is available, and <code>*A</code>
190 otherwise</td>
191
192 <td>win32-related parts of code (anywhere else?)</td>
193
194 <td></td>
195 </tr>
196
197 <tr>
198 <td><code>QT_NO_COMPAT</code></td>
199
200 <td>If defined no obsolete class methods are implemented during Qt
201 compilation</td>
202
203 <td>somewhere</td>
204
205 <td></td>
206 </tr>
207
208 <tr>
209 <td><code>QT_DLL</code></td>
210
211 <td>If defined it means that the application is being linked with the
212 DLL version of Qt</td>
213
214 <td><code>qglobal.h</code></td>
215
216 <td>only for Win32 at the present</td>
217 </tr>
218
219 <tr>
220 <td><code>QT_MAKEDLL</code></td>
221
222 <td>If defined it means that the DLL version of Qt is being
223 compiled</td>
224
225 <td><code>qglobal.h</code></td>
226
227 <td>only for Win32 at the present (linux version compiled under
228 Borland uses <code>QT_SHARED</code> define for these purposes)</td>
229 </tr>
230
231 <tr>
232 <td><code>Q_QDOC</code></td>
233
234 <td>Constructs that are visible when this macro is defined, are used
235 to generate the Qt reference documentation (i.e. real constructs used
236 when compiling Qt can differ)</td>
237
238 <td>elsewhere</td>
239
240 <td></td>
241 </tr>
242
243 <tr>
244 <td><code>QT_NO_PIXMAP_TRANSFORMATION</code></td>
245
246 <td>When defined, no QPixmap::xForm() and trueMatrix() are
247 available</td>
248
249 <td><code>QPixmap</code> and <code>QBitmap</code> classes</td>
250
251 <td></td>
252 </tr>
253
254 <tr>
255 <td><code>QT_NO_PRINTER</code></td>
256
257 <td>When defined, no <code>QPrinter</code> and <code>QPSPrinter</code>
258 classes are available</td>
259
260 <td><code>QPrinter</code>, <code>QPSPrinter</code> and
261 <code>QPainter</code> sources</td>
262
263 <td></td>
264 </tr>
265
266 <tr>
267 <td><code>QT_NO_LAYOUT</code></td>
268
269 <td>No <code>QLayout*</code>, <code>QWidgetItem</code>, and
270 <code>Q*Layout</code> classes, i.e. no layout management</td>
271
272 <td>sources of these classes</td>
273
274 <td></td>
275 </tr>
276 </table>
277
278 <h1>The meaning of some qmake CONFIG options</h1>
279
280 <p>The table below contains the meaning of some qmake CONFIG variable
281 options that are recognized by qmake and used in some project files.</p>
282
283 <table border="1">
284 <thead>
285 <tr>
286 <th>Option</th>
287
288 <th>Meaning</th>
289
290 <th>Scope</th>
291
292 <th>Notes</th>
293 </tr>
294 </thead>
295
296 <tr>
297 <td><code>shared</code></td>
298
299 <td>qmake assumes that the application is linked with the dll version
300 of Qt and automatically adds the <code>QT_DLL</code> define</td>
301
302 <td></td>
303
304 <td>Win32</td>
305 </tr>
306
307 <tr>
308 <td><code>staticlib</code></td>
309
310 <td>this is the opposite to <code>dll</code> (the latter takes
311 precedence), meaning that a static library (not DLL) is being
312 compiled</td>
313
314 <td></td>
315
316 <td>This meaning in Win32 only (?)</td>
317 </tr>
318 </table>
319 </body>
320</html>
Note: See TracBrowser for help on using the repository browser.