start-composer

Arguments: &key host load-init-file init-filename

UNIX only.

This function starts Allegro Composer. You must be running Allegro CL as a subprocess of Emacs (started with the fi:common-lisp emacs command) or startup of Composer will fail. You can also start Allegro Composer with the Start Composer item on the Composer menu on the Emacs menu bar.

The host keyword argument specifies the machine running X windows where Composer windows will be displayed. This argument defaults to the value of the DISPLAY environment variable. It is untypical to have to specify this argument because the Emacs process presumably knows the display (since the Emacs window is typically displayed there) and passes it to Allegro CL. If specified, the value should be a string of the form "[machine]:[display].[screen]" where [machine] is the X host, [display] is an integer (typically 0) specifying the display on that machine, and [screen] is an integer (typically 0) specifying the screen in that display. Specifying a [screen] is optional. Typical values are thus "franz:0" and "franz:0.0".

The load-init-file specifies whether the Composer init file should be loaded (if present -- it is not an error to specify this argument true even if no init file exists). The init filename is the value of the variable *composer-init-filename*, but if the init-filename is non-nil, its value should be a string naming a file (which need not exist) and that file (if there) is loaded as the init file.

See composer.htm for general information on Allegro Composer.

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.