Project Manager Advanced Tab

The Advanced Tab of the Project Manager Dialog displays certain advanced options for the application associated with the project. The options and controls are:

• Deliver a Runtime Bundle: Specifies whether the runtime-bundle argument to generate-application should be specified true (checked) or not (unchecked). When that argument is true, a runtime-suitable bundle file (containing modules permitted in a runtime image but not loaded into the image as built) will be included in the distribution directory. See Including all desired modules in delivery.htm for more information.
• Purify: Specifies whether to move strings and code vectors that would otherwise be in the generated .dxl image file into a separate .pll library file, which is sharable by multiple lisp applications. (Checking this box is equivalent to specifying the purify argument to generate-application true.)
• Autoload warning: If checked, the autoload warning dialog will be displayed when a project build is complete. If unchecked, it will not be displayed. (Not displayed it facilitates batch processing.) See autoload-warning.
• For US Government Use: check this if the application will be supplied to the US Government or someone working for the US Government (and the application is in connection with that person's work). If this box is checked, the copyright notice will include language that protects the rights of software vendors (the application developer and Franz Inc.) when supplying the US Government. That is the only effect of selecting this option. Note that it is not necessary to select this option when supplying a government of any country other than the United States or supplying a state or local government in the United States.
• Old Space: specifies the size of the initial oldspace in the application. The oldspace will grow automatically as needed but specifying a suitable value can improve garbage collection performance. See gc.htm for more information on oldspace size and garbage collection.
• New Space: specifies the size of the initial newspace in the application. The newspace will grow automatically as needed but specifying a suitable value can improve garbage collection performance. See gc.htm for more information on newspace size and garbage collection.
• Command Line Arguments: specifies default command line arguments (such as +c -foo) that will be passed to the generated executable automatically; see default-command-line-arguments.

  As described below, a project will prepend either +cx or +c to these options internally, and so it is generally not necessary to specify a c option explicitly here.

  The initial value for a new project includes the +M flag (to ensure that the standalone application fully exits when it attempts to exit with a non-zero exit code after an error), and also +t  Console for Debugging (as a suggested title for the Console window, in case it were to be included with a delivered application). These flags are recommended for CG applications, though you may wish to add additional flags.

  In addition to the command line arguments specified explicitly in this widget, either the +cx or +c flag will be added internally by the project system. If Enable Debugging of Runtime Errors is selected on the Build tab, then +cx will be added to include the console window in the application; it will be hidden but may be exposed for debugging. If Enable Debugging of Runtime Errors has been unselected (as you would typically do before delivering an application), then +c is passed to exclude the console window entirely from the application; this will also suppress the console's tray icon.

  See Command line arguments and its subsections in startup.htm for a table of standard command-line options.

• Additional Build-Lisp-Image Arguments: specifies the values of any needed arguments to generate-application or build-lisp-image that are not covered by more specific project properties. The values entered here will form the plist that is the value of the additional-build-lisp-image-arguments property of the project. Text should be entered into this widget as this plist would print, except without the surrounding parentheses; for example:

  :read-init-files nil :c-heap-size #x400000
  

In releases prior to 7.0, there was a check box for the Presto Mode option. Since Allegro Presto is no longer supported, this option is no longer available.See The Allegro Presto facility has been removed in loading.htm for further information.

See the general description of the Project Manager Dialog for details of the toolbar buttons.

Copyright (c) 1998-2006, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 7.0. The object described on this page has been modified in the 7.0 release; see the Release Notes.
Created 2005.9.20.