run-with-console

Arguments: project-or-app

Returns whether a console window with an always-active Lisp listener will be present in the standalone application that is generated for a project. This project property has an effect only on the Windows platform, because that is the only platform that uses a console window.

In the IDE, run-with-console is a property of a project, and in a generated application it is a property of the app object. The setf of this function may be called to set the value programmatically, though typically you would set the value interactively by using the Run with Console check-box on the Advanced tab of the Project Manager dialog.

If the value is nil, as it is by default, then a console window may still exist in the standalone application, but it will initially be hidden. It will also have an active read-eval-print loop only if an error occurs or if the user presses the Break key.

If the value is true, then the console window will appear when the standalone application is run (though initially behind the project's main window if it has one), and its read-eval-print-loop will be active at all times. This is implemented by using multiple processes in the standalone app, which would otherwise use only a single process unless the application creates processes itself.

The console window will exist in a standalone application (on the Windows platform only) if either this property is true or if the :allow-runtime-debug option is included in the build-flags property of the project (which is normally set by checking the Enable Debugging of Runtime Errors widget on the Build tab of the Project Manager).

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 8.2 release.
Created 2016.6.21.