PLT mzc: MzScheme Compiler Manual
A collection is a group of files that conform to MzScheme's
library collection system; see section 16 in PLT MzScheme: Language Manual for details. Every
source file in a collection should contain a single
The --collection-zo and --collection-extension flags direct mzc to compile a whole collection. The --collection-zo flag produces individual .zo files for each library in the collection. The --collection-extension flag produces a single _loader library for the collection.
The (sub-)collection to compile is specified on the command line for mzc. The specified collection must contain an info.ss library that provides information about how to compile the collection. (See section 7 for information on the format of info.ss.)
To compile a collection, mzc extracts info.ss information for the following fields:
When compiling a collection to byte-code files, mzc automatically creates a compiled directory in the collection directory and puts .zo files there.
When compiling a collection to native code, mzc automatically
created a compiled directory in the collection directory, a
native directory in that compiled directory, and a
platform-specific directory in native using the directory name
To compile a collection, mzc compiles only the library files that have changed since the last compilation. This form of dependency checking is usually too weak. For example, when a signature file changes, mzc does not automatically recompile all files that rely on the signatures. In this case, delete the compiled directory when a macro or signature file changes to ensure that the collection is compiled correctly.