include-flags

Arguments: project

Returns a list of keyword symbols indicating certain arguments that will be passed to either generate-application or build-lisp-image when the File | Build Project Exe or File | Build Project Distribution command is used to generate a standalone application for the specified project. The list may contain any combination of the symbols (:top-level :debugger :compiler :local-name-info). The default value is (:top-level :debugger).

The setf of this function may be called to establish the set of flags programmatically, but typically these values are set interactively on the Include tab of the Project Manager dialog instead, which has an individual check-box for each of the possible values, labeled Include the Top Level (for :top-level), Include the Debugger (for :debugger), Include the Compiler (for :compiler), and Save Local Name Info (for :local-name-info).

When :compiler is included in the list and the runtime-build-option property of the project is :dynamic or :partners (rather than :standard, which is the default), then the :discard-compiler argument to generate-application is passed as nil to include the compiler in the standalone application. (The appropriate Allegro license is required for this.) When :compiler is excluded from the list or when the runtime-build-option property of the project is :standard, the :discard-compiler argument is passed as t.

When :local-name-info is included, the :discard-local-name-info argument to generate-application or build-lisp-image will be nil, and otherwise will be t. When :top-level is included, the :include-tpl argument will be t, and otherwise will be nil.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.