Chapter 6

cm.ss: Compilation Manager

(make-compilation-manager-load/use-compiled-handler)      PROCEDURE

Returns a procedure suitable as a value for the current-load/use-compiled parameter (see section 7.4.1.6 in PLT MzScheme: Language Manual). The returned procedure automatically compiles source files to a .zo file if

After the handler procedure compiles the .zo file, it creates a corresponding .dep file that lists the current version, plus the timestamp for every file that is required by the module in the compiled file (including require-for-syntaxes).

The handler caches timestamps when it checks .dep files, and the cache is maintained across calls to the same handler. The cache is not consulted to compare the immediate source file to its .zo file, which means that the caching behavior is consistent with the caching of the default module name resolver (see section 5.4 in PLT MzScheme: Language Manual).

(managed-compile-zo file)      PROCEDURE

Compiles the given module source file to a .zo, installing a compilation-manager handler while the file is compiled, and creating a .dep file to record the timestamps of immediate files used to compile the source (i.e., files required in the source, including require-for-syntaxes).

(manager-trace-handler proc [procedure])      

A parameter whose value is a procedure to return a trace string for compilation-manager actions. The procedure receives a single string argument, and its result is ignored.

(trust-existing-zos on? [procedure])      

A parameter that is intended for use by Setup PLT when installing with pre-built .zo files. It causes a compilation-manager load/use-compiled handler to ``touch'' out-of-date .zo files instead of re-compiling from source.