User`s manual

228 digi.com Keywords
#precompile
Allows library functions in a comma separated list to be compiled immediately after the BIOS.
The #precompile directive is useful for decreasing the download time when developing your program.
Precompiled functions will be compiled and downloaded with the BIOS, instead of each time you compile
and download your program. The following limitations exist:
• Precompile functions must be defined nodebug.
• Any functions to be precompiled must be in a library, and that library must be included either in the
BIOS using a #use, or recursively included by those libraries.
• Internal BIOS functions will precompile, but will not result in any improvement.
• Libraries that require the user to define parameters before being used can only be precompiled if those
parameters are defined before the #precompile statement. An example of this is included in
precompile.lib.
• Function chains and functions using segment chains cannot be precompiled.
• Precompiled functions will be placed in extended memory, unless specifically marked root.
• All dependencies must be resolved (Macros, variables, other functions, etc.) before a function can be
precompiled. This may require precompiling other functions first.
See precompile.lib for more information and examples.
#undef
Syntax: #undef identifier
Removes (undefines) a defined macro.
#use
Syntax: #use pathname
Activates a library named in LIB.DIR so modules in the library can be linked with the application pro-
gram. This directive immediately reads in all the headers in the library unless they have already been read.