Click above to get retro games delivered to your door ever month!

A pragma is a compiler directive that provides the following capabilities.

 .  Pragmas allow you to specify certain compiler options.
 .  Pragmas can be used to direct the Watcom C/C++ code generator to emit
    specialized sequences of code for calling functions which use argument
    passing and value return techniques that differ from the default used by
    Watcom C/C++.
 .  Pragmas can be used to describe attributes of functions (such as side
    effects) that are not possible at the C/C++ language level.  The code
    generator can use this information to generate more efficient code.
 .  Any sequence of in-line machine language instructions, including DOS and
    BIOS function calls, can be generated in the object code.

Pragmas are specified in the source file using the pragma directive.  The
following notation is used to describe the syntax of pragmas.

keywords
    A keyword is shown in a mono-spaced courier font.

program-item
    A program-item is shown in a roman bold-italics font.  A program-item is
    a symbol name or numeric value supplied by the programmer.

punctuation
    A punctuation character shown in a mono-spaced courier font must be
    entered as is.

    A punctuation character shown in a roman bold-italics font is used to
    describe syntax.  The following syntactical notation is used.

    [abc]
        The item abc is optional.

    {abc}
        The item abc may be repeated zero or more times.

    a|b|c
        One of a, b or c may be specified.

    a ::= b
        The item a is defined in terms of b.

    (a)
        Item a is evaluated first.


The following classes of pragmas are supported.

 .  pragmas that specify options
 .  pragmas that specify default libraries
 .  pragmas that describe the way structures are stored in memory
 .  pragmas that provide auxiliary information used for code generation