| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
This variable controls whether the console window is automatically shown when an error is signaled in a standalone Common Graphics application that was generated from a project in the IDE, and that error is not trapped by the application.
This variable applies only when
:allow-runtime-debug
was a member of the project's
build-flags, since otherwise the console does not exist at all in the
standalone application. The :allow-runtime-debug
flag is typically set interactively by turning on the Enable
Debugging of Runtime Errors check-box on the Build
tab of the Project Manager dialog.
The default value of *show-console-on-standalone-error*
is t
because it may not be apparent that an
error has occurred in a standalone application if the console window
does not appear, and because the
:allow-runtime-debug
flag is typically used only
while testing an application before final delivery, where debugging in
the console window is appropriate.
There is a special case where it may be desirable to set or bind this
variable to nil
. If an application implements
its own error-handling but also may want to defer to debugging in the
console, then setting this variable to nil
would avoid showing the console during the application's custom error
handling. But the console would still be available (as long as the
:allow-runtime-debug
flag is used), and the
application could show it explicitly if and when desired by calling
cg:show-console.
This variable could be set in the on-initialization function of a project, or in a top-level form in application code that would be evaluated at load time as the standalone application is built.
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.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |