full-recompile-for-runtime-conditionalizations

Generic Function

Package: common-graphics

Arguments: configuration

If this property is on, then when the File | Build Project Exe command or the File | Build Project Distribution command is used, the project will be fully recompiled just before creating the executable, with :runtime-system added to *features* during the compilation. This feature is needed only if the project source code contains #-runtime-system or #+runtime-system reader conditionalizations to make the application work somewhat differently in the IDE than it does as a standalone executable. This property is off by default, since it is expected that applications typically will not use such conditionalizations. When the property is on, a second full recompilation is done after building the executable, with :runtime-system no longer in *features*, so that the project ends up once again compiled correctly for running in the IDE. When the property is off, a "regular" compile is still done just before creating the executable file, to ensure that all fasl files are up to date. (A regular compile compiles all source code files that have been saved since they were last compiled.)

In releases prior to 6.0, the full recompile just before creating the executable was always done, whereas the full recompile just afterward was never done. In the typical case, the recompile was unnecessary, and in the atypical case (where the project contains :runtime-system conditionalizations) the project was left compiled for runtime rather than for the IDE.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.