*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-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.