Variable | Package: cg | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version

## *show-console-on-standalone-error*

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-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version