runtime-modules

Arguments: project

Returns a list of keywords indicating which optional modules will be included when a standalone application is generated from the specified project. By eliminating modules for functionality that is not used by an application, it may be possible to somewhat reduce the size of the generated application. Most of the options are Common Graphics features, such as particular widgets, which an application might not use at all. By default, all of the modules are selected for inclusion.

The setf of this function may be called to establish the modules to be included programmatically, but these values are normally specified interactively in the Build Includes widget on the Advanced tab of the Project Manager. (Three of the values in the list widget on this tab correspond to the :compiler, :local-name-info, and :top-level values of the include-flags property, rather than affecting the runtime-modules property.)

At the present time, there is no way to determine which modules an application can safely do without, except by using a module name to guess what functionality it covers and to test generating and running a standalone application without it.

It is also presently unlikely that removing some of these modules will make a substantial difference in image size, except perhaps for a few larger ones such as the grid-widget and outline modules.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page has had significant revisions compared to the 6.1 page.
Created 2002.2.26.