5 <meta http-equiv="X-UA-Compatible" content="chrome=1">
6 <title>GMQCC by graphitemaster</title>
8 <link rel="stylesheet" href="stylesheets/styles.css">
9 <link rel="stylesheet" href="stylesheets/pygment_trac.css">
10 <script src="javascripts/scale.fix.js"></script>
11 <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
13 <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
17 <a href="https://github.com/graphitemaster/gmqcc"><div class="fork"></div></a>
20 <h1 class="header">GMQCC</h1>
21 <p class="header">An Improved Quake C Compiler</p>
23 <li class="buttons"><a href=index.html>Index</a></li>
24 <li class="download"><a href="https://github.com/graphitemaster/gmqcc/zipball/master">Download ZIP</a></li>
25 <li class="download"><a href="https://github.com/graphitemaster/gmqcc/tarball/master">Download TAR</a></li>
26 <li class="buttons"><a href="https://github.com/graphitemaster/gmqcc/issues">Issues</a></li>
27 <li class="buttons"><a href="doc.html">Documentation</a></li>
28 <li class="buttons"><a href="https://github.com/graphitemaster/gmqcc">View On GitHub</a></li>
33 <li class="wiki"><a class="wiki" href="#cdoc">Compiler Documentation</a></li>
34 <li class="wiki"><a class="wiki" href="#bdoc">Building Documentation</a></li>
35 <li class="wiki"><a class="wiki" href="#tdoc">Testsuite Documentation</a></li>
37 <h1><a name="cdoc">Compiler Documentation</a></h1>
38 <h3>Defaults Flag</h3>
40 The <i>-show-defaults</i> flag instructs the compiler to print out the defaults used related to
41 the standard, optimization, and code generation. When this flag is specified, the compiler
42 will just print the defaults and quit. No compilation is performed.
44 <pre>$ gmqcc -show-defaults</pre>
45 <h3>Compiling for an alternitive standard</h3>
46 To compile with a different dialect of the QuakeC programming language the <i>-std</i>
47 flag can be instructed to select one of the following options:
51 <td>default standard</td>
55 <td>fteqcc standard</td>
59 <td>vanila QuakeC standard</td>
62 <h2>Common compiler options</h2>
69 <td>-l<path></td>
70 <td>Adds <path> to the directories searched by the preprocessor for include file resolution.</td>
73 <td>-o <file></td>
74 <td>Generates the named executable (progs.src) file (when not specified default is progs.src).</td>
78 <td>-O<level></td>
79 <td>Specfies the optimization level: highest being 3, lowest being 0 (no optimization).</td>
83 <td>Instructs the compiler to only preprocess the input, writing the preprocessed output to stdout</td>
87 <td>Enables all compiled warnings for the selcted standard</td>
91 <td>Instruct the compiler to treat all warnings as errors</td>
94 <td>-std=<standard></td>
95 <td>Selects the standard dialect</td>
98 <h3>Predefined Macros</h3>
102 <td>What it represents</td>
106 <td>Specifies the current selected standard is gmqcc.</td>
110 <td>Specifies the current selected standard is fteqcc.</td>
114 <td>Specifies the current selected standard is qcc.</td>
118 <td>__STD_VERSION_MINOR__</td>
119 <td>Specifies the current selected stanadards minor version number.</td>
122 <td>__STD_VERSION_MAJOR__</td>
123 <td>Specifies the current selected stanadards major version number.</td>
126 <h3>Unsupported compatability options</h3>
128 GMQCC strives hard for compatability with standard dialects, but not all
129 features of those standards might be implemented. The unsupported features
137 <td>Inline Assembly</td>
141 <td>Macro expansion in strings</td>
146 <h2>Less common compiler options</h2>
147 <h3>Code generation options</h3>
151 <td>What it does</td>
154 <td>-foverlap-locals</td>
155 <td>Reduces codesize by overlapping locals where possible</td>
158 <td>-fdarkplaces-string-table-bug</td>
159 <td>Works around a bug in older Darkplaces engine builds where the stringtable size is computed wrong</td>
162 <td>-fadjust-vector-fields</td>
163 <td>corrects assignment of vector field pointers (STORE_V instead of STORE_FLD)</td>
167 <td>Enables FTEQ preprocessor</td>
170 <td>-frelaxted-switch</td>
171 <td>Relaxes switch statement semantics</td>
174 <td>-fshort-logic</td>
175 <td>Enables short circut evaluation/logic</td>
178 <td>-fperl-logic</td>
179 <td>Enables perl evalutaion/logic</td>
182 <h3>Warning options</h3>
186 <td>What it does</td>
189 <td>-Wunused-uninitialized</td>
190 <td>Enables warnings about unused or uninitialized variables</td>
193 <td>-Wunknwon-control-sequence</td>
194 <td>Enables warnings about unknown control sequences</td>
198 <td>Enables warnings about the use of (an) extension(s)</td>
201 <td>-Wfield-redeclared</td>
202 <td>Enables warnings about redeclared fields</td>
205 <td>-Wmissing-return-values</td>
206 <td>Enables warnings about missing return values</td>
209 <td>-Wtoo-few-paramaters</td>
210 <td>Enables warnings about missing paramaters for function calls</td>
213 <td>-Wlocal-shadows</td>
214 <td>Enables warnings about locals shadowing paramaters or other locals</td>
217 <td>-Wlocal-constants</td>
218 <td>Enables warnings about constants specified as locals</td>
221 <td>-Wvoid-variables</td>
222 <td>Enables warnings about variables declared as type void</td>
225 <td>-Wimplicit-function-pointer</td>
226 <td>Enables warnings about implicitly declared function pointers</td>
229 <td>-Wvariadic-function</td>
230 <td>Enables warnings for use of varadics for non-builtin functions</td>
233 <td>-Wframe-macros</td>
234 <td>Enables warnings about duplicated frame macros</td>
237 <td>-Weffectless-statement</td>
238 <td>Enables warnings about effectiveless statements</td>
241 <td>-Wend-sys-field</td>
242 <td>Enables warnings of end_sys_fields being declared a field</td>
245 <td>-Wassign-function-types</td>
246 <td>Enables warnings for incompatible function pointer signatures used in assignment</td>
249 <td>-Wpreprocessor</td>
250 <td>Enables warnings about redefined macros</td>
253 <td>-Wmultifile-if</td>
254 <td>Enables warnings about multifile if statements</td>
258 Individual warnings may be disabled with -Wno<warning>
259 <pre>$ gmqcc -Wno-frame-macros # disables frame duplication warning</pre>
261 <h3>Miscellaneous options</h3>
265 <td>What it does</td>
268 <td>-force-crc=<num></td>
269 <td>Forces a specific checsum into the header</td>
273 <td>Turns on compiler debug messages</td>
277 <td>Turns on compiler memory leak checker</td>
281 <td>-Whelp or -W?</td>
282 <td>Lists all warning options</td>
286 <td>-fhelp or -f?</td>
287 <td>Lists all code generation options</td>
291 <h1><a name="bdoc">Building Documentation</a></h1>
292 <h2>Building on BSD/NIX</h2>
294 To compile GMQCC on BSD/NIX the following things are
300 <li>Any C90+ C compiler</li>
303 Once obtained you may checkout the development repository
304 with the following shell commands
306 <pre>$ git clone git://github.com/graphitemaster/gmqcc.git
310 The Makefile contains a few rules, depending on what you
311 want to compile, the following rules are:
316 <td>What it does</td>
320 <td>Builds the gmqcc compiler</td>
324 <td>Builds a standable QuakeC VM</td>
328 <td>Builds the testsuite for GMQCC</td>
332 <td>Builds gmqcc, qcvm, and testsuite</td>
336 <td>Installs gmqcc to /usr/local/</td>
340 <td>Runs the testsuite to verify correctness</td>
344 <h2>Building on Windows</h2>
346 To compile GMQCC on windows the following things are
350 <li><a href="http://msysgit.googlecode.com/files/Git-1.8.0-preview20121022.exe">msysGit</a></li>
351 <li><a href="http://www.microsoft.com/visualstudio/eng/downloads">Visual Studio</a></li>
354 Once obtained you may checkout the development repository
355 with the following msysGit commands from a msysGit shell.
356 <pre>$ git clone git://github.com/graphitemaster/gmqcc.git</pre>
357 Included is a VS project file.
360 <h1><a name="tdoc">Testsuite Documentation</a></h1>
361 <h2>Running The Testsuite</h2>
363 To run the testsuite you can either use
364 <pre>$ make check</pre>
365 Or if you're on windows or have already compiled the
366 testsuite from source:
367 <pre>$ ./testsuite </pre>
369 Optionally you may provide the testsuite with additional
375 <td>What it does</td>
378 <td>-redirout=<file></td>
379 <td>Redirect stdout to any file.</td>
382 <td>-redirerr=<file></td>
383 <td>Redirect stderr to any file.</td>
387 <td>Turn on testsuite debug messages.</td>
391 <td>Turn on testsuite memleak checker.</td>
395 <td>Turn off colored stdout/stderr.</td>
399 <h2>Writing Tests</h2>
401 GMQCC comes with a complete testsuite for verifying semantics
402 and syntatics. The testsuite executes files from the test/
403 directory, by reading task template files.
406 templates are rules for a specific test, used to create a "task" that
407 is executed with those set of rules (arguments, and what not). Tests
408 that don't have a template with them cannot become tasks, since without
409 the information for that test there is no way to properly "test" them.
410 Rules for these templates are described in a template file, using a
411 task template language.
414 The languge is composed entierly of "tags" which describe a string of
415 text for a task. Think of it much like a configuration file. Except
416 it's been designed to allow flexibility and future support for prodecual
420 The following "tags" are suported by the language:
425 <td>Description of what the tag does</td>
429 <td>Used to set a description of the current test, this must be
430 provided, this tag is NOT optional.</td>
434 <td>Used to set a failure message, this message will be displayed
435 if the test fails, this tag is optional.</td>
439 <td>Used to set a success message, this message will be displayed
440 if the test succeeds, this tag is optional.
445 <td>Used to set the procedure for the given task, there are two
449 This simply performs compilation only</li>
451 This will perform compilation and execution</li>
454 This tag must be provided, this tag is NOT optional.
459 <td>Used to set the compilation flags for the given task, this
460 must be provided, this tag is NOT optional.</td>
464 <td>Used to set the execution flags for the given task. This tag
465 must be provided if T == -execute, otherwise it's erroneous
466 as compilation only takes place.</td>
470 <td>Used to describe a string of text that should be matched from
471 the output of executing the task. If this doesn't match the
472 task fails. This tag must be provided at least once if
473 T == -execute, otherwise it's erroneous as compilation only
474 takes place. Multiple M tags are required for multi-line comparision
479 <td>Used to specify the INPUT source file to operate on, this must be
480 provided, this tag is NOT optional</td>
485 These tags (with exception to M) have one-time use, using them more
486 than once will result in template compilation errors,
489 Lines beginning with # or // in the template file are comments and
490 are ignored by the template parser.
491 Whitespace is optional, with exception to the colon ':' between the
492 tag and it's assignment value.
494 The template compiler will detect erronrous tags (optional tags
495 that need not be set), as well as missing tags, and error accordingly
496 which will result in that task failing.
499 <h3>Support or Contact</h3>
500 <p>Having trouble with GMQCC? Join our IRC channel at #kf-engine on irc.freenode.net or contact <a href="mailto:cube2killfild@gmail.com">Us</a>
503 <script type="text/javascript" src="http://www.ohloh.net/p/602517/widgets/project_partner_badge.js"></script>
506 <!--[if !IE]><script>fixScale(document);</script><![endif]-->