Clozure CL Documentation

3.4. Building Everything

You now have everything you need. Start up Clozure CL with the -n or --no-init option to avoid potential interference from code in your init file, and evaluate the following form to bring your Lisp system up to date.

? (ccl:rebuild-ccl :full t)

That call to the function rebuild-ccl performs the following steps:

Deletes all fasl files and other object files in the ccl directory tree
Runs an external process that does a make in the current platform's kernel build directory to create a new kernel. This step can only work if the C compiler and related tools are installed; see Section 3.3, “Kernel Build Prerequisites”.
Does (compile-ccl t) in the running lisp, to produce a set of fasl files from the “higher level” lisp sources.
Does (xload-level-0 :force) in the running lisp, to compile the lisp sources in the “ccl:level-0;” directory into fasl files and then create a bootstrapping image from those fasl files.
Runs another external process, which causes the newly compiled lisp kernel to load the new bootstrapping image. The bootstrapping image then loads the “higher level” fasl files and a new copy of the platform's full heap image is then saved.

If all goes well, it'll all happen without user intervention and with some simple progress messages. If anything goes wrong during execution of either of the external processes, the process output is displayed as part of a lisp error message.

rebuild-ccl is essentially just a short cut for running all the individual steps involved in rebuilding the system. You can also execute these steps individually, as described below.